Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision Next revisionBoth sides next revision | ||
| docs:guide-user:services:network_monitoring:darkstat [2018/11/18 13:39] – created jmlacroix | docs:guide-user:services:network_monitoring:darkstat [2018/11/28 23:53] – [Configuration] jmlacroix | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Darkstat ====== | ====== Darkstat ====== | ||
| [[https:// | [[https:// | ||
| - | |||
| - | {{page> | ||
| Darkstat is an application that captures network traffic, calculates statistics about usage, and serves reports over HTTP. | Darkstat is an application that captures network traffic, calculates statistics about usage, and serves reports over HTTP. | ||
| - | One advantage of darkstat is that it can report | + | One advantage of darkstat is that it can monitor |
| It is a very stable application that runs smoothly and requires no maintenance. | It is a very stable application that runs smoothly and requires no maintenance. | ||
| ===== Installation ===== | ===== Installation ===== | ||
| + | Installation is very simple: | ||
| + | <code bash> | ||
| + | opkg install darkstat | ||
| + | / | ||
| + | / | ||
| + | </ | ||
| + | You can also install it through luci. | ||
| + | |||
| + | Then is you open a web browser at the address of the router on port 667, you will see the traffic graphs. | ||
| ===== Configuration ===== | ===== Configuration ===== | ||
| + | In OpenWrt, **darkstat** can use almost all of the regular darkstat parameters. | ||
| + | // | ||
| + | <code bash> | ||
| + | config darkstat | ||
| + | option interface | ||
| + | option syslog | ||
| + | option verbose | ||
| + | option no_promisc | ||
| + | option no_dns | ||
| + | option no_macs | ||
| + | option no_lastseen | ||
| + | option httpaddr | ||
| + | # option httpport | ||
| + | # option network_filter | ||
| + | # option network_netmask | ||
| + | option local_only | ||
| + | # option hosts_max | ||
| + | # option hosts_keep | ||
| + | # option ports_max | ||
| + | # option ports_keep | ||
| + | # option highest_port | ||
| + | # option export_file | ||
| + | # option import_file | ||
| + | # option daylog_file ' | ||
| + | </ | ||
| + | |||
| + | **Note** In OpenWrt/ | ||
| + | |||
| + | **Note**: the init script and the config file found in trunk are compatible with the darkstat found in OpenWrt/ | ||
| - | ===== Other monitoring applications | + | ^ Option ^ Explanation ^ Default ^ |
| + | |interface|Capture traffic on the specified network interface. | ||
| + | |syslog|Errors, | ||
| + | |verbose|Produce more verbose debugging messages.|false| | ||
| + | |no_promisc|Do | ||
| + | |no_dns|Do not resolve IPs to host names. | ||
| + | |no_macs|Do not display MAC addresses in the hosts table.|false| | ||
| + | |httpaddr|Bind the web interface to the specified address. | ||
| + | |httpport|Bind the web interface to the specified port. The default is 667.|Commented out| | ||
| + | |network_filter|Use the specified filter expression when capturing traffic. | ||
| + | |network_netmask|Define | ||
| + | |local_only|Make | ||
| + | |hosts_max|The maximum number of hosts that will be kept in the hosts table. | ||
| + | |hosts_keep|When the hosts table hits __hosts-max__ and traffic is seen from a new host, we clean out the hosts table, keeping only the top __hosts-keep__ number of hosts, sorted by total traffic.|Commented out| | ||
| + | |ports_max|The | ||
| + | |ports_keep|When a ports table fills up, this many ports are kept and the rest are discarded.|Commented out| | ||
| + | |highest_port|Ports that are numerically higher than this will not appear in the per-host ports tables, although their traffic will still be accounted for. This can be used to hide ephemeral ports. | ||
| + | |export_file|On shutdown, or upon receiving SIGUSR1 or SIGUSR2, export the in-memory | ||
| + | |import_file|Upon starting, import a darkstat database from the named file in the /tmp/empty directory.|Commented out| | ||
| + | |daylog_file|Log | ||
| + | ===== Other Bandwidth Monitoring Applications | ||
| Darkstat shows the traffic in real time the traffic for different hosts within your network, but it does not show the traffic profile of the various host over time. | Darkstat shows the traffic in real time the traffic for different hosts within your network, but it does not show the traffic profile of the various host over time. | ||
| - | Another application, | + | Another application, |
| - | The various application for monitoring bandwidth in OpenWrt can be found in the documentation page about this item. | + | The various application for monitoring bandwidth in OpenWrt can be found in the documentation page about [[docs: |