Difference between revisions of "VnStat"

From ArchWiki
Jump to navigation Jump to search
(improve install link as recommended in Help:Style#Package management instructions)
m (→‎Usage: Changing command options to long options)
 
(8 intermediate revisions by 5 users not shown)
Line 7: Line 7:
 
== Installation ==
 
== Installation ==
  
[[Install]] {{Pkg|vnstat}} from the [[official repositories]].
+
[[Install]] the {{Pkg|vnstat}} package.
  
 
== Configuration ==
 
== Configuration ==
  
First open {{ic|/etc/vnstat.conf}} with your editor and check the interface name is set right, eg.:
+
[[systemd#Using units|Start/Enable]] the {{ic|vnstat.service}} daemon.
# Interface "enp3s0"
 
  
=== Start Systemd Service ===
+
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}}.
  
After introducing the interface(s) and checking the config file. You can start the monitoring process via [[systemd]]
+
To start monitoring a particular interface that was not referred to in the configuration file when the daemon was started, you must initialize a database first. Each interface needs its own database. The command to initialize one for the {{ic|eth0}} interface is:
  # systemctl start vnstat.service
+
  # vnstat --add -i eth0
To make this service permanent use
+
 
# systemctl enable vnstat.service
+
Remember to [[restart]] the {{ic|vnstat.service}} daemon after you have added a new interface.
  
 
== Usage ==
 
== Usage ==
  
 
Query the network traffic:
 
Query the network traffic:
  # vnstat -q
+
  # vnstat --query
  
 
Viewing live network traffic usage:
 
Viewing live network traffic usage:
  # vnstat -l
+
  # vnstat --live
  
 
To find more options, use:
 
To find more options, use:
 
  # vnstat --help
 
  # vnstat --help
 +
or to see all options use:
 +
# vnstat --longhelp

Latest revision as of 19:24, 8 March 2019

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 that was not referred to in the configuration file when the daemon was started, you must initialize a database first. Each interface needs its own database. The command to initialize one for the eth0 interface is:

# vnstat --add -i eth0

Remember to restart the vnstat.service daemon after you have added a new interface.

Usage

Query the network traffic:

# vnstat --query

Viewing live network traffic usage:

# vnstat --live

To find more options, use:

# vnstat --help

or to see all options use:

# vnstat --longhelp