Icinga Graphen mit PNP unter Debian 6.0 Squeeze
Hinweis: Bitte beachten Sie, dass dieser Artikel / diese Kategorie sich entweder auf ältere Software/Hardware Komponenten bezieht oder aus sonstigen Gründen nicht mehr gewartet wird. Diese Seite wird nicht mehr aktualisiert und ist rein zu Referenzzwecken noch hier im Archiv abrufbar. |
---|
PNP ist ein Addon für oder Icinga, mit dem die Performance-Daten des Plugins in Graphen dargestellt werden kann. Voraussetzung dafür ist, dass die Plugins developer-guideline-gerechte Daten produzieren.[1] PNP nutzt RRDtool um die Graphen zu zeichen, für die interne Verwaltung der Performance-Daten stehen mehrere Optionen zur Verfügung - s.a. PNP Daten-Modi (pnp4nagios.org). Im letzten Punkt wird gezeigt, wie PNP in eine vorhandene Icinga-Web-Installation integriert werden kann.
Installation
Wie bereits erwähnt wird für die Darstellung der Graphen RRDtool benötigt:
apt-get install rrdtool librrds-perl
Anschließen wird PNP von der Download-Seite bezogen (http://docs.pnp4nagios.org/pnp-0.6/dwnld) bzw. direkt von Sourceforge geladen. Beim configure-Schritt wird darauf geachtet, dass die User auf die bestehenden Icinga-User abgeändert werden:[2]
wget http://sourceforge.net/projects/pnp4nagios/files/latest/download?source=files
tar xzvf pnp4nagios-0.6.16.tar.gz
./configure --with-nagios-user=icinga --with-nagios-group=icinga
make all
make install install-webconf install-config install-init
Die mitgelieferten Beispiel-Konfigurationen sind für den Betrieb ausreichend. Bei Bedarf kann für die Fehlersuche Logging aktiviert werden:
:~# cd /usr/local/pnp4nagios/etc
:/usr/local/pnp4nagios/etc# mv rra.cfg-sample rra.cfg
:/usr/local/pnp4nagios/etc# mv npcd.cfg-sample npcd.cfg
:/usr/local/pnp4nagios/etc# mv process_perfdata.cfg-sample process_perfdata.cfg
:/usr/local/pnp4nagios/etc# vi npcd.cfg
log_type = file
log_level = 1
In der "config.php" muss sicher gestellt sein, dass die Baseurl auf icinga zeigt:
:/usr/local/pnp4nagios/etc# vi config.php
$conf['nagios_base'] = "/icinga/cgi-bin";
Nun wird zur Konfig von Icinga gewechselt, in der der Verarbeitungsmodus von PNP festgelegt wird. Im folgenden Beispiel wird die Option "Bulk Mode with NPCD und npcdmod" (docs.pnp4nagios.org) eingesetzt:
:/usr/local/pnp4nagios/etc# cd /usr/local/icinga/etc/
:/usr/local/icinga/etc# vi icinga.cfg
############################
#Adding npcdmod to config
###########################
process_performance_data=1
broker_module=/usr/local/pnp4nagios/lib/npcdmod.o config_file=/usr/local/pnp4nagios/etc/npcd.cfg
Funktionen prüfen
Von nun an kann das PNP-Interface über "$IP-Adresse/pnp4nagios" aufgerufen werden. Beim ersten Aufruf erscheint eine Installations-Überprüfung, ob die Konfiguration bis zum jetzigen Zeitpunkt korrekt verlaufen ist (vgl. Abbildung unten). Sind alle Checks erfolgreich verlaufen, kann die php-Datei umbenannt werden:
:~# cd /usr/local/pnp4nagios/share/
:/usr/local/pnp4nagios/share# mv install.php install.php.done
Eine weitere Möglichkeit die Installation und Konfiguration zu überprüfen führt über das Script "verify_pnp_config" (docs.pnp4nagios.org):
wget http://verify.pnp4nagios.org/verify_pnp_config
Diesem Script übergibt man den verwendeten Verarbeitungs-Modus (hier npcdmod) und die Pfade zu den Konfigurationsdateien (siehe Abbildung unten).
PNP aufrufen
Nach erfolgreichem Test kann PNP unter "$IP-Adresse/pnp4nagios/graph?host=localhost" für den localhost aufgerufen werden. Die direkte Integration in die Icinga/Nagios-Oberfläche erfordert jedoch weitere Konfigurationsschritte, weiter unten folgen.[3] Die folgende Grafik zeigt z.B. einen Ping-Zeiten-Graph.
PNP in Icinga-Web integrieren
Für die Integration von PNP wird ab Version 1.5 die Integration in Icinga erleichtert.[4] Im Quelldatei-Verzeichnis von Icinga-Web befinden sich im Verzeichnis "contrib/PNP_Integration" Konfigurationsdateien. Diese müssen nur mehr an den richtigen Ort von Icinga-Web kopiert werden:
:/usr/src/icinga-web-1.6.1/contrib/PNP_Integration# cp templateExtensions/pnp-* /usr/local/icinga-web/app/modules/Cronks/data/xml/extensions/
Danach muss noch der vorhandene Cache geleert werden:
:~# cd /usr/local/icinga-web/app/cache/
:/usr/local/icinga-web/app/cache# rm config/*
Dann sind die Graphen von PNP in der Icinga-Web-Oberfläche vorhanden:
Einzelnachweise
- ↑ Nagios Developer Guidelines (nagiosplug.sourceforge.net)
- ↑ Setup PNP with Icinga (wiki.icinga.org)
- ↑ PNP Web Frontend (docs.pnp4nagios.org)
- ↑ PNP4Nagios Setup Icinga (wiki.icinga.org)