vnStat

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

Zum Verständnis dieses Artikels sind folgende Seiten hilfreich:

  1. Installation von Programmen

  2. Ein Terminal öffnen

  3. Einen Editor öffnen

  4. Root-Rechte

Inhaltsverzeichnis
  1. Installation
  2. Konfiguration
  3. Benutzung
  4. Links

Wiki/Icons/Oxygen/preferences-system-network.png vnStat 🇬🇧 ist ein einfaches Programm, das den Datenverkehr (Volumen) protokolliert und das Ergebnis in einem Terminalfenster anzeigt. Mit der Eingabe verschiedener 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:

Paketliste zum Kopieren:

sudo apt-get install vnstat 

Oder mit apturl die Pakete installieren. Link: apt://vnstat

Konfiguration

Netzwerkschnittstelle ermitteln

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

netstat -i 

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 muss 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 🇬🇧 der aktuellsten Manpage auf der Projektseite finden.

  • vnstati (universe)

Paketliste zum Kopieren:

sudo apt-get install vnstati 

Oder mit apturl die Pakete installieren. Link: apt://vnstati

Intern

Extern