PNP4Nagios Workshop Daten verarbeiten Das Web Frontend check oracle health. PNP4Nagios Workshop. Jörg Linge

Transkript

1 PNP4Nagios Workshop Jörg Linge 3. Netways Nagios Konferenz, in Nürnberg

2 1 PNP4Nagios Workshop Ablauf und Zeitplan VMware Image Anforderungen 2 Daten verarbeiten Die Kunst Daten zu sammeln WORKSHOP 3 Das Web Frontend Grundlagen Templates Custom Templates XML Files Template Aufbau WORKSHOP 4 check oracle health check oracle health WORKSHOP Diskussion

3 Ablauf Zeitplan Vorstellung der Arbeitsweise von PNP Gemeinsames einrichten von PNP im Workshop System Pause Web Frontend und Darstellung der Graphen Einblick in die Internas von PNP Pause Real Live Szenario am Beispiel von check oracle health Einbinden neuer Templates Erfahrungsaustausch

4 PNP Das Workshop System Basis Debian 4r4 Nagios PNP SVN REVISION 512 ( PNP ) Plugins check multi +check snmp int

5 PNP Das Workshop System User: nagios Passwort: nagios Soucen: /usr/local/src Nagios: /usr/local/nagios Nagios Webfrontend User: nagiosadmin Passwort: nagios

6 Anforderungen Anforderungen Nagios 2.x oder 3.x PHP 4.3+ für das Webinterface GD und zlib Unterstützung für PHP Perl 5.x ohne spezielle Module RRDtool Plugins die gültige Performance Daten liefern Hinweis RRDtool sollte in der Version 1.2x verwendet werden

7 Der Aufbau der Performance Daten Performance Daten Die Ausgabe der Nagios Plugins ist bis Nagios 2.x auf eine Zeile begrenzt. Der Ausgabe wiederum wird durch das Pipe Zeichen in zwei Teile zerlegt. Ausgabe von check users USERS OK - 6 users currently logged in users=6;20;50;0 Zerlegt in Output und Perfdata Output= USERS OK - 6 users currently logged in Perfdata= users=6;20;50;0

8 Der Aufbau der Performance Daten Performance Daten Die Ausgabe der Nagios Plugins ist bis Nagios 2.x auf eine Zeile begrenzt. Der Ausgabe wiederum wird durch das Pipe Zeichen in zwei Teile zerlegt. Ausgabe von check users USERS OK - 6 users currently logged in users=6;20;50;0 Zerlegt in Output und Perfdata Output= USERS OK - 6 users currently logged in Perfdata= users=6;20;50;0

9 Der Aufbau der Performance Daten Performance Daten Die Ausgabe der Nagios Plugins ist bis Nagios 2.x auf eine Zeile begrenzt. Der Ausgabe wiederum wird durch das Pipe Zeichen in zwei Teile zerlegt. Ausgabe von check users USERS OK - 6 users currently logged in users=6;20;50;0 Zerlegt in Output und Perfdata Output= USERS OK - 6 users currently logged in Perfdata= users=6;20;50;0

10 PNP Download Stable Versions Die jeweils aktuelle Version auf SourceForge.net Developer Snapshot Täglicher Developer Snapshot als pnp-latest.tar.gz Changelog Das Changlog wird zusammen mit dem Developer Snapshot aus dem SVN Repository erzeugt und ist ebenfalls auf zu finden.

11 Installation Dreisatz./configure make all make install Hinweis./configure --help liefert weitere Informationen.

12 Installation Dreisatz./configure make all make install Hinweis./configure --help liefert weitere Informationen.

13 1 PNP4Nagios Workshop Ablauf und Zeitplan VMware Image Anforderungen 2 Daten verarbeiten Die Kunst Daten zu sammeln WORKSHOP 3 Das Web Frontend Grundlagen Templates Custom Templates XML Files Template Aufbau WORKSHOP 4 check oracle health check oracle health WORKSHOP Diskussion

14 3 Modi 3 Modi PNP kennt 3 verschieden Arten Performance Daten zu verarbeiten Welcher Mode passt zu mir? Wird bestimmt durch die Größe der Installation und der verwendeten Hardware Von furchtbar einfach bis einfach Details folgen

15 3 Modi 3 Modi PNP kennt 3 verschieden Arten Performance Daten zu verarbeiten Welcher Mode passt zu mir? Wird bestimmt durch die Größe der Installation und der verwendeten Hardware Von furchtbar einfach bis einfach Details folgen

16 Default Mode Default Mode Einfach und schnell eingerichtet Vorteil Sehr wenig Konfiguration Daten/Graphen stehen sofort nach jedem Check zur Verfügung Nachteil Für jeden Check ein Aufruf von process perfdata.pl Blocking! Viele Systemcalls

17 Default Mode Default Mode Einfach und schnell eingerichtet Vorteil Sehr wenig Konfiguration Daten/Graphen stehen sofort nach jedem Check zur Verfügung Nachteil Für jeden Check ein Aufruf von process perfdata.pl Blocking! Viele Systemcalls

18 Modes Bulk Mode Auch einfach aber verbraucht weniger Resourcen Vorteil Weniger Systemcalls als der Default Mode Daten werden gesammelt und im Block abgearbeitet Nachteil Verzögerung der Verarbeitung durch sammeln der Daten Blocking während der Laufzeit von process perfdata.pl! Etwas aufwändigere Konfiguration

19 Modes Bulk Mode Auch einfach aber verbraucht weniger Resourcen Vorteil Weniger Systemcalls als der Default Mode Daten werden gesammelt und im Block abgearbeitet Nachteil Verzögerung der Verarbeitung durch sammeln der Daten Blocking während der Laufzeit von process perfdata.pl! Etwas aufwändigere Konfiguration

20 Modes Bulk Mode mit NPCD Auch nicht schwer aber noch schneller Vorteil Komplett von Nagios entkoppelt. Daher keine Belastung für den Nagios Core Daten werden in ein Spool Verzeichnis kopiert und im Block abgearbeitet Nachteil Verzögerung der Verarbeitung durch sammeln der Daten Ein zusätzlicher Dienst, der NPCD, muss laufen Etwas aufwändigere Konfiguration

21 Modes Bulk Mode mit NPCD Auch nicht schwer aber noch schneller Vorteil Komplett von Nagios entkoppelt. Daher keine Belastung für den Nagios Core Daten werden in ein Spool Verzeichnis kopiert und im Block abgearbeitet Nachteil Verzögerung der Verarbeitung durch sammeln der Daten Ein zusätzlicher Dienst, der NPCD, muss laufen Etwas aufwändigere Konfiguration

22 Modes Workshop Probieren wir einfach mal alle durch und machen uns ein Bild. Das Workshop System ist bereis vorbereitet. Die nagios.cfg enthällt auskommentierte Blöcke für die einzelnen Modi.

23 Modes 30 Minuten Zeit Ziel ist alle 3 Modi gemeinsam nacheinenader in Betrieb zu nehmen Durch Analyse der PNP Logfiles die Arbeitsweise von PNP genauer kennenlernen Unterstützende Doku unter

24 Modes Pause 15 Minuten Pause

25 1 PNP4Nagios Workshop Ablauf und Zeitplan VMware Image Anforderungen 2 Daten verarbeiten Die Kunst Daten zu sammeln WORKSHOP 3 Das Web Frontend Grundlagen Templates Custom Templates XML Files Template Aufbau WORKSHOP 4 check oracle health check oracle health WORKSHOP Diskussion

26 Action URL Action URL Hosts und Services werden über die action url oder notes url mit PNP verknüpft Ab Nagios 3.x nicht mehr über die extinfo Definition sondern direkt im Host oder Service Object Minimierung der Konfiguration durch Templates

27 Aufbau der URLs Alle Services eines Hosts pnp/index.php?host=$hostname$ Alle Graphen eines Services pnp/index.php?host=$hostname$&srv=$servicedesc$ Die erste Page pnp/index.php?page Eine Page mit bestimmter Config. pnp/index.php?page=webserver traffic

28 PNP Templates PNP Templates Templates bestimmen das Aussehen der Graphen und somit den Aufruf von RRDtool. Zuordnung der Templates Ein Template wird immer über das von Nagios verwendete check command bestimmt. Daten die über das Plugin check http und somit über das Check Command check http übermittelt wurden, werden somit über das Template check http.php dargestellt.

29 PNP Templates PNP Templates Templates bestimmen das Aussehen der Graphen und somit den Aufruf von RRDtool. Zuordnung der Templates Ein Template wird immer über das von Nagios verwendete check command bestimmt. Daten die über das Plugin check http und somit über das Check Command check http übermittelt wurden, werden somit über das Template check http.php dargestellt.

30 PNP Templates Speicherort der Templates Templates werden im Verzeichnis share/pnp/templates.dist oder share/pnp/templates gespeichert. Das Verzeichnis share/pnp/templates.dist enthält Templates die im PNP Paket enthalten sind. Hinweis Eigene Templates sollten nur im Verzeichnis share/pnp/templates angelegt werden. So wird verhindert das die Templates bei Updates überschrieben werden.

31 Template Mappings über symbolische links Mapping check command zum Template Templates tragen in der Regel den Namen des zugrundeliegenden Plugins, da der Bezeichnung des Check Commands nicht festgelegt ist. Verknüpfungen können über symbolische Links realisiert werden. So müssen die Templates nicht kopiert werden. Hinweis Wird von PNP kein passendes Template gefunden, wird share/pnp/templates.dist/default.php verwendet.

32 Custom Templates Templates beeinflussen Eventuell muss man auf die Ermittlung der Template Namen Einfluss nehmen. Beispielsweise soll für das Command check nrpe je nach Option ein anderes Template verwendet werden. PNP, oder besser gesagt der Datensammler process perfdata.pl, sucht für jedes Command im Verzeichnis etc/pnp/check commands nach einer.cfg Datei für das aktuelle Check Command und liest diese ein.

33 Custom Templates Beispiel: # check_command check_nrpe!load # 0 # 1 # CUSTOM_TEMPLATE = 0,1 Ergebnis: Über CUSTOM TEMPLATE = 0,1 wird das neue Template aus dem Namen (Feld 0) und dem ersten Argument (Feld 1) zusammengestellt. PNP wird nun das Template check nrpe LOAD.php verwenden.

34 Custom Templates Beispiel: # check_command check_nrpe!load # 0 # 1 # CUSTOM_TEMPLATE = 0,1 Ergebnis: Über CUSTOM TEMPLATE = 0,1 wird das neue Template aus dem Namen (Feld 0) und dem ersten Argument (Feld 1) zusammengestellt. PNP wird nun das Template check nrpe LOAD.php verwenden.

35 XML Files XML Files Zu jedem Service erstellt PNP eine RRD Datenbank. Zusätzlich werden alle zur Laufzeit ermittelten Informationen in einem XML File gespeichert. Das XML File wird bei jedem Update neu geschrieben. Änderungen sind somit von kurzer Dauer.

36 Beispiel DATASOURCE Block <NAGIOS> <DATASOURCE> <TEMPLATE>check_local_users</TEMPLATE> <DS>1</DS> <NAME>users</NAME> <UNIT></UNIT> <ACT>3</ACT> <WARN>2</WARN> <WARN_MIN></WARN_MIN> <WARN_MAX></WARN_MAX> <WARN_RANGE_TYPE></WARN_RANGE_TYPE> <CRIT>5</CRIT> <CRIT_MIN></CRIT_MIN> <CRIT_MAX></CRIT_MAX> <CRIT_RANGE_TYPE></CRIT_RANGE_TYPE> <MIN>0</MIN> <MAX></MAX> </DATASOURCE>... </NAGIOS>

37 DATASOURCE Block DATASOURCE Block Im Bereich DATASOURCE befinden sich Informationen die aus den Performacedaten ermittelt wurden. Der Block wiederholt sich für jede Datenreihe. Die Daten aus den XML Files stehen in PNP Templates zur Verfügung. Daten aus den Tag WARN der ersten Datenreihe stehen somit in dr Variable $WARN[1]

38 RRD Block RRD Block <NAGIOS>... <RRD> <RC>0</RC> <TXT>successful updated</txt> </RRD>... </NAGIOS>

39 RRD Block RRD Block Im Bereich RRD wir der Status des letzten rrdtool Aufrufs gespeichert Ein Returncode größer 0 deutet auf Fehler hin. Beim Einsatz der RRDs Perl Module ist die Beschreibung des Fehlers genauer. Kann verwendet werden um fehlerhafte RRD Strukturen zu finden.

40 Nagios Environment Block Nagios Environment Block <NAGIOS>... <NAGIOS_DATATYPE>SERVICEPERFDATA</NAGIOS_DATATYPE> <NAGIOS_HOSTNAME>localhost</NAGIOS_HOSTNAME> <NAGIOS_HOSTSTATE>UP</NAGIOS_HOSTSTATE> <NAGIOS_HOSTSTATETYPE>HARD</NAGIOS_HOSTSTATETYPE> <NAGIOS_SERVICECHECKCOMMAND>check_http</NAGIOS_SERVICECHECKCOMMAND> <NAGIOS_SERVICEDESC>HTTP</NAGIOS_SERVICEDESC> <NAGIOS_SERVICEPERFDATA> time= s;;; size=576b;;;0 </NAGIOS_SERVICEPERFDATA> <NAGIOS_SERVICESTATE>OK</NAGIOS_SERVICESTATE> <NAGIOS_SERVICESTATETYPE>HARD</NAGIOS_SERVICESTATETYPE> <NAGIOS_TIMET> </NAGIOS_TIMET> </NAGIOS>

41 Nagios Environment Block Nagios Environment Block Wird PNP im Default Mode betrieben, so wird das gesamte Nagios Environment im XML File gespeichert. Die einzelnen Objekte sind unter ihrem Makro Namen als PHP Variable verfügbar. Im Bulk Mode sind nur die Makros im XML enthalten, die über service perfdata file template oder host perfdata file template definiert wurden. Beide Optionen sind jedoch beliebig erweiterbar.

42 PNP Templates Template Aufbau Templates befüllen 2 Arrays mit allen nötigen Optionen die zum Aufruf von rrdtool nötig sind. Alle für die installierte RRDtool Version gültigen Optionen dürfen verwendet werden. Templates bestehen aus den Arrays $opt[] und $def[]. Für jeden Array Key wird ein einzelner RRD Graph erstellt. Enthalten beide Arrays mehrere Datensätze spricht man von Multigraphen.

43 PNP Templates Template Aufbau Templates befüllen 2 Arrays mit allen nötigen Optionen die zum Aufruf von rrdtool nötig sind. Alle für die installierte RRDtool Version gültigen Optionen dürfen verwendet werden. Templates bestehen aus den Arrays $opt[] und $def[]. Für jeden Array Key wird ein einzelner RRD Graph erstellt. Enthalten beide Arrays mehrere Datensätze spricht man von Multigraphen.

44 Beispiel Beispiel: <?php $opt[1] = -slope-mode -titel "Ein Beispiel Graph" weitere rrdtool Optionen ; $def[1] = DEF:var1=... ;... $opt[2] = -l 0 -titel "Ein weiterer Graph" weitere rrdtool Optionen ; $def[2] = DEF:var1=... ;...?> Hinweis Unbedingt auf die korrekte PHP Syntax achten!

45 Beispiel Beispiel: <?php $opt[1] = -slope-mode -titel "Ein Beispiel Graph" weitere rrdtool Optionen ; $def[1] = DEF:var1=... ;... $opt[2] = -l 0 -titel "Ein weiterer Graph" weitere rrdtool Optionen ; $def[2] = DEF:var1=... ;...?> Hinweis Unbedingt auf die korrekte PHP Syntax achten!

46 Templates 30 Minuten Zeit Ziel ist den einzelnen Services Templates zuzuweisen. Analyse der XML Files und der enthaltenen Daten. Unterstützende Doku unter

47 Pause 2 Pause 15 Minuten Pause

48 1 PNP4Nagios Workshop Ablauf und Zeitplan VMware Image Anforderungen 2 Daten verarbeiten Die Kunst Daten zu sammeln WORKSHOP 3 Das Web Frontend Grundlagen Templates Custom Templates XML Files Template Aufbau WORKSHOP 4 check oracle health check oracle health WORKSHOP Diskussion

49 Oracle Daten Visualisieren Aufgabenstellung Integration neuer Templates am Beispiel von check oracle health Das Workshop System enthält bereits einige Oracle Hosts und Services Die Daten stammen aus einer Oracle Datenbank und wurden von Gerhard Lausser, dem Entwickler von check oracle health bereitgestellt Ziel ist es die passenden Templates zu installieren und den einzelnen Services zuzuordnen

50 Oracle Daten Visualisieren PNP Update auf SVN REV 516 Die Templates sind in PNP am SVN Revision 516 enthalten. Die PNP Devel Version von laden Das Update erfolgt mit den gleichen Optionen wie die Installation

51 Oracle Daten Visualisieren Oracle Templates zuweisen Templates aus dem PNP Paket sind in share/pnp/templates.dist zu finden Template Name aus dem XML ermitteln Symbolische Links anlegen

52 Oracle Daten Visualisieren Vorhandene Temlates Template check oracle connection-time.php Template check oracle pga-in-memory-sort-ratio.php Template check oracle redo-io-traffic.php Template check oracle switch-interval.php

53 Oracle Daten Visualisieren Übersicht erstellen Übersicht der ora redo-io Services aller Oracle Server erstellen Page Config in etc/pnp/pages erstellen

54 Templates 15 Minuten Zeit Ziel ist ein PNP Update durchzuführen und die Oracle Graphen einzubinden Unterschiedliche Pages für die Oracle Graphen erstellen Unterstützende Dokumentation unter

55 Offene Diskussion Offene Diskussion Anregungen für zukünftige PNP Versionen? Noch offene Fragen?

56 Danke Danke Vielen Dank für Ihre Aufmerksamkeit! Fragen und Anregungen? Support Mailingliste PNP Forum unter