RRDstats
Einleitung
RRD steht für Round Robin Database und wurde für Linux und Windows unter der GNU-Lizenz von Tobias Oetiker entwickelt. Es ist ein sehr leistungsfähiges Werkzeug, um zeitbezogene Messdaten wie Temperatur, Festplattenauslastung, Netzwerkverkehr auf kompakte Art und Weise in einer Datenbank zu speichern und ansprechend zu visualisieren. Weitere Details sind hier im Wiki beim Paket RRDtool nachzulesen. Um die Daten nachher graphisch darzustellen, wird rrdstats verwendet, worum es hier im Detail geht. Das Package DigiTemp wird zum Aufzeichen von Temperaturwerten benötigt.
Voraussetzungen und Einbau von RRDstats beim Firmware-Bau
Im menuconfig:
- Package selection / Web interface / RRDstats for RRDtool [selektiert automatisch auch RRDtool 1.2.30 unter "Package selection / Testing"]
- nur für DigiTemp: Package selection / Testing / digitemp 3.0.6 / digitemp for ds9097 [mit den beiden anderen Optionen ging es (bei ao) nicht] Ich (cuma) nutze "ds2490" mit dem "DS9490R". Hierbei sind keine zusätzlichen Module nötig.
- nur für DigiTemp: Advanced options / Kernel modules / drivers / pl2303.ko [habe für einen anderen Adapter zusätzlich auch noch ftdi_sio.ko ausgewählt]
- nur für Kabelmodem: Optional das Package "wget" installieren. Dadurch werden Ausfälle bei Nichterreichbarkeit des Kabelmodem vermieden, es ist aber ca 350 kB gross.
Auf der Box:
- nur für DigiTemp: im Freetz-WebGUI unter "Einstellungen / Freetz:modules das bzw. die Kernel-Modul(e) untereinander eintragen (aber ohne "modprobe" o.ä.!)
pl2303 ftdi_sio
- im Freetz-Webif unter "RRDstats" weitere Einstellungen vornehmen
Backup
Sinnvoll ist die Anpassung der Pfade, falls man regelmäßige Backups der Messdaten machen möchte, z.B.:
Backup Verzeichnis: /var/media/ftp/uStor01/rrdstats/backup
… und im Freetz-WebGUI bei den RRDstats-Einstellungen das automatisch Wiederherstellen von Backups beim Starten aktivieren
Wenn man die Backups nun regelmäßig mittels eines cronjobs durchführt, z.B. alle 20-30 Minuten, sind die Lücken in den Graphen bei entsprechend kurzen Box-Ausfallzeiten auch nicht zu groß. Im Freetz-WebGUI gibt man dazu unter "Einstellungen / Freetz: crontab" z.B. folgendes ein:
00 * * * * /etc/init.d/rc.rrdstats backup 20 * * * * /etc/init.d/rc.rrdstats backup 40 * * * * /etc/init.d/rc.rrdstats backup
Näheres zu crontab bitte im Internet nachlesen.
Einstellungen WebGUI
"Not lazy" bedeutet, dass die Graphen immer neu generiert werden, hingegen bedeutet "lazy", dass sie nur neu generiert werden, wenn sie veraltet sind. Die Einstellung "lazy" (bzw. das Abschalten von "not lazy") verringert die CPU-Last.
Vefügbare Netzwerkintrafaces auf der Box kann man so ermitteln: ifconfig |grep -v "^ "
Das Unterdrücken der 85°C Fehlerwerte wirkt sich nur auf die .rrd Dateien aus, nicht auf die .cvs.
Die anderen Einstellungen dürften selbsterklärend sein. Falls nicht, bitte im Forum nachfragen und bei neuen Erkenntnissen hier ergänzen.
DigiTemp
Die Initialisierung ist nur 1x pro Messfühler nötig.
Danach muss der Dienst "RRDstats" manuell wieder im Freetz-Webif unter "Dienste" gestartet werden
Kabelmodem
Loggen der Kanäle
Sollen mehr Kanäle geloggt werden als beim Erstellen der Datenbank eingestellt waren, ist es an einfachsten die epc_*.rrd zu löschen.
Bereits aufgezeichneten Daten weiterzuverwenden ist aufwändiger, da rrdtool keine Möglichkeit bietet nachträglich einen DS hinzuzufügen. Dazu:
- Datensicherung!
- Die Daten exportieren: rrdtool dump epc_60.rrd dump.xml
- DS Spalten hinzufügen. Hier am Beispiel 1 Upstreamkanal auf 2 erweitern:
1) Am Anfang der dump.xml vor den Zeilen<ds> <name> up </name>
dies hinzufügen<name> txfq2 </name> <type> GAUGE </type> <minimal_heartbeat> 600 </minimal_heartbeat> <min> 9.0000000000e+00 </min> <max> 9.9000000000e+01 </max> <!-- PDP Status --> <last_ds> UNKN </last_ds> <value> NaN </value> <unknown_sec> 25 </unknown_sec> </ds> <ds> <name> txdb2 </name> <type> GAUGE </type> <minimal_heartbeat> 600 </minimal_heartbeat> <min> 0.0000000000e+00 </min> <max> 9.9000000000e+01 </max> <!-- PDP Status --> <last_ds> UNKN </last_ds> <value> NaN </value> <unknown_sec> 25 </unknown_sec> </ds>
2) 12 Zeilen vor allen </cdp_prep> Zeilen dies hinzufügen<ds> <primary_value> 0.0000000000e+00 </primary_value> <secondary_value> 0.0000000000e+00 </secondary_value> <value> NaN </value> <unknown_datapoints> 0 </unknown_datapoints> </ds> <ds> <primary_value> 0.0000000000e+00 </primary_value> <secondary_value> 0.0000000000e+00 </secondary_value> <value> NaN </value> <unknown_datapoints> 0 </unknown_datapoints> </ds>
3) Nun noch alle Zeilen die mit </row> enden zwischen das drittletzte und vorletzte <v> ... </v> dies einfügen: <v> NaN </v> <v> NaN </v>.
- Geänderte Datenbank erstellen: rrdtool restore dump.xml epc_60.rrd -f
Viel Spass und Erfolg beim nachmachen 
Kabelsegment
Datenbanken
Bis zu r11010 konnte mit einem Intervall von 60 Sekunden 146 Tage aufgezeichnet werden, mit 150 Sekunden 1 Jahr. Ab dieser Revision werden die Datenbanken von DigiTemp und RRDstats-Kabelsegment mit 2 Jahren bei 60 Sekunden *erstellt*. Damit wachsen die einzelnen Dateien von ~85kB auf ~150kB. Existierende rrd-Datenbanken kann man so neue RRAs hinzufügen: DigiTemp#Datenbank
Dateiübersicht (unvollständig)
Folgende Dateien/Pfade sind an der Erstellung der Graphischen Auswertung beteiligt:
- /usr/lib/cgi-bin/rrdstats/stats.cgi: Diverses Feintuning kann man in der Datei vornehmen. Erstellt die png Graphen, aus den rrd Dateien. Es lassen sich z.B. slopes u.ä. hinzufügen. Ein paar Hinweise dazu gibt es in diesem IPPF-Thread. Zum manuellen generieren der Graphen (z.B. durch cron) kann der neue Parameter "graph" von rc.rrdstats genutzt werden
- /usr/bin/rrdstats: Dieses Shellskript dient dem einsammeln der anzuzeigenden Werte, erstellt csv Dateien und pflegt die neuen Werte in die Round Robin Database über RRDtool ein.
BUGS
Manchmal kann es vorkommen, dass die Zähler / Graphiken für CPU, Memory etc. nicht mehr verfügbar sind. Im Persistenten Verzeichnis (Dienste - RRDStats) sind dann leere Dateien für den jeweiligen counter zu finden. Abhilfe schafft ein stoppen des Dienstes, löschen der leeren Dateien und erneutes starten des Dienstes. Dabei werden die fehlenden Dateien erneut korrekt angelegt und der Fehler ist weg. Verursacht wahrscheinlich durch eine fehlerhaftes Datum auf der Fritzbox (Jahr 2017-Problem).
Die Dateien können auf ihre Konsistenz mit rrdtool dump dateiname.rrd überprüft werden.
Links
Entstanden aus diesem Thread im IPPF: http://www.ip-phone-forum.de/showthread.php?t=183491