Integration von DokuWiki in Nagios

Ein wichtiger Punkt beim Monitoring mit Nagios ist die Dokumentation der einzelnen Hosts und Services. Je größer das Team der Administratoren wird, um so wichtiger wird eine gute Dokumetation.

Hier bietet sich die Integration eines Wiki an. Hier am Beispiel von DokuWiki

Vorteile:

• Existiert ein Link nicht, so kann ihn jeder selbst anlegen.
• Einfache Verlinkung über notes_url in serviceextinfo.
• Nagios Macros können verwendet werden.

Definition:

define serviceextinfo{
host_name              router
service_description    ping
notes_url              /wiki/nagios.php?host=$HOSTNAME$&srv=$SERVICEDESC$
icon_image             help.png
}

In Wikis werden Leerzeichen durch Unterstriche ersetzt. Weiterhin wird jede Seite klein geschrieben. Damit nun auch notes_url über die Makros auch immer das richtige Dokument findet, wird die Umleitungsseite nagios.php verwendet.

Nagios.php erhält den Inhalt von $HOSTNAME$ und $SERVICEDESC$ über HTTP GET Parameter.

nagios.php?host=$HOSTNAME$&srv=$SERVICEDESC$

Im Script selbst wird aus diesen Informationen auf die passende Seite im Wiki verlinkt.

<?php
/**
 * Forwarder to doku.php
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Joerg Linge <pitchfork@ederdrom.de>
 */
$host=str_replace(' ', '_',strtolower($_GET['host']));
$srv=str_replace(' ', '_',strtolower($_GET['srv']));
 
if($host!="" && $srv!=""){
        header("Location: doku.php?id=nagios:".$host.":".$srv);
        exit;
}elseif($host!=""){
        header("Location: doku.php?id=nagios:".$host.":host");
        exit;
}else{
        header("Location: doku.php?id=nagios:index");
        exit;
}
?>

Kein Link zur Doku wird ins „leere“ laufen.
Das Team hat die Möglichkeit sofort Änderungen an der Doku vorzunehmen oder Tips zu hinterlegen.

Da DokuWiki jede Seite als Text File abspeichert, kann der Inhalt auch direkt in der Datei geändert werden. So kann ein ChageLog mit VI geschrieben werden, ist aber im Wiki immer aktuell eingebunden. Die Syntax ist leicht zu erlernen und auch im VI noch übersichtlich.