Nagios-Wiki nagios:plugins

nagios:plugins:allg

Was sind Plugins ? Plugins sind eigenständige Programme die von dem Nagios Deamon lokal auf dem Nagios Server ausgeführt werden. In welcher Programmiersprache ein Plugin geschrieben ist, ist für Nagios nicht wichtig. Hauptsache es lässt sich auf dem Server ausführen und hält sich an die Standards für Plugins.

nagios:plugins:check_breeze

Überprüft via SNMP die Signalstärke eines Breezecom Wireless Gerätes. Usage Usage: check_breeze -H [-C community] -w -c -H, --hostname=HOST Name or IP address of host to check -C, --community=community SNMPv1 community (default public) -w, --warning=INTEGER Percentage strength below which a WARNING status will result -c, --critical=INTEGER Percentage strength below which a CRITICAL status will result

nagios:plugins:check_by_ssh

check_by_ssh kann verwendet werden um lokale Plugins wie check_proc und check_disk via SSH auf einem entferneten Server aufzurufen. SSH bietet sich an, da der SSH Daemon in den meisten Fällen bereits auf den zu überwachenden Servern läuft. Um check_by_ssh verwenden zu können müssen einige grundlegende Vorraussetzungen geschaffen werden.

nagios:plugins:check_clamd

Usage Usage: check_CLAMD -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ] [-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D ] [-S ] [-E] Options: -h, --help Print detailed help screen -V, --version Print version information -H, --hostname=ADDRESS…

nagios:plugins:check_compaq_insight

Also hier die Information zum Plugin, die ich zusammengesucht habe, bzw. von HP erhalten habe: Das Plugin wird zur Überwachung von Compaq Hardware verwendet, es werden die HP Insight Management Agents per SNMP abgefragt! The Insight MIBs conform to the Concise MIB format (see section 3.0) and are suitable for use by most MIB compilers used to assimilate MIB documents. The main portion of the tree with respect to the HP instrumented management information is:

nagios:plugins:check_dig

Usage Usage:check_dig -H host -l lookup [-p ] [-T ] [-w ] [-c ] [-t ] [-a ] [-v] Options: -h, --help Print detailed help screen -V, --version Print version information -H, --hostname=ADDRESS Host name, IP Address, or unix socket (must be an absolute path) -p, --port=INTEGER Port number (default: 53) -l, --lookup=STRING machine name to lookup -T, --record_type=STRING re…

nagios:plugins:check_disk

Dieses Plugin zeigt den benutzen Plattenplatz in Prozent an. Die Parameter für WARNING und CRITICAL sind variabel. localhost etc/services # Service definition define service{ use template-gow-service ; Name of service template to use host_name localhost service_description HDD.root check_command check_local_disk!20%!10%!"/dev/hda2" }

nagios:plugins:check_disk_smb

Mit diesem Plugin ist es möglich Samba Shares abzufragen. Die Dokumentation der möglichen Parameter findet man wenn man das Plugin in der Konsole mit dem Flag --help aufruft. ./check_disk_smb --help Wer die Nagios Version 1.3 als Debian Paket installiert hat kann nun folgendes tun um das Plugin zu nutzen:

nagios:plugins:check_dns

FIXME

nagios:plugins:check_esx_wbem.py

->Keine Garantie auf gültikeit, inkl Plugin funktionalität Download Temporär im Forum History ... Installation Benötigt wird das python pywbem paket Paket installation (ab Debian Squeeze/SID ?) apt-get install python-pywbem Source installation Download von SourceForge

nagios:plugins:check_file_age

Syntax check_file_age -w -c -W -C -f Pfad/Datei Parameter Erkärung -w ab Sec1 Sekunden wir ein WARING ausgegeben -c ab Sec2 Sekunden wir ein CRITICAL ausgegeben -W ab einer Dateigröße von wird ein WARING ausgegeben -C ab einer Dateigröße von wird ein CRITICAL ausgegeben -f Pfad/Datei Die zu prüfende Datei wird hier angegeben Rückgabe auf Textzeile OK - Pfad/Datei is 176 seconds old and 0 bytes

nagios:plugins:check_ftp

Alias von check_tcp. Spezialität: FTP Server prüfen Usage Usage: check_FTP -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ] [-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D ] [-S ] [-E] Options: -h, --help Print detailed help screen -V, --version …

nagios:plugins:check_fw_vrrp

Link zum Download: Das Plugin verwendet SNMP um den VRRP status beider Firewall Nodes zu prüfen, wobei alarmiert wird, wenn nicht ein Node VRRP Master ist und der andere VRRP Backup. Da es sich hierbei um ein simples shell scrip handelt,w elches aufrufe von check_snmp_vrrp.pl durchführt, können nötigenfalls parameter im script eingetragen werden.

nagios:plugins:check_generic

check_generic check_generic ist das Plugin, nach dem man schon immer gesucht, es aber aus irgendwelchen unerfindlichen Gruenden nie selber geschrieben hat ;-) Es kann jeden Befehl und jede beliebige Kommandozeile ausfuehren und vergleicht deren Ergebnisse mit numerischen oder String-Ausdruecken. Erlaubt ist alles, was unter Perl funktioniert. Auch Performance-Daten koennen gesammelt werden.

nagios:plugins:check_http

This plugin will attempt to open an HTTP connection with the host. Successful connects return STATE_OK, refusals and timeouts return STATE_CRITICAL other errors return STATE_UNKNOWN. Successful connects, but incorrect reponse messages from the host result in STATE_WARNING return values. If you are checking a virtual server that uses 'host headers' you must supply the FQDN (fully qualified domain name) as the [host_name] argument. This plugin can also check whether an SSL enabled web serve…

nagios:plugins:check_http_fwb

check_http_fwb is a nagios plugin for checking HTTP. It differs from check_http by missing features which are rarely used, having a small codesize (7 KB statical code, diet-compiled and sstripped) and doing per default only a HEAD request. Usage check_http_fwb -I ip-address -w warnlevel -c critlevel [-p port] [-H http11_hostname] [-u remotefile] [-A user_agent] [-t timeout] [-G] [-D]

nagios:plugins:check_ica_metaframe_pub_apps.pl

Übersicht & Bezug Das Plugin check_ica_metaframe_pub_apps.pl ersetzt das ältere check_ica und dient dazu die Verfügbarkeit der „veröffentlichten Applikationen“ von Citrix Presentation Server, auch als Citrix Metaframe bekannt, zu überprüfen und ist im Contrib Verzeichnis der offiziellen Nagios-Plugins 1.4.2 verfügbar, alternativ hier:

nagios:plugins:check_ica_program_neigbourhood.pl

Übersicht & Bezug Das Plugin check_ica_program_neigbourhood.pl dient, soweit ich das bisher durschaut habe, dazu die veröffentlichten Applikationen auf Verfügbarkeit zu testen. Das Plugin ist im Contrib Verzeichnis der offiziellen Nagios-Plugins 1.4.2 verfügbar, alternativ hier:

nagios:plugins:check_icmp

check_icmp ist von Andreas Ericson entwickelt worden und dient als Ersatz für check_ping. Seit Version 1.4 der Nagios Plugins gehört check_icmp zum Standard dazu. Während check_ping das UnixProgramm /bin/ping aufruft und es daher immer wieder zu Kompatibilitätsproblemen mit der vorhandenen ping Version kommt, versendet check_icmp ICMP Pakete ohne externe Hilfsprogramme.

nagios:plugins:check_logfiles

Mit diesem Plugin ist es möglich, Logdateien auf bestimmte Muster zu untersuchen. Syntax check_logfiles [-t timeout] -f Besonderheiten Die Möglichkeiten der traditionellen Logfile-Plugins (u.a. check_log und check_log2 aus den offiziellen Nagios-Plugins) sind völlig unzureichend für den Einsatz in einem unternehmenskritischen Umfeld. check_logfiles entstand, weil diese Mängel das Aus für die Ablösung eines proprietären Systems durch Nagios bedeutet hätten.

nagios:plugins:check_lotus.pl

Übersicht & Bezug Das Plugin check_lotus.pl dient dazu einen Lotus-Server per SNMP zu überprüfen und ist im Contrib Verzeichnis der offiziellen Nagios-Plugins 1.4.2 verfügbar, alternativ hier:

nagios:plugins:check_multi

check_multi Nagios, wie es jeder kennt Nagios mit check_multi Hier gehts nun wirklich zur Dokumentation von check_multi ;-).

nagios:plugins:check_nt

Mit Hilfe des NSClient++ kann der Windows interne Performance Counter, der Informationen die das lokale System betreffen sammelt und zur Erstellung von Statistiken herangezogen werden kann, abgefragt werden. Hier werden Informationen zur CLIENTVERSION, CPULOAD, UPTIME, MEMUSE, USEDDISKSPACE, SERVICESTATE, PROCSTATE und allen COUNTER des Systems gesammelt und können mit check_nt abgefragt werden.

nagios:plugins:check_ntp

Bemerkung Das Plugin empfiehlt folgende (einfache) Offset-Prüfung: Examples: Simple NTP server check: ./check_ntp_peer -H ntpserv -w 0.5 -c 1 Vorschlag: ./check_ntp_peer -H ntpserv -w ~0.4:0.4 -c ~0.5:0.5

nagios:plugins:check_nwstat

download ab 24.06.2006 unter www.etmiesje.de/plugins auch am 24.06. auf Nagiosplug-devel - Mailingliste verfügbar Das check_nwstat - Plugin gehört mit zum „Lieferumfang“ der Nagios Plugins. Damit das Plugin richtig arbeiten kann, muß auf den Novell Servern ( ab Version 4.11 ) das MRTGEXT.NLM geladen sein.

nagios:plugins:check_procs

check_procs gehört zum Nagios Plugin Packet und dient zum überwachen lokaler Prozesse. Wenn Prozesse auf entferneten Maschinen überwacht werden sollen, so muss NRPE oder check_by_ssh zum Einsatz kommen und das Plugin auf der zu überwachenden Maschine vorhanden sein.

nagios:plugins:check_remote_by_http

check_remote_by_http is a nagios plugin for remote checking hosts by (simplified) http. It was written as a (fast) alternative to net-snmp and it is designed to work with knoerre, a small http-server. check_remote_by_http sends according to the given key a HTTP request to the remote server. Then it expects a value as a result of the remote check. It takes the value from the last line of the remote HTTP response. The value will be interpreted as a positive integer with up to 63 bits. If the remot…

nagios:plugins:check_remote_by_udp

check_remote_by_udp is a nagios plugin for remote checking hosts by udp. It was written as a (fast) alternative to net-snmp and it is designed to work with knoerred, a small and experimental udp-server. check_remote_by_udp sends the given key with a LF to the remote server. Then it expects a value as a result of the remote check. It takes the numeric value from the last line of the remote udp response. The value will be interpreted as a positive integer with up to 64 bits. If the remote value is…

nagios:plugins:check_smb.sh

Installation * Download von check_smb.sh von NagiosExchange.org * Plugin nach /usr/local/nagios/libexec/ kopieren * chown nagios.nagcmd check_smb.sh * chmod 755 check_smb.sh * Anpassung Nagios Konfiguration Nagios Anpassung etc/checkcommand.cfg # 'check_smb' command definition define command{ command_name check_smb command_line $USER1$/check_smb -H $HOSTADDRESS$ }

nagios:plugins:check_snmp

SNMP (Simple Network Management Protocol) Grundlegendes SNMP ist ein Anfrage- und Antwort-Protokoll. Ein Management-System (Nagios) richtet eine Anfrage an einen Agenten. Der SNMP-Agent reagiert auf diese Frage mit einer Antwort, die mitteilt, ob die Anfrage erfolgreich beantwortet oder nicht bearbeitet werden konnte.

nagios:plugins:check_snmp_cpfw.pl

Link zum Download: or Das Plugin verwendet SNMP (V1 und V3) um Checkpoint FW-1 firewalls zu prüfen. Es werden folgende Status checks unterstützt: * Firewall Status * High Availability Status (active/standby) * SVN Status * Anzahl an Verbindungen (warn/crit) * Policy checks * Management Stations status

nagios:plugins:check_snmp_env.pl

Link zum Download: Das Plugin verwendet SNMP (V1 und V3) um den Environment status eines Gerätes zu prüfen. Je nach Gerätetyp (supported werden Cisco, Ironport, Foundry, Nokia, Bluecoat, netSNMP Linux) sind das Stromversorgung (Power supply), Ventilatoren (Fans), Spannungen (Voltages) und Temperaturen.

nagios:plugins:check_snmp_int.pl

Generelles FIXME Besonderheiten von Windows Bei Windows Systemen kann man auf das Problem stoßen, dass check_snmp_int.pl die gewünschte Karte nicht findet. Das hat damit zu tun, dass bei Windows Systemen (Win32) die DeviceDescr keinen reinen ASCII String enthält sondern den Namen als Hexadezimalwerte. Im Falle von Leerzeichen in der DeviceDescr wird die Karte dann oft gar nicht gefunden. Auf multi homed Systemen, z.B. wenn das Mainboard zwei Netzwerkanschlüsse hat, kann man aber beobachten, …

nagios:plugins:check_snmp_storage.pl

Link zum Download: Das Plugin verwendet SNMP (V1 und V3) um Festplatten, Arbeitsspeicher und Swap auszulesen. Die Informationen aus der hrStorage table werden zur Auswertung herangezogen. Auch mehrere zu überwachende Medien können angegeben werden, eine Summierung dieser ist ebenfalls möglich.

nagios:plugins:check_snmp_vrrp.pl

Link zum Download: Das Plugin verwendet SNMP (V1 und V3) um den VRRP status zu prüfen. VRRP (Virtual Router Redundancy Protocol) ist ein standard Internet Protokoll und dient zur Steigerung der Verfügbarkeit wichtiger Devices/Gateways in lokalen Netzen durch redundante Router oder Firewalls.

nagios:plugins:check_tcp

Überprüft TCP Verbindungen zu einem Netzwerkhost oder UNIX Socket. Syntax Usage: check_TCP -H host -p port [-w ] [-c ] [-s ] [-e ] [-q ] [-m ] [-d ] [-t ] [-r ] [-M ] [-v] [-4|-6] [-j] [-D ] [-S ] [-E] Options: -h, --help Print detailed help screen -…

nagios:plugins:check_traffic

FIXME Diese Anleitung ist mit der check_traffic Plugin Version 0.90b entstanden. Das Plugin „check_traffic“ ist ein einfaches Addon für Nagios. Es ist in Perl geschrieben und dient dazu, Netzwerkschnittstellen über das SNMP Protokoll zu überwachen. Überprüft und Aufgezeichnet werden die gegenwärtige Bandbreite und die übertragenen Bytes. Wie bei anderen Nagios Plugins kann man hier auch WARNING und CRITICAL Schwellenwerte angeben, die uns eine Benachrichtigung zukommen lassen, wenn etwas au…

nagios:plugins:check_tunnel.pl

Link zum Download: Das Plugin verwendet SNMP (V1 und V3) um den VPN Tunnel status eines Checkpoint Firewall Clusters zu prüfen. Leider erweist sich der Checkpoint agent als sehr fehleranfällig, wodurch es nötig war, einige workarounds in das plugin einzubauen, so z.b. kommt es manchmal zu SNMP loops in der Tunnel Status table (enterprises.2620.500.9002).

nagios:plugins:check_xencpu

Das Script steuert mittels SNMP ein weiteres Script auf einer XEN dom0 an, welches die CPU Statistik liefert, Es dient nicht zum ermitteln harter Stati (OK/CRITICAL) sondern zum sammeln von Langzeitdaten mittels PNP. Client (XEN dom0) Das Script Es wird ein Script „xenupdate.py“ erstellt, zum Beispiel unter /root/script:

nagios:plugins:checken_eines_plugins

Bevor man anfängt, blind neue Commands für Nagios zu definieren, sollte man die zugrundeliegenden Plugins erst einmal manuell testen. Dabei ist darauf zu achten, das man den Test genauso durchführt wie Nagios das tun würde. * Nie als root testen! Testet immer mit dem User unter dem auch Nagios läuft. Einige Plugins schreiben temporäre Dateien, die als root angelegt, als user nagios nicht mehr überschrieben werden können.

nagios:plugins:fehler_-_operation_not_permitted

Dieser Fehler rührt bei Plugins meistens daher, das auf Systemsachen nciht zugegriffen werden kann. Skriptfunktion Zuerst sollte man in der Shell testen, ob vielleicht das Skript einen Fehler hat. Dazu das Skript als root ausführen. Wenn das dann klappt, muß man das Skript als der User testen, unter dem der nagios-Prozeß läuft (in der Regel „nagios“).

nagios:plugins:perl_plugin_template

Hallo zusammen, wer Interesse hat seine eigenen Plugins in Perl zu schreiben aber nicht wirklich lust/zeit hat sich mit den Nagios Plugin Developer Guidelines zu beschäftigen, der ist hier genau richtig. Mit folgendem Perl Skelett darf sich der gemeine Perl Programmierer nun um seine eigentliche Arbeit kümmern... dem schreiben der Intelligenz.

nagios:plugins:start

Nagios verwendet so genannte Plugins um die eigentlichen Checks durchzuführen. Plugins sind eigenständige Programme die auch unabhängig von Nagios verwendet werden können. Welche Voraussetzungen ein Plugin mitbringen muss, damit Nagios es verwenden kann, findet ihr hier