Wiki

Version 3 (Sebastian Harl, 01/05/2011 01:08 pm)

1 1 Sven Velt
h1. Nag(ix)SC
2 1 Sven Velt
3 1 Sven Velt
Ein Tool, um möglichst flexibel Nagios Check-Ergebnisse zu transportieren
4 1 Sven Velt
5 1 Sven Velt
Die wichtigsten Links:
6 1 Sven Velt
* Quellcode: http://github.com/wAmpIre/nagixsc
7 1 Sven Velt
** Snapshots als *.tar.gz: http://github.com/wAmpIre/nagixsc/tarball/master
8 1 Sven Velt
* Support-Forum im Nagios-Portal: http://www.nagios-portal.org/wbb/index.php?page=Board&boardID=96
9 1 Sven Velt
* Blog: http://velt.de/tags/nagixsc
10 1 Sven Velt
** Als RSS: http://velt.de/tags/nagixsc/feed
11 1 Sven Velt
12 1 Sven Velt
13 1 Sven Velt
h2. Motivation
14 1 Sven Velt
15 1 Sven Velt
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.
16 1 Sven Velt
17 1 Sven Velt
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|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.
18 1 Sven Velt
19 1 Sven Velt
Auf der Nagios-Maschine muss nun das XML analysiert, zerlegt und als Check-Ergebnisse dem Nagios-Prozess zur Weiterverarbeitung übergeben werden.
20 1 Sven Velt
21 1 Sven Velt
h2. Ein Einstieg (Tutorial)
22 3 Sebastian Harl
23 1 Sven Velt
* [[tutorial01|Schritt 1: Erstellen einer "conf-Datei"]]
24 1 Sven Velt
* [[tutorial02|Schritt 2: Erzeugen der XML-Datei/Struktur aus der "conf-Datei"]]
25 1 Sven Velt
* [[tutorial03|Schritt 3: Entschlüsseln/Lesen der XML-Datei/Struktur]]
26 1 Sven Velt
* [[tutorial04|Schritt 4: Übergabe der Ergebnisse aus der XML-Datei an den Nagios]]
27 1 Sven Velt
28 1 Sven Velt
h2. HowTos / Use Cases / Praktische Anwendungen
29 3 Sebastian Harl
30 1 Sven Velt
* [[usecase-cron-apache|Überwachung eines Rechners, der nur per HTTP/Apache erreichbar ist]] (Ursprung des Tools)
31 1 Sven Velt
* [[usecase-nrpe|Ersetzen von NRPE mit Hilfe von Nag(ix)SC]]
32 1 Sven Velt
33 1 Sven Velt
h2. Vorstellungen / Vorträge
34 3 Sebastian Harl
35 1 Sven Velt
FIXME
36 2 Sven Velt
* Offizielle Vorstellung am Nagios-Portal Workshop im Mai 2010 in Nürnberg (Angehängt, siehe unten)
37 2 Sven Velt
* Geplanter (aber ausgefallener) Vortrag auf der OSMC 2010 in Nürnberg (Angehängt, siehe unten)
38 1 Sven Velt
39 1 Sven Velt
h2. Die Bausteine
40 3 Sebastian Harl
41 1 Sven Velt
* [[conf|In den sog. "conf-Dateien" werden auszuführende Checks definiert]]
42 1 Sven Velt
* [[conf2xml|Mit Hilfe von "nagixsc_conf2xml" werden die Checks aus den "conf-Dateien" ausgeführt und die XML-Struktur erzeugt]]
43 1 Sven Velt
* [[conf2http|Ausführen der Checks und Erzeugung der XML-Struktur per HTTP-Request (NRPE-Alternative)]]
44 1 Sven Velt
* [[xml2nagios|Zur Übergabe einer XML-Struktur an das Nagios dient "xml2nagios"]]
45 1 Sven Velt
* [[http2nagios|Annahme einer XML-Struktur über HTTP (NSCA-Alternative)]]