Nagios#

Nagios ist eine Software für Network Monitoring, die du aus den Daten deiner IT-Dokumentation heraus konfigurierst. So vermeidest du doppelte Datenpflege und minimierst Fehler. Der Export erzeugt vollständige oder partielle Konfigurationen -- entweder manuell angelegt oder automatisiert mit Werten aus i-doit befuellt.

Grundkonfiguration#

Richte die Konfiguration unter Verwaltung → Import und Schnittstellen → Monitoring → Exportkonfiguration ein:

• Lokaler Pfad -- Absoluter oder relativer Pfad, in dem die erzeugte Konfiguration abgelegt wird.
• Link zum Monitoring Tool -- Basislink, um aus i-doit 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 nimmst du innerhalb der Objekte vor. Für Host-Parameter gehst du so vor:

1. Weise über Datenstruktur bearbeiten den gewünschten Objekttypen den Kategorie-Ordner Nagios (Host) zu.
2. Hinterlege in der Kategorie Host Definition eine Hostdefinition -- entweder über ein Nagios-Template oder durch individuelle Konfiguration.

Host- und Service-Templates entsprechen dem Nagios-Prinzip. Über die Kategorie Servicezuweisung weist du einem Host Servicechecks zu.

Es gibt zwei Wege, Services mit Hosts zu verknüpfen:

1. Direkte Zuweisung -- Über die Kategorie Servicezuweisung im Host-Objekt.
2. Vererbung über Software -- Weise in einem Softwareobjekt (Kategorie Nagios (Anwendungen)) einen Servicecheck zu. Ist die Software über die Kategorie Softwarezuweisung auf einem Host installiert, erbt der Host den Servicecheck automatisch.

Weitere Nagios-Konfigurationen findest du in Objekten vom Typ Personen, Personengruppen und Objektgruppen.

Export der Nagios Konfiguration#

Den Export startest du manuell unter Verwaltung → Import und Schnittstellen → Monitoring → Exportkonfiguration. Wähle eine Exportkonfiguration und aktiviere optional die Validierung.

Die Validierung prüft grundlegende Abhängigkeiten -- z. B. ob eine IP-Adresse für einen Host eingetragen ist. Sie schützt vor korrupten Konfigurationen, bietet aber keinen 100-prozentigen Schutz. Teste die erzeugte Konfiguration daher immer zusätzlich mit der Nagios-Binary.

Die Konfigurationsdateien werden im konfigurierten Pfad abgelegt. Den Export kannst du auch über das i-doit console utility automatisieren (--help zeigt alle Optionen).

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#