DE:Nagios

From i-doit documentation

i-doit Benutzerhandbuch 0.9.x:

Hauptseite | Vorwort | Über dieses Handbuch | Release Notes | Nützliche Links | Installation | Systemkonfiguration | Grundlagen | Empfehlungen zum Vorgehen | Das CMDB-Modul | Allgemeine Kategorien | Spezifische Kategorien | Browser | Objekttypen | Verbindungen | Dateien | Lizenzen | Workflows | my-doit | Kontakte | Einstellungen | Nagios Integration | Report Manager | OCS Inventory NG

Einleitung

i-doit erlaubt sowohl das Auslesen von Statusdaten und -änderungen von Nagios, als auch die Erzeugung einer Konfiguration für Nagios aus den im i-doit hinterlegten Daten. Für das Auslesen von Statusdaten können sowohl aktuelle Daten zu Hosts und deren verknüpften Diensten auf der Oberfläche angezeigt werden, als auch eine Änderungshistorie im Logbuch gepflegt werden. Der Export erzeugt eine lauffähige Konfiguration für Nagios, die sowohl eine Hauptkonfigurationsdatei, als auch Dateien mit allen Objektdefinitionen enthält.

Statusdaten auslesen

Voraussetzungen

Um aktuelle und historische Statusdaten zu erfassen, bedient sich i-doit an einer NDO-Datenbank. Diese wird von den NDOUtils momentan nur als MySQL-Datenbank unterstützt. Der zuständige Administrator muss diese für i-doit zur Verfügung stellen. Einen Zugang zum eigentlichen Nagios-Server braucht i-doit hingegen nicht. Alle relevanten Daten werden von i-doit aus der NDO Datenbank gewonnen.

Die Zugangsdaten zur NDO-Datenbank können i-doit unter Module->Nagios->NDO MySQL Server bekannt gemacht werden.

Anzeige von Statusdaten

Überwachung von Hosts

Um nun zu einem Host und seinen verknüpften Diensten Statusdaten innerhalb der i-doit-Oberfläche anzuzeigen, steht die Kategorie Nagios zur Verfügung. Diese nimmt die Sicht eines Hosts unter Nagios ein. Wechselt man für ein Objekt in die Kategorie Nagios (diese muss dem Objekttyp zugewiesen sein), so kann dort die Überwachung aktiviert werden. Es muss lediglich der entsprechende Hostname innerhalb von Nagios angegeben werden. Nach Übernahme der Daten wird der aktuelle Status gemäß NDO Datenbank sowohl in der Objektübersicht als auch in der Ansicht der Kategorie Nagios angezeigt.

Überwachung von Diensten

Dienste werden unmittelbar mit Hosts verknüpft und sind für Nagios nur in Kombination mit diesen gültig. Wenn man in der Kategorie Anwendung/Dients eines Hosts einen Dienst verknüpft, so stehen als Nagios Parameter wiederum eine Aktivierung der Überwachung und die Angabe der service_description gemäß Nagioskonfiguration zur Verfügung. Die Kombination der Hostnamen aus der Kategorie Nagios und die service_description muss einer gültigen Kombination aus der Nagioskonfiguration entsprechen. Ist dies der Fall, so wird für diesen Dienst auf diesem Host der Status sowohl in der Dienstübersicht als auch innerhalb des Kategorieeintrags angezeigt.

Das Nagios Controllermodul

In der NDO Datenbank wird eine Statusänderungshistorie innerhalb eines einstellbaren Zeitfensters gepflegt. Mit Hilfe eines Handlers für Nagios kann mit der controller.php der letzte Stand der Historie in das Logbuch übernommen werden. Wie der Nagios Handler aufgerufen wird kann durch Ausführung der controller.php ohne Parameter eingesehen werden. Mittels Cron lassen sich so in regelmäßigen Abständen die Statusänderungen ins Logbuch eintragen. Dabei werden nur bereits vorhandene Einträge natürlich nur einmal übernommen. Hosts werden dabei anhand ihres Hostnamen identifiziert, der in der Kategorie Nagios genau so eingetragen sein muss. Selbiges gilt für alle Verknüpften Diensten und deren service_description.

Gewinnung einer Nagioskonfiguration

i-doit erlaubt für Hosts und deren Dienste, dass aus der CMDB eine Konfiguration für mit entsprechenden Objektdefinitionen erzeugt wird. Dabei versteht sich i-doit allerdings ausdrücklich nicht als reine Konfigurationsoberfläche für Nagios. Vielmehr sollen im Sinne eines ITSM-Frameworks aus der einmal abgebildeten Infrastruktur Informationen für andere Programme und Funktionen zur Verfügung gestellt werden, wobei Nagios nur einen möglichen Vertreter dieser Art darstellt. Aus diesem Grunde sind die Informationen, die für eine Nagioskonfiguration notwendig sind, auch dezentral abgespeichert.

Objekte in Nagios und i-doit

Es folgt ein kurzer Überblick über mögliche Nagiosobjekte und wie diese im i-doit abgebildet werden.

Hosts

Hosts zeichnen sich dadruch aus, dass sie einen Namen und eine IP-Adresse haben. Jedes IP-fähige Geraät ist also ein potentieller Nagioshost. Im i-doit wird ein Objekt als Host im Sinne von Nagios identifiziert, indem ihm die Kategorie Nagios zugewiesen wird. Dort können dann auch viele Parameter zentral gepflegt werden. Andere wiederum, wie z.B. die Kontakte, werden über die entsprechende Kategorie innerhalb des Objekts gepflegt.

Hostgruppen

Hostgruppen werden aus Gruppenobjekten gebildet, in denen sich Objekte befinden, die als Hosts im Sinne von Nagios definiert sind (denen also die Kategorie Nagios zugeordnet ist). Der Name der Gruppe ergibt sich hierbei aus dem Namen des Objektes in der Kategorie Allgemein.

Dienste

Dienste ergeben sich aus den Diensten, die einem Hostobjekt in der Kategorie Anwendung/Dienst zugeordnet sind. Ein Eintrag in der Kategorie Anwendung/Dienst kann um Nagiosparameter erweitert werden, um daraus eine Host-Dienst-Kombination zu schaffen. Auch hier werden Kontakte aus der Kontaktkategorie bezogen.

Dienstgruppen

Analog zu den Hostgruppen, wird aus jedem Gruppenobjekt, das mindestens einen Nagiosdienst enthält, eine Servicegruppe erzeugt.

Kontakte

Eine Person, die im i-doit existiert, wird zum Nagioskontakt, indem ihr in der Kontaktverwaltung die Kategorie Nagios zugeordnet wird. Wenn das Nagiosmodul installiert ist, wird diese Kategorie wird dem Baum der Kontaktverwaltung, neben Stammdaten und Gruppen hinzugefügt. Kontakte, die Nagioskontakte sind, werden den Hosts und Services zugewiesen, sofern diese in der Kategorie Kontakt des jeweiligen Objekts zugewiesen sind.

Kontaktgruppen

Kontaktgruppen von Nagios entsprechen den Kontaktgruppen im i-doit, wobei diesen ebenfalls die Kategorie Nagios zugewiesen werden muss.

Hostabhängigkeiten

Um diese Art der Abhängigkeit zu definieren, wird die Kategorie Abhängigkeiten eines Hosts oder einer Hostgruppe verwendet. Wenn ein Host oder eine Hostgruppe in ein Abhängigkeitsverhältnis zu einem anderen Host oder Gruppe gestellt wird, so können die entsprechenden Nagiosparameter dabei angegeben werden.

Dienstabhängigkeiten

Diese Art der Abhängikeit musste etwas komplexer umgesetzt werden, um die Konsistenz im Aufbau von i-doit beizubehalten. Innerhalb von i-doit werden Abhängigkeiten immer zwischen zwei Objekten definiert. Ein Dienst auf einem Host ist aber kein eigenständiges Objekt, sondern leidglich ein Kategorieeintrag. Aus diesem Grund wurde ein Mechanismus eingebaut, der es erlaubt aus genau diesen Kategorieeinträgen eigenständige Objekte zu erzeugen. Hierzu dient das Modul Abhängigkeiten.

Weitere Nagiosobjekte

Darüber hinaus existieren eine Reihe von Objekten in Nagios, die so nicht teil der CMDB sind. Hierzu gehören z.B. Timeperiods oder Commands. Diese werden im globalen Modul Nagios verwaltet. Eine Grundauswahl an vorgefertigten Objekten liegt der Modulinstallation bei. Hier definierte Commands können beispielsweise einem Host über die Nagioskategorie des selbigen zugewiesen werden. Außerdem findet man im Nagiosmodul eine Seite, um eine Mainconfig zu pflegen. Für die Bedeutung der einzelnen Parameter, sowohl in der Mainconfig, als auch innerhalb der Objekte, konsultieren Sie bitte die Dokumentation von Nagios.

Export

Ein Exportbutton befindet sich unter Module->Nagios->Export. Hiermit werden die Nagioskonfigurationsdateien ins lokale Dateisystem geschrieben und außerdem über die Oberfläche herunterladbar gemacht.