OSMC 2009 | Entwicklung von Nagios-Plugins mit Net::SNMP und Nagios::Plugin by Martin Hefter

Entwicklung von Nagios-Plugins mit
Net::SNMP und Nagios::Plugin
Plugins prima selbst gemacht
Martin Hefter
Schenker Deutschland AG
N¨urnberg, 28. - 29. Oktober 2009

Einf¨uhrung Nagios::Plugin Net::SNMP Beispiel Ende
Neuer Abschnitt
1 Einf¨uhrung
2 Nagios::Plugin
3 Net::SNMP
4 Beispiel
5 Ende
M. Hefter - OSMC 2009 Plugins mit Net::SNMP und Nagios::Plugins 2 von 40

Zur Person
Erfahrungen mit Nagios seit 2004
Planung und Umsetzung der Nagios-Überwachung für das Hess.
Landesamt für Bodenmanagement und Geoinformation (früher
Hess. Landesvermessungsamt)
Weitere kleine Projekte und Diplomarbeit zum Thema
”
Überwachen von Geschäftsprozessen mit Nagios“
Nagios-Plugins
Pluginpack zur Überwachung von Fujitsu(-Siemens-) Hardware
check power fsc
check fans fsc
check temp fsc
check systemhealth fsc
check raid fsc
Plugin zur Überwachung von USV-Systemen der Firma APC
check ups apc

Zielsetzung
Ziel dieses Vortrags
Dieser Vortrag soll einen kurze Einführung in die Verwendung
von Nagios::Plugin und Net::SNMP vermitteln. Es können
leider nicht alle Methoden und Möglichkeiten der beiden
Module behandelt werden. Ausführlichere Informationen zu
den beiden Modulen finden Sie auf der jeweiligen Website.

Agenda
1 Einf¨uhrung
2 Nagios::Plugin
3 Net::SNMP
4 Beispiel
5 Ende

Neuer Abschnitt
1 Einf¨uhrung
2 Nagios::Plugin
3 Net::SNMP
4 Beispiel
5 Ende

Installation
Installation von Nagios::Plugin
Beim Kompilieren der Nagios-Plugins ab Version 1.4.11 kann
das Perl Modul Nagios::Plugin mit ¨ubersetzt werden.
Kompilieren aus dem Sourcecode
./configure --enable-perl-modules
Alternativ
http://www.cpan.org/

Einbinden von Nagios::Plugin
Einbinden von Nagios::Plugin
use FindBin
use lib "$FindBin ::Bin /../ perl/lib";
use Nagios :: Plugin;
Weitere Informationen zu Nagios::Plugin
http://search.cpan.org/~tonvoon/Nagios-Plugin-0.
33/lib/Nagios/Plugin.pm

Objekt erzeugen
Objekt erzeugen
Das Nagios-Plugin-Objekt kapselt die wichtigsten Funktion f¨ur
ein Nagios-Plugin.
Beispiel Aufruf des Konstuktors
$np = Nagios ::Plugin ->new(
usage => "Usage: %s [-H <host >]"
shortname => "USV");

Objekt erzeugen
Beispiel Aufruf des Konstrutors
$np = Nagios ::Plugin ->new(
usage => "Usage: %s [-H <host >]"
shortname => "USV");
Hinweis
Wenn das Argument usage verwendet wird, wird automatisch
eine Instanz von Nagios::Plugin::Getopt zur Verarbeitung von
Kommandozeilen-Argumenten erzeugt.

Kommandozeilen-Argumente hinzuf¨ugen
add_arg
F¨ugt dem Plugin ein Kommandozeilen-Argument hinzu.
Beispiel Aufruf add_arg
$np ->add_arg(
spec => ’hostname|H=s’,
help => "-H, --hostname (Hostname or IP Address)");

Kommandozeilen-Argumente auswerten
getopts
Überprüft die Kommandozeilen-Argumente auf Vollständigkeit
und stellt sie für den Zugriff bereit.
Zugriff auf Kommandozeilen-Argumente
$np ->getopts;
$hostname = $np ->opts ->hostname;

Warnschwellen und Bereiche
Erzeugt einen Alarm wenn X...
Bereich Bemerkung
10 < 0 oder > 10 (Außerhalb des Bereiches [0 . . . 10])
10: < 10, (Außerhalb des Bereiches [10 . . . ∞])
∼:10 > 10, (Außerhalb des Bereiches [-∞ . . . 10])
10:20 < 10 or > 20, (Außerhalb des Bereiches [10 . . . 20])
@10:20 ≥ 10 and ≤ 20, (Innerhalb des Bereiches 10 . . . 20)

Temperaturmessung im Serverraum
Bereichsdeﬁnition
Warning 19:21
Critical 18:22

set_thresholds
Legt die Grenzwerte für die Überprüfung eines Wertes fest.
Beispiel Aufruf set_thresholds
$np -> set_thresholds (
warning => $warning ,
critical => $critical );

check_thresholds
Vergleicht den ¨ubergebenen Wert mit den festgelegten
Grenzwerten und generiert den entsprechenden R¨uckgabewert
OK, Warning oder Critical.
Beispiel Aufruf check_thresholds
$code = $np -> check_threshold ($runtime );

Nachrichten
add_message
Fügt eine Nachricht der entsprechenden Queue hinzu. Es wird
jeweils eine eigene Queue für OK, Warning und Critical
geführt.
Beispiel Aufruf add_message (1/2)
$np -> add_message(’OK’,"Everything is all right");

Nachrichten
Beispiel Aufruf add_message (1/2)
$np -> add_message(’OK’,"Everything is all right");
Beispiel Aufruf add_message mit check thresholds (2/2)
$np -> add_message( check_thresholds ($runtime),
"Battery Runtime is $runtime");

Nachrichten
check_message
Überprüft die Nachrichten Queues und gibt die letzte
Nachricht der Queue mit der höchsten Priorität zurück.
1 Critical
2 Warning
3 OK
Mit den Parametern join und join_all können auch alle
Queues zurückgeben werden.
check_message (1/2) Eine Queue
($code , $message) = $np -> check_messages ();

Nachrichten
check_message (1/2) Eine Queue
($code , $message) = $np -> check_messages ();
check_message (2/2) Alle Queues
($code , $message) = $np -> check_messages (
join => "<BR >",
join_all => "<BR >");

Performance Daten
add_perfdata
F¨ugt den Performance-Daten einen Wert hinzu.
Beispiel Aufruf add_perfdata
$np -> add_perfdata (
label => "batCapacity",
value => $batteryCapacity ,
threshold => $capacityThreshold ,
uom => "%",
min => 0,
max => 100);

Exit-Methoden (1/2)
nagios_exit
Beendet das Skript mit einer Nachricht und einem
R¨uckgabewert.
Beispiel Aufruf nagios_exit
$np -> nagios_exit(
return_code => OK ,
message => "Everything is alright");
Hinweis
Diese Methode sollte verwendet werden, um das Plugin regul¨ar
zu beenden.

Exit-Methoden (2/2)
nagios_die
Beendet das Skript mit einer Nachricht und dem R¨uckgabewert
Unknown. Das Argument return_code ist hier optional.
Beispiel Aufruf nagios_die
$np ->nagios_die(
message => "Unable to open SNMP connection");
Hinweis
Diese Methode sollte verwendet werden, um das Plugin bei
einem Fehler zu beenden.

Neuer Abschnitt
1 Einf¨uhrung
2 Nagios::Plugin
3 Net::SNMP
4 Beispiel
5 Ende

SNMP
SNMP Tree
Managed Objects
Die Managed Objects werden durch einen eindeutigen Object
Identiﬁer (OID) identiﬁziert. Die OID beschreibt den Weg durch den
Baum zum Managed Object.

Management Information Base
Management Information Base (MIB)
Die MIB beschreibt die Informationen, die ¨uber SNMP abgefragt
werden k¨onnen.
Beispiel OID
.1.3.6.1.4.1.318.1.1.1.2.2.3.0 = 72000
Beispiel MIB
upsAdvBatteryRunTimeRemaining OBJECT -TYPE
SYNTAX TimeTicks
ACCESS read -only
STATUS mandatory
DESCRIPTION
"The UPS battery run time remaining before battery exhaustion."
::= { upsAdvBattery 3 }

N¨utzliche Hilfsmittel
Kommandozeilen-Tools
snmpget
snmpwalk
Websites (MIB-Browser)
http://support.ipmonitor.com/snmp_center.aspx
http://www.oidview.com/mibs/detail.html
uvm.

Installation
Installation von Net::SNMP
Die meisten Linux-Distributionen liefern bereits fertige Pakete
f¨ur Net::SNMP mit.
Installation unter Debian
apt-get install libsnmp-perl
Alternativ (Sourcecode)
http://net-snmp.sourceforge.net
http://www.cpan.org/

Einbinden von Net::SNMP
Einbinden von Net::SNMP
use Net::SNMP
Weitere Informationen zu Net::SNMP:
http://search.cpan.org/~dtown/Net-SNMP-v6.0.0/
lib/Net/SNMP.pm

Verbindung aufnehmen
Verbindung aufnehmen
Das Session-Objekt regelt die Verbindung zwischen dem Client
und dem SNMP-Agenten
Beispiel Session-Objekt erzeugen
($session ,$error) = Net::SNMP ->session(
-hostname => $host ,
-community => $community ,
-port => $snmp_port ,
-version => $snmp_version );

Anfragen stellen
Eine OID abfragen
Mit get_request() lassen sich eine oder mehere OIDs vom
Agenten abfragen. Entspricht der Funktion von snmpget auf
der Kommandozeile.
Beispiel get_request()
$timeOnBattery = " 1.3.6.1.4.1.318.1.1.1.2.1.2.0 ";
$lineFailCause = " 1.3.6.1.4.1.318.1.1.1.3.2.5.0 ";
push(@snmpoids , $timeOnBattery );
push(@snmpoids , $lineFailCause );
$result = $session ->get_request(varbindlist => @snmpoids );

Anfragen stellen
Einen OID Baum abfragen
Mit get_table() kann ein ganzer OID-Baum abgefragt
werden. Entspricht der Funktion von snmpwalk auf der
Kommandozeile.
Beispiel get_table()
$physicalDev = " 1.3.6.1.4.1.231.2.49.1.5.2.1.3 ";
$devTable = $session ->get_table(baseoid => $physicalDev );

Anfragen stellen
Hinweis
Die Abfrageergebnisse von get_table() k¨onnen sehr
umfangreich ausfallen, wenn ein Knoten nahe an der Wurzel
gew¨ahlt wird.
Hinweis
Net::SNMP bietet noch weitere Methoden um Abfragen zu
stellen z.B. get_entries() und get_bulk_request().
Damit lassen sich die Abfragen weiter optimieren. Allerdings
setzt dies mindestens SNMP Version 2 voraus.

Ergebnisse auswerten
Abfrage Ergebnisse
Die Methoden get_request() und get_table() liefern
jeweils eine Referenz auf einen HASH zurück, der sich aus der
OID als Schlüssel dem dazugehörigen Wert zusammensetzt.
Beispiel (1/2) Zugriff auf einen einzelnen Wert
$timeOnBatteryOID = " 1.3.6.1.4.1.318.1.1.1.2.1.2.0 ";
push(@snmpoids , $timeOnBatteryOID );
$timeOnBattery = $result ->{ $timeOnBatteryOID };

Beispiel (1/2) Zugriﬀ auf einen einzelnen Wert
$timeOnBatteryOID = " 1.3.6.1.4.1.318.1.1.1.2.1.2.0 ";
push(@snmpoids , $timeOnBatteryOID );
$timeOnBattery = $result ->{ $timeOnBatteryOID };
Beispiel (2/2) Zugriﬀ auf alle Werte
$physicalDevOID = " 1.3.6.1.4.1.231.2.49.1.5.2.1.3 ";
$devTable = $session ->get_table(baseoid => $physicalDevOID );
foreach my $oid (sort(keys (%{ $devTable }))) {
$dev = $devTable ->{$oid };
}

Beispiel (2/2) Zugriﬀ auf alle Werte
$physicalDevOID = " 1.3.6.1.4.1.231.2.49.1.5.2.1.3 ";
$devTable = $session ->get_table(baseoid => $physicalDevOID );
foreach my $oid (sort(keys (%{ $devTable }))) {
$dev = $devTable ->{$oid };
}
Hinweis
Nicht vergessen nach Beendigung der Abfragen die Verbindung
mit session->close() explizit zu schließen.

Neuer Abschnitt
1 Einf¨uhrung
2 Nagios::Plugin
3 Net::SNMP
4 Beispiel
5 Ende

Beispiel
Beispiel

Neuer Abschnitt
1 Einf¨uhrung
2 Nagios::Plugin
3 Net::SNMP
4 Beispiel
5 Ende

Ende
Fragen?
Sie brauchen ein neues Nagios Plugin,
haben aber keine Zeit selber zu programmieren?
Gerne erstelle ich Ihnen ein Angebot.
info@martinhefter.de
- Nagios Consulting -
- Softwareentwicklung -
Slides TEXed with LATEX-Beamer

OSMC 2009 | Entwicklung von Nagios-Plugins mit Net::SNMP und Nagios::Plugin by Martin Hefter

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Ähnlich wie OSMC 2009 | Entwicklung von Nagios-Plugins mit Net::SNMP und Nagios::Plugin by Martin Hefter

Ähnlich wie OSMC 2009 | Entwicklung von Nagios-Plugins mit Net::SNMP und Nagios::Plugin by Martin Hefter (20)

OSMC 2009 | Entwicklung von Nagios-Plugins mit Net::SNMP und Nagios::Plugin by Martin Hefter