OSMC 2008 | PNP4Nagios - Installation, Konfiguration und Template Erstellung by Jörg Linge

PNP4Nagios Workshop Daten verarbeiten Das Web Frontend check oracle health
PNP4Nagios Workshop
J¨org Linge
3. Netways Nagios Konferenz, 12.9.2008 in N¨urnberg

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

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

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

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

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

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

PNP Download
Stable Versions
Die jeweils aktuelle Version auf SourceForge.net
http://sourceforge.net/projects/pnp4nagios
Developer Snapshot
T¨aglicher Developer Snapshot als pnp-latest.tar.gz
http://www.pnp4nagios.org/pnp/dwnld
Changelog
Das Changlog wird zusammen mit dem Developer Snapshot aus dem
SVN Repository erzeugt und ist ebenfalls auf
http://www.pnp4nagios.org/pnp/dwnld zu ﬁnden.

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

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

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

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

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

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.

Modes
30 Minuten Zeit
Ziel ist alle 3 Modi gemeinsam nacheinenader in Betrieb zu
nehmen
Durch Analyse der PNP Logﬁles die Arbeitsweise von PNP
genauer kennenlernen
Unterst¨utzende Doku unter
http://www.pnp4nagios.org/pnp/de/config

Modes
Pause
15 Minuten Pause

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

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 Conﬁg.
pnp/index.php?page=webserver traffic

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.

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¨alt 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
¨uberschrieben werden.

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.

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.

Custom Templates
Beispiel:
# check_command check_nrpe!LOAD
# ________0__________| |
# ________1__________________|
#
CUSTOM_TEMPLATE = 0,1
Ergebnis:
¨Uber 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.

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

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>

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]

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

RRD Block
RRD Block
Im Bereich RRD wir der Status des letzten rrdtool Aufrufs
gespeichert
Ein Returncode gr¨oß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
ﬁnden.

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=0.007855s;;;0.000000 size=576B;;;0
</NAGIOS_SERVICEPERFDATA>
<NAGIOS_SERVICESTATE>OK</NAGIOS_SERVICESTATE>
<NAGIOS_SERVICESTATETYPE>HARD</NAGIOS_SERVICESTATETYPE>
<NAGIOS_TIMET>1212195208</NAGIOS_TIMET>
</NAGIOS>

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.

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.

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!

Templates
30 Minuten Zeit
Ziel ist den einzelnen Services Templates zuzuweisen.
Analyse der XML Files und der enthaltenen Daten.
Unterst¨utzende Doku unter
http://www.pnp4nagios.org/pnp/de/tpl

Pause 2
Pause
15 Minuten Pause

Oracle Daten Visualisieren
Aufgabenstellung
Integration neuer Templates am Beispiel von
check oracle health
Das Workshop System enth¨alt 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

PNP Update auf SVN REV 516
Die Templates sind in PNP am SVN Revision 516 enthalten.
Die PNP Devel Version von
http://www.pnp4nagios.org/pnp/dwnld laden
Das Update erfolgt mit den gleichen Optionen wie die Installation

Oracle Templates zuweisen
Templates aus dem PNP Paket sind in share/pnp/templates.dist
zu ﬁnden
Template Name aus dem XML ermitteln
Symbolische Links anlegen

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

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

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
http://www.pnp4nagios.org/pnp/de/pages

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

Danke
Danke
Vielen Dank f¨ur Ihre Aufmerksamkeit!
Fragen und Anregungen ?
Support
Mailingliste pnp4nagios-user@sourceforge.net
PNP Forum unter http://www.nagios-portal.org

OSMC 2008 | PNP4Nagios - Installation, Konfiguration und Template Erstellung by Jörg Linge

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Ähnlich wie OSMC 2008 | PNP4Nagios - Installation, Konfiguration und Template Erstellung by Jörg Linge

Ähnlich wie OSMC 2008 | PNP4Nagios - Installation, Konfiguration und Template Erstellung by Jörg Linge (20)

Kürzlich hochgeladen

Kürzlich hochgeladen (6)

OSMC 2008 | PNP4Nagios - Installation, Konfiguration und Template Erstellung by Jörg Linge