ndomod.cfg

In der Datei ndomod.cfg (liegt bei Installation aus den Quellen in /usr/local/nagios/etc) gibt es einige Einstellungen, die das Verhalten der Datenausgabe beeinflussen.

Die folgenden Optionen können in der Datei verwendet werden (Stand ndoutils 1.4b5, 8/2007):

• Standardwert: default
• Mögliche Werte: Zeichenfolge
• Beispiel: instance_name=default

Mit dieser Einstellung werden alle Daten, die von dieser Nagiosinstanz generiert werden, mit einem Namen gekennzeichnet. Das ist notwendig, wenn mehrere Nagiosserver bzw. -instanzen jeweils für sich Daten generieren, die dann aber mit einem jeweiligen ndomod an eine zentrale Stelle gesendet werden sollen. Bei nur einem Nagiosserver lässt man diese Option auf dem Standardwert „default“, bei mehreren Servern bzw. Nagiosdaemons muss jeder in seiner ndomod.cfg einen eindeutigen Namen erhalten.

• Standardwert: UNIX domain socket
• Mögliche Werte:
  • file
  • tcpsocket
  • unixsocket
• Beispiel: output_type=unixsocket

Hiermit wird festgelegt, welche Art von Ausgabeschnittstelle das NDO Nagios-Eventbrokermodul verwenden soll. Es gibt die Auswahl zwischen einer normalen Textdatei, einem TCP Socket und einem Unix Domain Socket (Standard).

• Standardwert: (keiner)
• Mögliche Werte:
  • Dateiname
  • IP-Adresse
  • Socket-Dateiname
• Beispiel: output=/usr/local/nagios/var/ndo.sock

Hier wird passend zur vorherigen Option das Ziel der Schnittstelle näher bestimmt. Wenn vorher „file“ oder „unixsocket“ gewählt wurde, muss hier ein gültiger Dateiname folgen. Wenn die obere Option „tcpsocket“ lautet, muss hier eine IP-Adresse oder ein FQDN des Zielhosts angegeben werden, der die Daten empfangen soll.

• Standardwert: (keiner)
• Mögliche Werte: eine Portnummer
• Beispiel: tcp_port=5668

Im Falle des output_type tcpsocket wird hier die TCP Portnummer eingestellt, an die auf dem Zielhost die Daten gesendet werden. Bei einem anderen output_type wird dies Option ignoriert.

• Standardwert: (keiner)
• Mögliche Werte: eine Zahl
• Beispiel: output_buffer_items=5000

Hiermit wird die Größe des Ausgangspuffers in Zeilen festgelegt. Jedes ausgegebene Datum besteht aus mehreren Zeilen unterschiedlicher Länge. In diesem Puffer werden bei Verbindungsunterbrechungen Daten bis zur angegebenen Zeilenanzahl zwischengespeichert, bis sie erfolgreich an das Ziel abgesendet werden konnten. Läuft dieser Puffer voll, gehen Daten verloren (Log-Meldung: Error writing to data sink! Some output may get lost. <n> queued items to flush.).

• Standardwert: (keiner)
• Mögliche Werte: ein gültiger Dateiname
• Beispiel: buffer_file=/usr/local/nagios/var/ndomod.tmp

Mit dieser Option wird die Datei festgelegt, in die beim Beenden von Nagios noch im Puffer befindliche Daten gespeichert werden, um bei einem (erneuten) Start von Nagios an den Socket weitergegeben zu werden.

• Standardwert: (keiner)
• Möglicher Wert: Anzahl Sekunden
• Beispiel: file_rotation_interval=14400

Diese Option legt fest, in welchen Zeitabständen (in Sekunden) die Ausgabedatei rotiert wird. Die Rotation wird von Nagios gehandhabt, indem ein Kommando ausgeführt wird, dass in der Option file_rotation_command festgelegt wird. Diese Option wird nur berücksichtigt, solange der output_type kein Socket ist.

• Standardwert: (keiner)
• Mögliche Werte: ein in Nagios definiertes Kommando
• Beispiel: file_rotation_command=rotate_ndo_log

Mithilfe des hier angegebenen Nagios-Kommandos wird in den weiter oben angegebenen Zeitabständen die Dateirotation der Ausgabedatei durchgeführt. Das passiert nur, wenn der output_type auf file steht. In der Datei 'misccommands.cfg' finden Sie ein Bespielkommando, mit der eine Rotation erreicht wird:

define command{ command_name rotate_ndo_log command_line /bin/mv /usr/local/nagios/var/ndo.dat /usr/local/nagios/var/ndo.`date +%s` }

• Standardwert: (keiner)
• Mögliche Werte: Anzahl Sekunden
• Beispiel: file_rotation_timeout=60

Hiermit wird die maximale Dauer in Sekunden festgelegt, die das Rotationkommando laufen darf, bevor der Prozess abgebrochen wird.

• Standardwert: (keiner)
• Mögliche Werte: Anzahl Sekunden
• Beispiel: reconnect_interval=15

Dies ist der Zeitabstand in Sekunden, nach dem das NDO Nagios Eventbroker Modul versucht, sich nach einem Verbindungsabbruch wieder mit dem Socket oder der Datei zu verbinden.

• Standardwert: (keiner)
• Mögliche Werte: Anzahl Sekunden
• Beispiel: reconnect_warning_interval=15

Dies ist der Zeitabstand, in dem eine Warnmeldung in die Nagios-Logdatei geschrieben wird, wenn die Verbindung zum Socket oder zur Ausgabedatei abgebrochen ist. Diese Meldung wird im angegebenen ABstand solange wiedreholt, bis die Verbindung zur Datei oder dem Socket wieder hergestellt wurde.

• Standardwert: (keiner)
• Mögliche Werte: -1 oder eine positive Zahl
• Beispiel: data_processing_options=-1

Mit dieser Option wird festgelegt, welche Daten aus dem Nagiosbetrieb über den Socket oder Datei ausgegeben werden sollen. Mit Wert “-1“ wird alles ausgegeben. Andere gültige Optionswerte sind eine Summe folgender Zahlen:

• Standardwert: (keiner)
• Mögliche Werte: 0, 1, 2, oder 3
• Beispiel: config_output_options=2

Hiermit wird die Quelle, aus der die Konfigurationsdaten bezogen werden. Werte:

• 0 = Don't dump any configuration information
• 1 = Dump only original config (from config files)
• 2 = Dump config only after retained information has been restored
• 3 = Dump both original and retained configuration