Nag(ix)SC¶

Ein Tool, um möglichst flexibel Nagios Check-Ergebnisse zu transportieren

Die wichtigsten Links:

• Quellcode: http://github.com/wAmpIre/nagixsc
  • Snapshots als *.tar.gz: http://github.com/wAmpIre/nagixsc/tarball/master
• Support-Forum im Nagios-Portal: http://www.nagios-portal.org/wbb/index.php?page=Board&boardID=96
• Blog: http://velt.de/tags/nagixsc
  • Als RSS: http://velt.de/tags/nagixsc/feed

Motivation¶

Die Nagios AddOns NRPE und NSCA setzen auf eigene TCP-Protokolle (und somit einen eigenen Port) ein. Nicht immer können diese Protokolle vom Nagios-Server zur überwachenden Maschine (bzw. umgekehrt) eingesetzt werden. Insbesondere bei Firewall-Administratoren stößt man nicht unbedingt auf Gegenliebe, wenn man weitere Ports geöffnet haben möchte.

Nag(ix)SC bringt alles mit, um NRPE-like Checks auszuführen und die Ergebnisse in einer XML-Struktur abzulegen. Dieses XML muss nun transportiert werden. Der bevorzugte Weg hierfür ist HTTP (Warum HTTP?), allerdings spricht auch nichts dagegen, die Datei z.B. per "scp" über Rechnergrenzen zu kopieren, per "(x)inetd" auf einem eigenen Port zur Verfügung zu stellen oder als E-Mail-Attachement per SMTP zu verschicken.

Auf der Nagios-Maschine muss nun das XML analysiert, zerlegt und als Check-Ergebnisse dem Nagios-Prozess zur Weiterverarbeitung übergeben werden.

Ein Einstieg (Tutorial)¶

• Schritt 1: Erstellen einer "conf-Datei"
• Schritt 2: Erzeugen der XML-Datei/Struktur aus der "conf-Datei"
• Schritt 3: Entschlüsseln/Lesen der XML-Datei/Struktur
• Schritt 4: Übergabe der Ergebnisse aus der XML-Datei an den Nagios

HowTos / Use Cases / Praktische Anwendungen¶

• Überwachung eines Rechners, der nur per HTTP/Apache erreichbar ist (Ursprung des Tools)
• Ersetzen von NRPE mit Hilfe von Nag(ix)SC

Vorstellungen / Vorträge¶

FIXME

• Offizielle Vorstellung am Nagios-Portal Workshop im Mai 2010 in Nürnberg (Angehängt, siehe unten)
• Geplanter (aber ausgefallener) Vortrag auf der OSMC 2010 in Nürnberg (Angehängt, siehe unten)

Die Bausteine¶

• In den sog. "conf-Dateien" werden auszuführende Checks definiert
• Mit Hilfe von "nagixsc_conf2xml" werden die Checks aus den "conf-Dateien" ausgeführt und die XML-Struktur erzeugt
• Ausführen der Checks und Erzeugung der XML-Struktur per HTTP-Request (NRPE-Alternative)
• Zur Übergabe einer XML-Struktur an das Nagios dient "xml2nagios"
• Annahme einer XML-Struktur über HTTP (NSCA-Alternative)