Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
docs:guide-user:services:network_monitoring:darkstat [2018/11/18 21:30] – [Installation] jmlacroixdocs:guide-user:services:network_monitoring:darkstat [2018/11/28 23:53] – [Configuration] jmlacroix
Line 1: Line 1:
 ====== Darkstat ====== ====== Darkstat ======
 [[https://unix4lyfe.org/darkstat/]] [[https://unix4lyfe.org/darkstat/]]
- 
-{{page>meta:infobox:construction&noheader&nofooter&noeditbtn}} 
  
 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.
Line 10: Line 8:
  
 ===== Installation ===== ===== Installation =====
-Insallation is very simple:+Installation is very simple:
 <code bash> <code bash>
 opkg install darkstat opkg install darkstat
Line 16: Line 14:
 /etc/init.d/darkstat start /etc/init.d/darkstat start
 </code> </code>
 +
 +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. 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.  There are set in the file ///etc/config/darkstat+In OpenWrt, **darkstat** can use almost all of the regular darkstat parameters.  These are set in the file ///etc/config/darkstat
 // //
 <code bash> <code bash>
Line 43: Line 44:
 # option daylog_file 'darkstat_daylog.log' # option daylog_file 'darkstat_daylog.log'
 </code> </code>
 +
 +**Note** In OpenWrt/LEDE 17.01 and below, the last 3 parameters are not available.  The config file above is the one currently 18.06 and above (you may need to update the package in 18.06 to have them).  Also, in OpenWrt/LEDE 17.01 and below, the init script in /etc/init.d is not a procd script as in 18.06 and above.
 +
 +**Note**: the init script and the config file found in trunk are compatible with the darkstat found in OpenWrt/LEDE 17.01 and below and provides the last 3 parameters.
  
 ^ Option ^ Explanation ^ Default ^ ^ Option ^ Explanation ^ Default ^
Line 48: Line 53:
 |syslog|Errors, warnings, and verbose messages will go to syslog (facility daemon, priority debug) instead of stderr.|false| |syslog|Errors, warnings, and verbose messages will go to syslog (facility daemon, priority debug) instead of stderr.|false|
 |verbose|Produce more verbose debugging messages.|false| |verbose|Produce more verbose debugging messages.|false|
-|no_promisc|Do  not  use  promiscuous  mode  to capture.|__false__|+|no_promisc|Do  not  use  promiscuous  mode  to capture.|false|
 |no_dns|Do not resolve IPs to host names.  This can significantly reduce memory footprint on small systems as an extra process is created for DNS resolution.|false| |no_dns|Do not resolve IPs to host names.  This can significantly reduce memory footprint on small systems as an extra process is created for DNS resolution.|false|
 |no_macs|Do not display MAC addresses in the hosts table.|false| |no_macs|Do not display MAC addresses in the hosts table.|false|
Line 64: Line 69:
 |import_file|Upon starting, import a darkstat database from the named file in the /tmp/empty directory.|Commented out| |import_file|Upon starting, import a darkstat database from the named file in the /tmp/empty directory.|Commented out|
 |daylog_file|Log  daily  traffic statistics into the named file in the /tmp/empty directory. The daylog format is: localtime time_t bytes_in bytes_out pkts_in pkts_outs. Lines starting with a # are comments stating when logging started and stopped. |Commented out| |daylog_file|Log  daily  traffic statistics into the named file in the /tmp/empty directory. The daylog format is: localtime time_t bytes_in bytes_out pkts_in pkts_outs. Lines starting with a # are comments stating when logging started and stopped. |Commented out|
-===== Other monitoring applications =====+===== 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, Bandwidthd allows to see the traffic profile of the various host over time.  It also indicate the level of traffic for various type, such as TCP, UDP, ICMP, HTTP, SMTP, FTP.  But it cannot show the IPv6 traffic.+Another application, [[docs:guide-user:services:network_monitoring:bandwidthd|Bandwidthd]] allows to see the traffic profile of the various host over time.  It also indicate the level of traffic for various type, such as TCP, UDP, ICMP, HTTP, SMTP, FTP.  But it cannot show the IPv6 traffic.
  
-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:guide-user:services:network_monitoring:start|Network Monitoring]].
  • Last modified: 2020/06/07 20:50
  • by jmlacroix