Icinga Teil 2. Andreas Teuchert. 25. Juli 2014

Transkript

1 Icinga Teil 2 Andreas Teuchert 25. Juli

2 Nagios-Plugins Programme, die den Status von Diensten überprüfen können liegen in /usr/lib/nagios/plugins/ werden von Icinga aufgerufen, geben Status über Exit-Status zurück 0: OK, 1: WARNING, 2: CRITICAL detailierte Ausgabe auf der Standard-Ausgabe über Optionen/Argumente anpassbar Hilfe: Plugin mit Option -h aufrufen Andreas Teuchert Icinga Teil Juli / 12 Nagios-Plugins sind normale ausführbare Programme, die üblicherweise im Verzeichnis /usr/lib/nagios/plugins/ zu finden sind. Beim Aufruf durch Icinga wird der Zustand des abgefragten Dienstes über den Exit-Status zurückgegeben. Die auf der Standardausgabe ausgegebenen Meldungen dienen zur Erläuterung des Status und werden ebenfalls im Webinterface angezeigt. Zum Testen können die Plugins auch von Hand aufgerufen werden. Üblicherweise kann durch Angabe der Option -h ein Hilfetext angezeigt werden, der die Optionen und Argumente des Plugins erläutert. Je nach Plugin kann es eine Vielzahl an Optionen geben mit denen das Verhalten des Plugins beeinflusst werden kann. 2

3 Plugins Bezugsquellen Pakete: nagios-plugins-{basic,standard,contrib} selbst schreiben: z. B. als einfaches Skript Andreas Teuchert Icinga Teil Juli / 12 Neben den über das Paketsystem installierbaren oder bei der Icinga- Installation bereits mitinstallierten Plugins können auf dafür spezialisierten Webseiten wie Nagios-Exchange oder Monitoring-Exchange eine Vielzahl von weiteren Plugins aufgefunden werden. Da es sich meistens um Skripte handelt, können diese einfach heruntergeladen und auf den Icinga-Rechner kopiert werden. Es ist ebenfalls sehr leicht möglich, eigene Plugins als Skripte zu programmieren. Diese müssen lediglich eventuell benötigte Argumente annehmen und den Status über den Exit-Status zurückgeben. 3

4 Eigene Check-Commands definieren 1 define command { 2 command _ name http _ code 3 command _ line $ USER 1$/ check _ http -H $ HOSTADDRESS $ -e " HTTP /1.1 $ ARG 1$" 4 } definiert den Befehl http_code http_code ruft das Plugin check_http auf $HOSTADDRESS$ ist die Adresse des zu überwachenden Rechners durch $ARG1$ kann ein Argument übergeben werden $USER1$ entspricht /usr/lib/nagios/plugins Andreas Teuchert Icinga Teil Juli / 12 Mittels define command können eigene Check-Commands definiert werden. Diese können dann in Service-Definitionen über check_command verwendet werden. Die command_line eines Check-Commands gibt den Befehl an, der von Icinga zum Abfragen des Status aufgerufen wird. Üblicherweise wird hier auf ein Nagios-Plugin verwiesen. Es können hier auch Optionen und Argumente an das Plugin übergeben werden. Die Variable $HOSTADDRESS$ wird beim Ausführen des Befehls durch die Adresse des Hosts, dessen Status abgefragt wird, ersetzt. In der Service-Definition können ebenfalls Argumente angegeben werden. Auf diese kann über $ARG1$ bis $ARG32$ zugegriffen werden. Die Variable $USER1$ ist in /etc/icinga/resource.cfg definiert und dient als Abkürzung für /usr/lib/nagios/plugins. In dieser Datei können auch weitere Variablen definiert werden, z. B. für weitere Verzeichnisse, in denen sich Plugins befinden. In diesem Beispiel wurde ein Check-Command definiert, dass den Status eines Webservers abfragt. Als Argument kann der erwartete Status-Code übergeben werden, sodass auch auf andere Status-Codes als 200 getestet werden kann. Weitere Informationen zu HTTP-Statuscodes: org/wiki/http-statuscode 4

5 Check-Commands verwenden 1 define service { 2 use generic - service 3 host _ name www 1 4 service _ description HTTP check _ command http _ code!301 6 } überprüft, ob der Webserver auf www1 auf Anfragen mit dem HTTP-Statuscode 301 antwortet check_command ruft das Check-Command http_code mit dem Argument 301 auf weitere Argumente durch weitere! viele Commands schon in /etc/nagios-plugins/config/ definiert Andreas Teuchert Icinga Teil Juli / 12 Das eben definierte Check-Command wird hier verwendet um einen Webserver zu überwachen. Der Webserver soll mit dem Statuscode 301 antworten. Das hier nach dem! angegebene Argument wird dem Check-Command als $ARG1$ übergeben. Weitere Argumente können durch weitere! getrennt angegeben werden. Viele Check-Commands sind bereits in /etc/nagios-plugins/config/ nach Plugins geordnet in einzelnen Dateien definiert und können daher direkt in Service-Definitionen verwendet werden. 5

6 Lab: Eigene Check-Commands definieren Check-Command für passwortgeschützte Verzeichnisse über HTTPs definieren passwortgeschütztes Verzeichnis auf Partnerrechner überwachen Andreas Teuchert Icinga Teil Juli / 12 6

7 NRPE Nagios Remote Plugin Executor läuft als Server-Dienst auf einem zu überwachenden Rechner Nagios-Plugins können auf dem Rechner ausgeführt werden z. B. zur Überwachtung von Festplattenbelegung und Systemlast benötigt auf dem Nagios-Server das Paket nagios-nrpe-plugin auf dem zu überwachenden Server: nagios-nrpe-server Andreas Teuchert Icinga Teil Juli / 12 Der Nagios Remote Plugin Executor erlaubt es, Eigenschaften eines Rechners, die nicht direkt über das Netzwerk abgefragt werden können (z. B. Festplattenbelegung) über den NRPE-Dienst abzufragen. Dadurch können auch diese Eigenschaften von einem zentralen Icinga überwacht werden. 7

8 Konfiguration /etc/nagios/nrpe.cfg: Hauptkonfiguration allowed_hosts=... legt fest, von welchen Adressen NRPE Anfragen beantwortet am Ende der Datei sind bereits einige Check-Commands festgelegt Andreas Teuchert Icinga Teil Juli / 12 NRPE wird über die Datei /etc/nagios/nrpe.cfg konfiguriert. Die meisten Einstellungen haben sinnvolle Standardwerte und müssen daher nicht geändert werden. Lediglich die Einstellung allowed_hosts= muss angepasst werden. Dort muss die IP-Adresse des Icinga-Servers eingetragen werden. Andernfalls werden die Anfragen von NRPE abgewiesen. Am Ende der Datei sind bereits einige Check-Commands definiert, die direkt von Icinga abgefragt werden können. 8

9 NRPE-Checks einrichten 1 define command { 2 command _ name nrpe 3 command _ line $ USER 1$/ check _ nrpe -H $ HOSTADDRESS $ -c $ ARG 1$ 4 } 1 define service { 2 use generic - service 3 host _ name ts1 4 contact _ groups ts - admins 5 service _ description Load 6 check _ command nrpe! check _ load 7 } das Check-Command auf dem entfernten Rechner wird über das Argument für nrpe angegeben Andreas Teuchert Icinga Teil Juli / 12 Zum Abfragen des NRPE-Servers wird das Nagios-Plugin check_nrpe benötigt. Über die Option -c wird das Check-Command auf dem NRPE- Server angegeben. In diesem Beispiel können NRPE-Checks ausgeführt werden, indem als Check-Command nrpe angeben wird und das Check-Command auf dem NRPE-Server als Argument übergeben wird. 9

10 Lab: NRPE einrichten Partnerrechner in allowed_hosts eintragen Load und Anzahl der Prozesse auf Partnerrechner überwachen Andreas Teuchert Icinga Teil Juli / 12 10

11 Eigene NRPE-Checks definieren NRPE-Konfiguration: /etc/nagios/nrpe.cfg am Ende schon einige Checks definiert lokale Nagios-Plugins werden aufgerufen Beispiel: 1 command [ check _ users ]=/ usr / lib / nagios / plugins / check _ users -w 5 -c 10 check_users: WARNING bei mehr als 5 eingeloggten Benutzern, CRITICAL bei mehr als 10 Andreas Teuchert Icinga Teil Juli / 12 Neben den bereits standardmäßig vorhandenen Checks können in der NRPE-Konfigurationsdatei weitere Checks werden und dann über Icinga abgefragt werden. Es können hier alle lokal installierten Nagios-Plugins bzw. beliebige Befehle, solange diese den Status über den Exit-Status zurückgeben, verwendet werden. In diesem Beispiel wird das Check-Command check_users definiert, welches das gleichnamige Plugin verwendet um bei mehr als 5 gleichzeitig eingeloggten Benutzern den Status WARNING und bei mehr als 10 gleichzeitig eingeloggten Benutzern den Status CRITICAL zurückzugeben. 11

12 Lab: Festplattenbelegung per NRPE überwachen NRPE-Checks für Festplattenbelegung einrichten Festplattenbelegung auf Partnerrechner überwachen Andreas Teuchert Icinga Teil Juli / 12 12