vnStat

Dieser Artikel wurde für die folgenden Ubuntu-Versionen getestet:

Ubuntu 14.04 Trusty Tahr
Ubuntu 12.04 Precise Pangolin

Zum Verständnis dieses Artikels sind folgende Seiten hilfreich:

Inhaltsverzeichnis

Installation
Konfiguration
Benutzung
Links

Wiki/Icons/Oxygen/preferences-system-network.png vnStat {en} ist ein einfaches Programm, das den Datenverkehr (Volumen) protokolliert und das Ergebnis in einem Terminalfenster anzeigt. Mit der Eingabe verschiedenen Parameter kann man sich Tages-, Wochen-, Monats- oder Jahresstatistiken anzeigen lassen.

Installation¶

Um das Programm zu benutzen, das nicht in der Standardinstallation enthalten ist, installiert ^[1] man:

vnstat (universe)

Wiki/Vorlagen/Installbutton/button.png mit apturl

Paketliste zum Kopieren:

sudo apt-get install vnstat

sudo aptitude install vnstat

Konfiguration¶

Netzwerkschnittstelle ermitteln¶

Die zur Verfügung stehenden Netzwerkschnittstellen erfährt man durch Eingabe ^[2] von:

vnstat --iflist

Als nächstes muss man ermitteln, welche Netzwerkschnittstelle im laufenden System genutzt wird ^[2]:

route -n

Die Ausgabe könnte so aussehen:

Ziel            Router          Genmask         Flags Metric Ref    Use Iface
192.168.0.0     0.0.0.0         255.255.255.0   U     1      0        0 wlan1
169.254.0.0     0.0.0.0         255.255.0.0     U     1000   0        0 wlan1
0.0.0.0         192.168.0.1     0.0.0.0         UG    0      0        0 wlan1

Ganz rechts sieht man die Spalte Iface. In diesem Beispiel lautet der Name der Netzwerkschnittstelle wlan1.

Netzwerkschnittstelle festlegen¶

Um die zu überwachende Netzwerkschnittstelle festzulegen, bearbeitet man die Konfigurationsdatei /etc/vnstat.conf mit einem Editor ^[4]. Dabei wird nach der Zeile default interface die gewünschte Schnittstelle eingetragen. Dieser Vorgang ist ab Ubuntu 11.10 nicht mehr nötig, da es eine neuere Version von vnStat enthält und die Konfigurationsdatei mit den erkannten Netzwerkschnittstellen automatisch erzeugt wird (s.a. 410968, 08/2009).

Beispiel:

# default interface
Interface "eth0"

Im Fall von wlan1:

# default interface
Interface "wlan1"

vnStat mit GSM-USB-Stick¶

Die meisten GSM-USB-Sticks sind über pppoe angebunden, wenn der Stick angeschlossen und aktiv ist, dann sieht man mit dem Befehl

vnstat --iflist

auch eine Schnittstelle ppp0. Dies ist der GSM-USB-Stick, nach Initialisierung (siehe nächstes Kapitel) kann der Zugriff erfolgen. Dies ist sehr nützlich, wenn man für die Karte im GSM-USB-Stick keine Flatrate, sondern nur einen Volumentarif hat (z.B. im Ausland).

Datenbank initialisieren¶

Zum Schluss muss noch eine Datenbank für die Protokolldaten erstellt werden. Das erfolgt mit dem Befehl ^[4]:

sudo vnstat -u -i INTERFACE

Dabei ersetzt man INTERFACE mit der zuvor ermittelten Netzwerkschnittstelle, wie z.B.:

sudo vnstat -u -i wlan1

Error: Unable to read database "/var/lib/vnstat/wlan1".
Info: -> A new database has been created.

Man kann auch mehrere Netzwerkschnittstellen gleichzeitig protokollieren. Dazu ist für jede ein eigener Befehl in der obigen Form notwendig.

Abschließend müssen noch die Rechte für die dadurch erzeugten Datenbanken gesetzt werden, sodass der Dienst diese nutzen kann:

sudo chown -R vnstat:vnstat /var/lib/vnstat/

Benutzung¶

Zuerst mit vnStat als Dienst gestartet werden^[2]^[4]:

sudo service vnstat start

Ab diesem Zeitpunkt protokolliert vnStat alles mit, was über die angegebene Netzwerkschnittstelle übertragen wird. Das Ergebnis lässt sich dann z.B. mittels

vnstat --months

ausgeben:

 ppp0  /  monthly

   month         rx      |      tx      |   total
-------------------------+--------------+--------------------------------------
  Oct '07     102.44 GB  |    43.18 GB  |   145.61 GB   %%%%%%%%::::
  Nov '07     110.68 GB  |    50.23 GB  |   160.91 GB   %%%%%%%%%::::
  Dec '07     103.97 GB  |    37.79 GB  |   141.76 GB   %%%%%%%%%:::
  [...]
  Jul '08     188.90 GB  |    44.74 GB  |   233.64 GB   %%%%%%%%%%%%%%%%::::
  Aug '08     197.78 GB  |    51.72 GB  |   249.50 GB   %%%%%%%%%%%%%%%%%::::
  Sep '08     128.04 GB  |    41.94 GB  |   169.97 GB   %%%%%%%%%%%:::
-------------------------+--------------+--------------------------------------
 estimated    151.12 GB  |    49.50 GB  |   200.62 GB

RX und TX stehen für receive/transmit = empfangen/senden

Optionen¶

Optionen von vnStat
Option	Option (Langform)	Bedeutung
`-?`	`--help`	Damit ruft man die Hilfsfunktion auf
`-q`	`--query`	Datenbank abfragen
`-h`	`--hours`	Abfrage nach Stunden-Intervall
`-d`	`--days`	Abfrage nach Tagen-Intervall
`-m`	`--months`	Abfrage nach Monaten-Intervall
`-w`	`--weeks`	Abfrage nach Wochen-Intervall
`-t`	`--top10`	Die Top10 anzeigen
`-s`	`--short`	use short output/ Kurzausgabe benutzen
`-u`	`--update`	Datenbank aktualisieren
`-i`	`--iface`	Interface auswählen
`-v`	`--version`	Version von vnStat anzeigen
`-tr`	`--traffic`	Den Traffic (Datenverkehr) berechnen
`-ru`	`--rateunit`	swap configured rate unit / Wechsel der konfigurierten Berichts-Einheit (Byte/Bit)
`-l`	`--live`	Übertragungsrate in Echtzeit anzeigen
	`--longhelp`	Zeigt alle Funktionen bzw. Optionen/Parameter an

Grafische Aufbereitung der Daten¶

Optional kann man sich auch zusätzlich das Paket vnstati installieren. Dadurch wird es möglich, einfache Bilder der gespeicherten Traffic-Daten im PNG-Format zu erzeugen. Eine Übersicht zu den möglichen Optionen sowie Beispiele der Befehle lassen sich z.B. in der Online-Version {en} der aktuellsten Manpage auf der Projektseite finden.