Icinga Graphen mit PNP unter Debian 6.0 Squeeze

Aus Thomas-Krenn-Wiki
Zur Navigation springen Zur Suche springen
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-localhost.png

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:

Pnp-icinga-integration.png

Einzelnachweise

  1. Nagios Developer Guidelines (nagiosplug.sourceforge.net)
  2. Setup PNP with Icinga (wiki.icinga.org)
  3. PNP Web Frontend (docs.pnp4nagios.org)
  4. PNP4Nagios Setup Icinga (wiki.icinga.org)

Das könnte Sie auch interessieren

Adaptec RAID Monitoring Plugin unter Windows Server 2012 einrichten
CEP CT63 Modem Installation unter Ubuntu 12.04 LTS
IPMI Sensor Monitoring Plugin Version 1.x