Das Weathermap-Plugin für Cacti

Überblick
Offizielle Dokumentation und Download
Erste Schritte
Konfiguration
Betrieb
Ergänzende Hinweise
Zusammenfassung

Inoffizielles Handbuch für Cacti

Überblick
Das Weathermap-Plugin erlaubt die grafische Darstellung von Netzknoten, deren Verbindung untereinander und die Netzlast grafisch darzustellen. Dabei wird man in keinerlei Struktur gezwungen und hat nahezu völlige Gestaltungsfreiheit.

Mit den Standard-snmp-Interface-Statitisks von Cacti kann man nur pro IP den Traffic darstellen bzw. ablesen, das heist auf einem Switch pro Port, auf einem Host pro IP. Es geht also nicht den Traffic zwischen Hosts zu visualisieren, sondern immer nur zwischen den nächsten physischen Netzwerkelementen (Router, Switch). Wenn man dies pro Host haben möchte, muss man selbst etwas basteln um die Traffic-Daten entsprechend zu splitten. Dies wird von manchen Geräten unterstützt. Stichworte sind sflow, ipfix oder netflow.

Offizielle Dokumentation und Download
Installation des Weathermap-Plugins
Homepage Weathermap
Dokumentation Weathermap
Download
Diagram zu den Direktiven und wo sie sich auswirken
Referenz zu den Direktiven
Den Host-Status mit einbeziehen

Einige sehr schöne Weathermaps als Beispiele:
http://www.network-weathermap.com/node/51
http://forums.cacti.net/about24433.html

Erste Schritte, Screenshot 1
Die Standardkonfiguration kann man ersteinmal so lassen und man kann direkt auf console → Management → Weathermaps gehen.Hier findet man schon eine Beispielweathermap, bzw. die zugehörige Konfigurationsdatei simple.conf. Sie enthält statische Werte. Klickt man auf den Dateinamen gelangt man zum Editor, wo man die Konfigurationsdatei mit grafischen Mitteln bearbeiten kann. Rechts unten kann man sich mit „See config“ den Inhalt der Datei ansehen. Mit „Change File“ links oben gelangt man zurück zu Cacti und kann sich dann im Tab weathermap das Ergebnis anschauen.

Konfiguration, Screenshot 2
Die Grundkonfiguration erfolgt in:
Console –> Settings → Misc → Network Weathermap

Die Weathermaps werden erstellt und konfiguriert in:
Console → Management → Weathermaps
Dort kann man eine Konfigurationsdatei direkt anklicken und sie bearbeiten oder über den Link „Weathermap Editor“ unterhalb der Tabelle eine neue Datei erstellen lassen, auch als Kopie einer existierenden. Wenn man den Link verwendet und die Datei (grafisch) bearbeitet oder erstellt hat, muss man sie noch mit „Add“ zur Liste hinzufügen. Hierbei scheint es auch zu Problemen mit den Dateirechten zu kommen. Bei Bedarf einfach über die Shell die Rechte korrigieren, sodass sie dem Benutzer des Webservers gehören.

Der Weathermap-Editor in Cacti stellt ein Front-End zur Änderung der Konfigurationsdateien dar. Für jede Weathermap ist eine einzige dieser Dateien notwendig. In der Konfigurationsdatei befinden sich alle Angaben, die zum Generieren einer Weathermap erforderlich sind. Diese können jederzeit auch direkt manuell bearbeitet werden. Möchte man erweiterte Funktionen von Weathermap nutzen ist dies auch erforderlich, da noch nicht alle Funktionen des Editors implementiert sind.

Das schöne am Editor ist jedoch, dass man die Weathermaps wie in einem Grafikprogramm zusammenklicken kann und dabei an keinerlei Struktur gebunden ist.

Einige Angaben zur Konfigurationsdatei und dessen Direktiven:
NODE: Host, Switch, Router, etc.
LINK: Verbindung zwischen Nodes
BANDWIDTH: wird in bits/sec angegeben, man kann auch K,M,G,T für große Werte verwenden
TARGET : Hier wird die Datenquelle für einen Link angegeben, die rrd-Datei im Fall von Cacti
INFOURL: Link auf die zugehörige Graphen-Seite in Cacti
OVERLIBGRAPH: Zeigt eine Grafik an beim Drüberhovern

Wichtig: Die Reihenfolge der Nodes in der NODES-Linie in einem LINK ist entscheidend. Wenn man im Cacti-Editor beispielsweise einen Link erstellt und dafür zuerst auf Host1 und anschließend auf Host2 klickt, muss man als rrd-Datei, die auswählen, die zu Host1 gehört und in der NODES-Zeile muss zuerst Host1 gefolgt von Host2 stehen.

Man kann die rrd-Dateien für einen Node direkt im Editor aus Cacti auswählen, was die ganze Sache sehr bequem macht. Um das Plugin zu benutzen kann man einfach die rrd-Dateien verwenden, die aus Data-Templates stammen, die mit dem Data Query „SNMP - Interface Statistics“ erstellt wurden.

Betrieb, Screenshot 3
Die Weathermaps werden in Abhängigkeit des Cactipoller-Zyklus generiert, bzw. das was man unter Settings definiert hat. Im Bild ist Datum und Uhrzeit zu sehen, wann die Weathermap erzeugt wurde. Man sollte sie nicht manuell generieren lassen obwohl es einen Button dafür gibt, da die Datei-Rechte dadurch so geändert werden, dass ein automatisches Generieren anschließend nicht mehr ohne weiteres möglich ist. Das manuelle Generieren funktioniert jedoch danach weiterhin. Um die Dateirechte zu restoren, muss der Ordner output wie folgt aussehen. Vorhandene Weathermaps ebenfalls wieder auf den Benutzer des Webservers ändern:

# cd /var/www/html/plugins/weathermap/output/
# ls -lha
total 36K
drwxr-xr-x  2 apache apache 4.0K Jun 23 16:36 .
drwxr-xr-x  9 apache apache 4.0K Apr 14 05:40 ..
-rwxr-xr-x  1 apache apache    0 Apr 14 05:40 dummy-file.delete-me
-rwxr-xr-x  1 apache apache   33 Apr 14 05:40 .htaccess
-rwxr-xr-x  1 apache apache   62 Apr 14 05:40 index.php

Man kann Weathermaps auch manuell von der Kommandozeile erzeugen lassen, unabhängig von Cacti:

# php ./weathermap --config myconfigfile.conf --output mymap.png --htmloutput mymap.html

Ergänzende Hinweise
Was genau wird eigentlich angezeigt als Wert bei den Links?
x%
Dies bedeutet, der letzte Wert in der rrd-Datei, also das was beim letzten Pollerlauf dort abgelegt wurde. Dieser Wert wird in Relation(Prozent) gesetzt zum BANDWIDTH-Wert des Links. Es handelt sich, sofern man die Standard-rrd-Dateien nimmt um die aktuelle Netzlast, also wieviel Bits pro Sekunde wurden zum Ablesezeitpunkt übertragen. ( Wegen rrdtool handelt es sich natürlich wie sonst auch in Cacti immer um konsolidierte Werte und nicht um die tatsächlichen Werte.)

Zusammenfassung
Ein hervorragendes Plugin, das ungeahnte Möglichkeiten und Freiraum zur grafischen Darstellung von Daten im Netzwerk bietet. Obwohl es für die Darstellung der Netzlast bevorzugt verwendet wird, lassen sich damit letztlich alle Daten visualisieren, die man aus rrd-Dateien (oder anderen Quellen, siehe Weathermap-Dokumentation) auslesen kann.

Nagios und Cacti
Cacti-Training