Difference between revisions of "VnStat"

From ArchWiki
Jump to: navigation, search
(Deprecated initscripts: Remove initscript info. Not supported by Arch anymore.)
m (Configuration: order of operations corrected, the service should be started first to create the directory structure)
 
(18 intermediate revisions by 11 users not shown)
Line 1: Line 1:
 +
{{lowercase title}}
 
[[Category:Networking]]
 
[[Category:Networking]]
{{lowercase title}}
+
[[ja:VnStat]]
[http://humdi.net/vnstat/ vnStat] is a lightweight network traffic monitor. It keeps a network traffic log on selectable interfaces. Through the command line the network traffic statistics can be shown.
+
[[ru:VnStat]]
 +
[http://humdi.net/vnstat/ vnStat] is a lightweight (command line) network traffic monitor. It monitors selectable interfaces and stores network traffic logs in a database for later analysis.
  
 
== Installation ==
 
== Installation ==
  
[[pacman|Install]] {{Pkg|vnStat}} from the [[official repositories]].
+
[[Install]] the {{Pkg|vnstat}} package.
  
 
== Configuration ==
 
== Configuration ==
  
=== Setting the interfaces ===
+
[[systemd#Using units|Start/Enable]] the {{ic|vnstat.service}} daemon.
 +
 
 +
Pick a preferred network interface and edit the {{ic|Interface}} variable in the {{ic|/etc/vnstat.conf}} accordingly. To list all interfaces available to vnstat, use {{ic|vnstat --iflist}}.
  
First introduce every interface that needs to be logged to vnStat. For example a wired interface:
+
To start monitoring a particular interface you must initialize a database first. Each interface needs its own database. The command to initialize one for the {{ic|eth0}} interface is:
 
  # vnstat -u -i eth0
 
  # vnstat -u -i eth0
Or a wireless interface:
 
# vnstat -u -i wlan0
 
 
When introducing an interface for the first time there will be an error message saying 'unable to read database'. If this message is followed by an info message saying 'a new database has been created' the interface is successfully introduced. If this is not the case check that the specified interface is valid.
 
 
=== Updating method ===
 
 
After introducing the interface(s) set one of the update methods.
 
{{Warning| Only use one of the methods, do not use them at the same time!}}
 
 
==== Cron ====
 
 
The first method is using [[Cron]]. A sample of Cron usage is provided with vnStat at {{ic|/usr/share/doc/vnstat/examples/vnstat.cron}}.
 
 
==== Service ====
 
 
The second way is using [[systemd]] (and the provided service):
 
# systemctl start vnstat.service
 
 
=== Global settings ===
 
 
Other settings, like settings to control the daemon, can be done in {{ic|/etc/vnstat.conf}}.
 
  
 
== Usage ==
 
== Usage ==
Line 44: Line 26:
 
  # vnstat -l
 
  # vnstat -l
  
For all the other options, use:
+
To find more options, use:
 
  # vnstat --help
 
  # vnstat --help
Or for a complete list, use:
 
# vnstat --longhelp
 
 
== See Also ==
 
[http://gotux.net/arch-linux/vnstat-network-monitor/ VnStat Custom WebUI]
 

Latest revision as of 07:52, 30 September 2017

vnStat is a lightweight (command line) network traffic monitor. It monitors selectable interfaces and stores network traffic logs in a database for later analysis.

Installation

Install the vnstat package.

Configuration

Start/Enable the vnstat.service daemon.

Pick a preferred network interface and edit the Interface variable in the /etc/vnstat.conf accordingly. To list all interfaces available to vnstat, use vnstat --iflist.

To start monitoring a particular interface you must initialize a database first. Each interface needs its own database. The command to initialize one for the eth0 interface is:

# vnstat -u -i eth0

Usage

Query the network traffic:

# vnstat -q

Viewing live network traffic usage:

# vnstat -l

To find more options, use:

# vnstat --help