Subsections

1.1 RRDTOOL - Daten erfassen und graphisch anzeigen

1.1.1 Beschreibung

Das Paket RRDTOOL sammelt mit Hilfe des Daemons 'collectd' Systemdaten und speichert diese in rrd-Datenbanken ab. Im Webinterface des fli4l-Routers sind dann die daraus mit Hilfe von rrdtool erzeugten Grafiken abruf- bzw. einsehbar.
Es werden zum Beispiel die folgenden Daten erfasst und dargestellt:

Optional sind in Abhängigkeit der Konfiguration bzw. der installierten Pakete auch noch die Erfassung und Ausgabe von Temperaturen und Spannungen des Mainboards, WLAN-Informationen, die Werte einer APC-USV, PING-Werte von Hosts bzw. VPN-Endpunkten, usw. möglich.

1.1.2 Hinweis zur RRDTOOL-Version

RRD-Datenbank Dateien, die mit der alten Version von RRDTOOL erstellt wurden, können nicht mit der aktuellen Version verwendet werden. Da der hier verwendete Daemon ein anderes Datenformat verwendet, sind die Dateien inkompatibel.

1.1.3 Hinweis zur Verwendung von RRDTOOL auf unterschiedlichen Architekturen

Sofern die Prozessorarchitektur des fli4l gewechselt wird (z.B. von 32 Bit auf 64 Bit) müssen auch die RRDTOOL Datenbank-Dateien angepasst werden. Eine direkte Konvertierung ist nicht möglich.

Stattdessen müssen die alten Datenbanken in XML-Dateien exportiert und von dort aus auf der neuen Architektur wieder importiert werden. Wichtig ist, dass der Export in die XML-Dateien noch auf der alten Architektur stattfindet.

Ein HowTo Artikel zu diesem Thema findet sich unter https://ssl.nettworks.org/wiki/display/f/rrdtool-Datenbanken.

1.1.4 Konfiguration des Paketes RRDTOOL

Die Konfiguration erfolgt, wie bei allen fli4l Paketen, durch Anpassung der
Datei Pfad/fli4l-3.10.3/<config>/rrdtool.txt an die eigenen Anforderungen.

OPT_RRDTOOL

Die Einstellung 'no' deaktiviert das OPT_RRDTOOL vollständig. Es werden keine Änderungen am fli4l Archiv rootfs.img bzw. dem Archiv opt.img vorgenommen. Weiterhin überschreibt das OPT_RRDTOOL grundsätzlich keine anderen Teile der fli4l Installation.
Um OPT_RRDTOOL zu aktivieren, ist die Variable OPT_RRDTOOL auf 'yes' zu setzen.

RRDTOOL_DB_PATH

Standard-Einstellung: RRDTOOL_DB_PATH='/data/rrdtool/db'

Pfad zu den Datenbank-Dateien von RRDTOOL. Diese Dateien sollten immer auf einem persistenten Datenträger liegen. Da im Paket RRDTOOL entsprechende Caching-Mechanismen zum Einsatz kommen, wird die Anzahl der Zugriffe auf den Datenträger minimiert, wodurch es kein Problem darstellt, die Daten auf einer CompactFlash-Karte abzulegen. Weiterhin ist zu beachten, das beim Einsatz des OPT_QOS das Dateisystem des Paths z.B. ext2/ext3/ext4 ist, da nur diese Dateisystem die Zeichen in Dateinamen unterstützen die benötigt werden.

RRDTOOL_CACHETIME

Mit diesem optionalen Konfigurationsparameter kann festgelegt werden, nach wievielen Sekunden der rrdcached-Daemon die gecached Werte in die RRD-Datenbank- Dateien schreibt. Durch kleiner Werte wird die Cache-Datei in der Ramdisk kleiner was sich bei Routern mit eher kleinem RAM empfiehlt, jedoch erfolgt dann häufiger ein Zugriff auf den Datenträger. Ohne Aktivierung der Variable erfolgt dies nach 3600 Sekunden oder beim Herunterfahren des fli4l.

Folgende möglichen Werte können konfiguriert werden:

RRDTOOL_NET

Die Einstellung 'yes' aktiviert das network-plugin des collectd. Dadurch ist es dann möglich, die durch den collectd erfassten/gesammelten Daten an einen anderen Rechner auf dem der collectd mit aktivem network-plugin im Server-Mode läuft zu übertragen.

RRDTOOL_NET_HOST

FQDN oder IP-Adresse des Rechners, auf dem der collectd mit network-plugin im Server-Mode läuft.

RRDTOOL_NET_PORT

In dieser optionalen Variablen kann der Port, auf dem der Server auf eingehende Verbindungen wartet konfiguriert werden.

RRDTOOL_UNIXSOCK

Die Einstellung 'yes' aktiviert das unixsock-Plugin des collectd. Über diesen Socket können weitere Dienste/Prozesse die Daten erfassen und an den collectd übergeben.

RRDTOOL_PING_N

Legt die Anzahl der Hosts fest, bei dennen via Ping die Netzwerklaufzeiten ermittelt werden.

RRDTOOL_PING_x

Definiert den Host von dem die Netzwerklaufzeit erfasst werden soll. Die Angabe kann als FQDN oder mit der IP-Adresse erfolgen.

RRDTOOL_PING_x_LABEL

Legt optional eine anderere Beschreibung für das Ping-Ziel fest.

RRDTOOL_PING_x_GRPNR

Ordnet dieses Ping-Ziel der in RRDTOOL_PINGGROUP_x_LABEL definierten Gruppe über die Nummer des Indexes zu.

RRDTOOL_PINGGROUP_N

Anzahl der Gruppen in die die Ping-Ziele guppiert werden können. Jede definierte Gruppe wird im Webinterface in einem extra Reiter dargestellt.

RRDTOOL_PINGGROUP_x_LABEL

Name der Gruppe der Pingziele.

RRDTOOL_APCUPS

Aktiviert bzw. deaktiviert die Erfassung von Daten einer APC-USV. Zur Datenerfassung muss auf einem über Netzwerk erreichbaren Rechner der apcupsd-Daemon aktiv sein.

RRDTOOL_APCUPS_HOST

Host auf dem der apcupsd-Daemon ausgeführt wird.

RRDTOOL_APCUPS_PORT

Netzwerkport unter dem der apcupsd-Daemon erreichbar ist. Im Normalfall ist dies der Port 3351.

RRDTOOL_PEERPING_N

Legt die Anzahl der Peer-Ping-Ziele fest. Ein Peer-Ping-Ziel ist z.B. das Ziel eines VPN-Tunnels.

RRDTOOL_PEERPING_x

Definiert das Peer-Ping-Ziel.
Mögliche Ziele sind z.B. tun0, tun1, pppoe, usw. Es können auch die zugehörigen Alias- bzw. Circuit-Namen verwendet werden.

RRDTOOL_PEERPING_x_LABEL

Legt optional eine anderere Beschreibung für das Peer-Ping-Ziel fest.

RRDTOOL_OWFS

Aktiviert bzw. Deaktiviert die Erfassung sowie graphische Ausgabe der Daten, welche durch das Paket OW bereitgestellt werden.

RRDTOOL_OWFS_HOST

Host auf dem der OWFS-Dienst läuft. Im Normalfall ist dies der Router selbst. Somit ist der Wert '127.0.0.1' einzutragen.

RRDTOOL_OWFS_PORT

Netzwerkport auf dem der OWFS-Dienst erreichbar ist. Im Normalfall ist dies der Port 4304.

© 2001-2015 Das fli4l-Team - July 26, 2015