Nagios#

Nagios ist eine Software für Network Monitoring, das aus den Daten der IT-Dokumentation heraus konfiguriert werden kann. Dadurch lassen sich eine doppelte Pflege von Daten vermeiden und Fehler minimieren. Der in i-doit verfügbare Export erlaubt es, vollständige oder partielle Konfigurationen zu erzeugen. Dazu werden in der i-doit-Oberfläche Nagios-Konfigurationen manuell angelegt oder automatisiert mit Werten unterfüttert.

Grundkonfiguration#

Unter Verwaltung → Import und Schnittstellen → Monitoring → Exportkonfiguration wird die Konfiguration hinterlegt. Der Lokale Pfad definiert einen absoluten oder relativen Pfad zur i-doit Installation im Dateisystem, in dem die von i-doit erzeugte Konfiguration abgelegt werden soll. Der Link zum Monitoring Tool gibt einen Basislink an, um aus i-doit heraus Links auf die Monitoring-Instanz zu generieren.

Basiskonfigurationen#

Unter Add-ons → Nagios werden die Basiskonfigurationen angelegt.

Dazu gehört die Hauptkonfiguration, Service- und Host-Templates sowie weitere grundlegende Einstellungen. Alle Werte sind 1:1 mit der Nagios-Konfiguration deckungsgleich.

Konfiguration in Objekten#

Alle weiteren Konfigurationen werden innerhalb der Objekte vorgenommen. Der einfachste Fall ist die Konfiguration von Host Parameter. Hierzu muss über Datenstruktur bearbeiten der Kategorie Ordner Nagios (Host) zu den gewünschten Objekttypen zugewiesen werden.

In der Kategorie Host Definition kann dann entweder über ein Nagios Template oder durch individuelle Konfiguration eine Hostdefinition für Nagios hinterlegt werden.

Das Prinzip der Host- und Service Templates ist mit der Nagios-Konfiguration deckungsgleich. Über die Kategorie Servicezuweisung werden in der Basiskonfiguration definierte Servicechecks einem Host zugewiesen. Als Ergebnis bildet sich später hieraus die Konfiguration einer klassischen Host-zu-Service-Zuweisung. Es gibt zusätzlich einen zweiten Weg, wie Services zu Hosts zugewiesen werden können. Dies geschieht über die Vererbung über ein Softwareobjekt.
in einem Softwareobjekt in der Kategorie Nagios (Anwendungen) wird ein Servicecheck zugewiesen, analog zu der Zuweisung zu einem Host. Ist diese Anwendung nun über die Kategorie Softwarezuweisung auf einem Host installiert, wird der Servicecheck auf den Host automatisch vererbt. Weitere Nagios-Konfigurationen innerhalb von Objekten finden sich in Objekten vom Typ Personen sowie in Personengruppen und Objektgruppen.

Export der Nagios Konfiguration#

Unter Verwaltung → Import und Schnittstellen → Monitoring → Exportkonfiguration können die Nagios-Konfigurationen manuell exportiert werden. Dazu wird eine Exportkonfiguration ausgewählt und optional eine Validierung der Parameter angewählt.

Die Validierung überprüft grundlegende Abhängigkeiten, ob beispielsweise eine IP-Adresse für einen Host eingetragen ist. Diese Überprüfung soll davor schützen, korrupte Nagios-Konfigurationen zu erzeugen, allerdings ist es kein 100-prozentiger Schutz. Zur Sicherheit sollte immer ein Test mit der Nagios Binary über die erzeugte Konfiguration gefahren werden.

Die Konfigurationsdateien werden gemäß dem konfigurierten Pfad auf dem Dateisystem abgelegt und entsprechen den in den Kategorien konfigurierten Werten.

Selbstverständlich lässt sich der Export der Dateien auch über die i-doit Console automatisieren. Eine Beschreibung der einzelnen Parameter sowie ein Beispiel sind im entsprechenden Artikel für die Option Exportkonfiguration zu finden.

CLI Console Commands und Optionen#

nagios-export#

Exportiert die Nagios-Einstellungen und i-doit Objekte in Nagios-Konfigurationsdateien.

Optionen:

Beispiel zur Verwendung

1

sudo -u www-data php console.php nagios-export --user admin --password admin --tenantId 1 --nagiosHostId 1

nagios-ndoutils#

Importiert Monitoring Statusänderungen aus den NDOUtils in das i-doit Logbuch.

Optionen:

Beispiel zur Verwendung

1

sudo -u www-data php console.php nagios-ndoutils --user admin --password admin --tenantId 1

Changelog#