Das Discovery-Plugin für Cacti

Überblick
Offizielle Dokumentation und Download
Warnung
Erste Schritte
Konfiguration
Betrieb ohne Discovery-Templates
Betrieb mit Discovery-Templates
Ergänzende Hinweise
Zusammenfassung

Inoffizielles Handbuch für Cacti

Überblick, Screenshot 1
Eigenschaften und Features dieses Plugins:
Automatische Erkennung von Devices in einem Subnet, die noch nicht von Cacti gemonitort werden, sowie Erkennung ob snmp aktiviert ist. Mit Discovery-Templates automatische Zuordnung von gefundenen Devices zu einem Host-Template an Hand des snmp-sysDescr-Strings des gefundenen Hosts. Dadurch wird das Device Cacti hinzugefügt und Graphen, denen des Host-Templates basieren werden automatisch generiert und im Baum abgelegt.

Offizielle Dokumentation und Download
Dokumentation
Download

Warnung
Im schlimmsten Fall werden zigtausende von Graphen erzeugt, wenn es durch sysDescr der erkannten Devices zur Zuordnung mit einem falschen Host-Template kommt! Besser dieses Plugin nur manuell von der Kommandozeile starten, damit man direkt sieht was es macht. Leider muss man trotzdem den Discovery-Poller aktiviert lassen. Wenn man ihn auf disabled setzt, geht es von der Kommandozeile auch nicht.

Daher am besten wie folgt vorgehen. Sofern man Discovery-Templates verwendet: Möchte man Scannen, in Cacti die „Poller Frequency“ auf „Every 4 Weeks“ setzen, dann manuell starten, anschließend die „Poller Frequency“ wieder auf disabled setzen.

Es ist jedoch sicherer, keine Discovery-Templates zu verwenden, sodass es nur scannt/discovert aber nichts in Cacti verändert, also keine Devices oder Graphen hinzufügt. In diesem Fall kann man die „Poller Frequency“ aktiviert lassen, da er keine Devices/Graphen automatisch hinzufügt.

Oder andere Idee: Man vereinbart einen String, den man in alle snmpds, die auf Geräten laufen, die automatisch erkannt werden sollen, einträgt. Damit erstellt man dann ein Discovery-Template. So ist gewährleistet, dass nur für diese Geräte Graphen automatisch generiert werden.

Erste Schritte
Hinweis zum Tab des Discovery-Plugins:
Man denkt, dass wenn man go klickt, dass dann gescannt wird. Das stimmt aber nicht! Das ist nur der Filter für die Darstellung der bereits erkannten Devices. Und diese werden mit den Pollerläufen erkannt, dessen Frequenz wiederum wie unten erklärt wird gesetzt werden muss!

Um das Discovery-Plugin in zu aktivieren geht man nach Console → Settings → Misc und dort in den Abschnitt „Discover“. Hier ist das wichtigste die „Poller Frequency“ auf einen konkreten Wert, also nicht disabled, zu setzen. Solange man das nicht macht ist das ganze Plugin deaktiviert. Man kann es dann auch nicht explizit von der Kommandozeile aus verwenden.
Ohne die „Poller Frequency“ zu setzen, sieht es über die Kommandozeile so aus:

# php -q /var/www/html/plugins/discovery/findhosts.php -f -d
Discovery Polling is set to disabled.

Konfiguration, Screenshot 2
Die Konfiguration wird wie schon erwähnt unter Console → Settings → Misc und dort im Abschnitt „Discover“ durchgeführt.

Man kann mehrere Subnets mit Komma getrennt angeben. Mehrere Community Strings trennt man mit Doppelpunkt. Man kann auch IP-Bereiche angeben: z.B. „192.168.1.30-192.168.1.40“.

Bei den letzten beiden Optionen in den Settings konnte ich auf meinem Testsystem kein unterschiedliches Verhalten feststellen, egal ob sie aktiviert waren oder nicht:
Rerun Data Queries
Create Graphs for Up Interfaces Only

Ist die Poller-Frequency gesetzt findet es Devices. Aber es fügt nur solche in der Liste der erkannten Devices hinzu, die snmp aktiviert haben und wo der Community String aus den Settings → Misc passt. Das erscheint dann auf der Kommandozeile als

192.168.1.33 is a valid device!

Das bedeutet für das initiale Erkennen von Devices muss dort snmp laufen und der Community String aus den Settings für das Plugin muss dort verwendbar sein.

Betrieb ohne Discovery-Templates
Mit „Add“ kann man aus der Liste der erkannten Devices ein neues Device in Cacti anlegen, man gelangt auf die Seite, die man sonst mit Console → Devices → Add erreicht.

Wenn ein erkannter Host schon unter Devices in Cacti eingetragen ist, meldet findhosts.php „Host is already in hosts table!“ und er wird nicht in die Liste der erkannten Devices eingetragen.

Seltsamerweise wird im Discovery-Tab in der Spalte „SNMP“ immer Up angezeigt egal ob der snmpd dort läuft oder nicht. Stattdessen wird in der Spalte „Status“ down angezeigt sobald der snmpd nicht läuft. Ist das Device komplett vom Netz getrennt bleibt SNMP nach wie vor up! und der Status steht auf down. Daraus folgt: Man erkennt auf dem Discovery-Tab nicht ob nur der snmpd down ist oder das ganze Device.(Vermutlich wird einfach der letzte Status des snmpd angezeigt, da man nicht wissen kann ob er läuft oder nicht.)

Betrieb mit Discovery-Templates, Screenshot 3
Erstellt man ein Discovery-Template, so muss man das gewünschte Host-Template auswählen, sowie eine Position im Tree und die snmp-System-Description. Mit letzterer wird der Host identifiziert und auf Grund dessen dem Host-Template zugeordnet und die Graphen in der gewählten Position im Baum erstellt. Dies geht alles automatisch, man muss nur den Discovery-Poller laufen lassen.

Alle Devices, die erkannt und (durch ein Discovery-Template) automatisch zu Cacti hinzugefügt wurden, tauchen nicht mehr in der List auf dem Discovery-tab auf. Die Device-Description in Cacti wird durch den snmp-Hostnamen gesetzt.

Ergänzende Hinweise
Man kann nur entweder scannen/discovern lassen (dann erstellt man keine Discovery-Templates) oder scannen/discovern mit Discovery-Templates: Dann werden automatisch die entdeckten Devices hinzugefügt, die Graphen erzeugt und im Tree hinterlegt. Nur die Devices automatisch anlegen lassen, ohne die Graphen zu erzeugen geht leider nicht.

Zusammenfassung
Gut geeignet, um snmp-fähige Geräte im Netz aufzuspüren.
Beim automatischen Anlegen der Devices in Cacti und der damit verbundenen automatischen Graphengenerierung hat der Anwender relativ wenig Steuerungsmöglichkeiten. Trotzdem kann es möglicherweise nützlich sein, sofern man entsprechende Vorsicht walten lässt.

Nagios und Cacti
Cacti-Training