Tutorial01 - conf-Datei¶
In den Quellen liegen zwei conf-Dateien im Verzeichnis "sample-configs/conf/" bei:- "
sample-configs/conf/nagixsc_debian.conf" - "
sample-configs/conf/nagixsc_usrlocal.conf"
Der Funktion beider Dateien ist identisch, sie unterscheiden sich nur in den Pfadangaben zu den Nagios-Plugins. Wie die Namen schon vermuten lassen, ist "nagixsc_debian.conf" für Debian-Systeme gedacht, die die Plugins unterhalb von "/usr/lib/nagios/plugins/" aus den Debian-Packages installiert haben. Im Fall von "nagixsc_usrlocal.conf" werden die Plugins innerhalb von "/usr/local/libexec/" ausgeführt.
In den folgenden Beispielen ist der Pfad durch "/.../" ersetzt und es wird allgemein von einer "nagixsc.conf" gesprochen. So sieht sie dann aus:
[nagixsc]
Reserved: For future use
[host1]
_underscores_at_start: reserved
_use_section_name_as: host_name in nagios
_host_check: /.../check_host -H 127.0.0.1
Disk_Home: /.../check_disk -w 10% -c 5% -m -p /home
Disk_Root: /.../check_disk -w 10% -c 5% -m -p /
Load: /.../check_load -w 5,5,5 -c 10,10,10
[host2]
_host_name: host2.foo.bar
Procs_Total: /.../check_procs -w 200 -c 250
Swap: /.../check_swap -w 50% -c 25%
Users: /.../check_users -w 10 -c 15
Der Aufbau entspricht einer INI-Datei, wie sie von Windows und diversen UNIX-Tools bekannt sein sollte. Abschnitte ("Sections") werden durch in eckige Klammern eingeschlossene Begriffe eingeleitet, d.h. obige Datei enthält die Abschnitte "nagixsc", "host1" und "host2". Die Reihenfolge spielt hierbei keine Rolle.
Abschnitt "nagixsc"¶
Der Abschnitt "nagixsc" kann im einfachen Fall komplett entfallen. Alle möglichen Parameter finden sich auf der Seite zu den conf-Dateien.
Abschnitt "host1"¶
Der Abschnittsname "host1" deutet bereits darauf hin, dass hier die Checks/Services für den Rechner "host1" des Nagios definiert werden. Alle in diesem Abschnitt angegebenen Checks/Services tragen später in der XML-Struktur diesen Hostnamen.
Das einfache zuerst: Für den Host werden drei Checks/Services definiert: "Disk_Home", "Disk_Root" und "Load" (Groß-/Kleinschreibung beachten!). Die Syntax gleicht weiterhin der von NRPE.
Die ersten drei Zeilen beginnen mit einem Unterstrich/Underscore/"_". Sie haben innerhalb von Nag(ix)SC bzw. diesem conf-Datei eine besondere Bedeutung bzw. sind ebenfalls reserviert. Hier wird "_host_check" verwendet, es gibt - wenn vorhanden - an, wie der Host-Check durchgeführt werden soll.
Abschnitt "host2"¶
Der Abschnitt "host2" beginnt gleich mit der zweiten Sonderoption "_host_name". Sie besagt, dass nicht der Abschnittsname als Host-Name für Nagios verwendet werden soll, sondern der hier angegebene. Damit wäre es. z.B. möglich, für einen Host mehrere Abschnitte anzulegen, deren jeweilige Checks/Services nicht alle zur gleichen Zeit ausgeführt werden (alle 5 Minten, alle 15 Minuten, alle Stunde, usw.). Weitere Informationen zu den Filtern findet sich auf der Seite zu "nagixsc_conf2xml".
Die nächsten drei Zeilen definieren wieder Checks/Services, nämlich "Procs_Total", "Swap" und "Users".
Je Abschnitt können natürlich beliebig viele Checks/Services eingetragen werden, eine Unterteilung mit Hilfe von Abschnitten kann aber hilfreich sein.