Icinga

7.1. Externe Befehle

7.1.1. Einführung
7.1.2. Externe Befehle aktivieren
7.1.3. Wann prüft Icinga auf externe Befehle?
7.1.4. Externe Befehle benutzen
7.1.5. Befehlsformat

7.1.1. Einführung

Icinga kann Befehle aus externen Applikationen verarbeiten (einschließlich der CGIs) und verschiedene Aspekte seiner Überwachungsfunktionen aufgrund der Befehle verändern, die es erhält. Externe Applikationen können Befehle "einreichen", indem sie in das command file schreiben, das regelmäßig vom Icinga-Daemon verarbeitet wird.

7.1.2. Externe Befehle aktivieren

Damit Icinga externe Befehle verarbeitet, müssen Sie folgendes tun:

  • aktivieren Sie die Prüfung auf externe Befehle mit der check_external_commands-Option.

  • setzen Sie die Wiederholrate von Befehlsprüfungen mit der command_check_interval-Option.

  • definieren Sie den Ort des Command-File mit der command_file-Option.

  • setzen Sie korrekte Berechtigungen für das Verzeichnis, welches das External-Command-File enthält, wie in der Schnellstartanleitung beschrieben.

7.1.3. Wann prüft Icinga auf externe Befehle?

  • in regelmäßigen Intervallen, wie sie durch die Option command_check_interval in der Hauptkonfigurationsdatei angegeben sind

  • direkt nachdem Eventhandler ausgeführt werden. Das passiert zusätzlich zum regelmäßigen Zyklus von externen Befehlsprüfungen und wird getan, um unverzügliche Aktivitäten zu ermöglichen, falls ein Eventhandler Befehle an Icinga schickt.

7.1.4. Externe Befehle benutzen

Externe Befehle können benutzt werden, um eine Reihe von Dingen zu erreichen, während Icinga läuft. Beispiele dafür, was getan werden kann, umfassen u.a. vorübergehend Benachrichtigungen für Services und Hosts zu deaktivieren, vorübergehend Service-Prüfungen zu deaktivieren, sofortige Service-Prüfungen zu erzwingen, Kommentare für Hosts und Services hinzuzufügen usw.

7.1.5. Befehlsformat

Externe Befehle, die in das command file geschrieben werden, haben das folgende Format...

 [ Zeit]  Befehls-ID; Befehlsargumente 

...wobei Zeit die Zeit (im time_t-Format) ist, zu der die externe Applikation den externen Befehl an das Command-File geschickt hat. Die Werte für die Befehls-ID und die Befehlsargumente hängen davon ab, welcher Befehl an Icinga geschickt wird.

7.1.5.1. External Commands Liste

Eine komplette Liste der Befehle, die benutzt werden können, finden Sie in der Liste der externen Befehle.