Difference between revisions of "VnStat"

From ArchWiki
Jump to: navigation, search
m (See Also)
m (Configuration: order of operations corrected, the service should be started first to create the directory structure)
 
(20 intermediate revisions by 12 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]]
==Installation==
+
[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.
The {{Pkg|vnStat}} package is available in [community]:
+
 
# pacman -S vnstat
+
== Installation ==
==Configuration==
+
 
===Setting the interfaces===
+
[[Install]] the {{Pkg|vnstat}} package.
First introduce every interface that needs to be logged to vnStat. For example a wired interface:
+
 
# vnstat -u -i eth0
+
== Configuration ==
Or a wireless interface:
+
 
# vnstat -u -i wlan0
+
[[systemd#Using units|Start/Enable]] the {{ic|vnstat.service}} daemon.
  
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.
+
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}}.
  
===Updating method===
+
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:
After introducing the interface(s) set one of the update methods.
+
  # vnstat -u -i eth0
{{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
 
====Daemon====
 
The third way of updating is using a daemon provided by vnStat. Add vnstat to your daemons in [[rc.conf#Daemons]].
 
DAEMONS=(... network vnstat ...)
 
  
===Global settings===
+
== Usage ==
Other settings, like settings to control the daemon, can be done in {{ic|/etc/vnstat.conf}}.
 
  
==Usage==
 
 
Query the network traffic:
 
Query the network traffic:
 
  # vnstat -q
 
  # vnstat -q
Line 36: 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