Freeware und Plugins

Beschreibung

check_output ist ein Windows-Plugin für Nagios, welches Rückgabewerte von aufgerufenen Programmen auswertet. Unterstützt dabei reguläre Ausdrücke (Regex).

Voraussetzungen

–

Dokumentation

Aufgerufen wird das Script normalerweise mit den Parametern zum aufrufenden Programm, dessen Parameter(n) sowie dem zur Alarmierung notwendigen String:

C:> check_ouput.exe path=<program> args=<arguments> exp=<expression>

Es kann auf deutschen und englischen Server-OS eingesetzt werden.

Zu Debuggingzwecken kann es aber auch mit einer ausführlicheren Ausgabeoption aufgerufen werden (dieser Modus eignet sich nicht für den Dauerbetrieb, sondern dient nur Testzwecken!).
Es werden dann detailliert die Stati der einzelnen Komponenten ausgegeben:

C:> check_output.exe path=“ C:\program files (x86)\oracle\bin\db-parser.exe“ args=„-sql-db=MYDB –sql-user=ORA –sql-password=secret –sql-db=MY_TESTDB –sql-table=ORA_SYS_01 –sql-cmd=‘select * from testtable;‘ exp=blabla debug

Path: C:\program files (x86)\oracle\bin\db-parser.exe
Args: „-sql-db=MYDB –sql-user=ORA –sql-password=secret –sql-db=MY_TESTDB –sql-table=ORA_SYS_01 –sql-cmd=‘select * from testtable;‘
Exp: blabla
Timeout: 15
C:\Development\NAGIOS\>
Tester; Fritz; 01.01.1970
Tester2; Karl; 02.02.1970
Tester3; Xaver; 03.03.1970

(blabla)
OK: No matches found

Für Informationen zum Plugin und dessen Nutzung kann es mit der Hilfeoption aufgerufen werden:

C:> check_output.exe help

check_output - Revision: 1.1
Copyright (C) 2014 LuftEngineering GmbH
Report Bugs to:info@luft-it.de
check_output plugin for Nagios. Search for errormessages in program output with regular expression

Usage:

     path     - Full path to customer exe (required)
     args     - Arguments for customer exe (required)
     exp      - Search string as regular expression (required)
                Example: exp="error;fail" will search for error and fail
     timeout  - Seconds before the plugin times out (default = 15)
     version  - Plugin version
     help     - Show this text
     debug    - Print details. NOT for use with nagios

Installation

Vorzugsweise wird das Plugin in das Skriptverzeichnis kopiert, in dem man seine Prüfskripte unter Windows ablegt.

Bei Einsatz von NSClient++ wird in der Initialisierungsdatei nsc.ini ein Eintrag ähnlich diesem erzeugt:

...
[/modules]
NRPEServer=enabled
CheckExternalScripts=enabled

[/settings/NRPE/server] 
allow arguments=true  
 
[/settings/external scripts/scripts] 
check_backup_log=check_output.exe path=d:\programme\logchecker.exe args=“-stringeval –files *.log“ exp=fatal
...

Beispiele

Prüfung von Datensicherungsprotokollen auf fatale Fehlereinträge:

C:> check_output.exe path=d:\programme\logchecker.exe args=“-dir d:\logs\backuplogs –files *.log“ exp=fatal

CRITICAL: Match: D:\Logs\Backuplogs\Dienstagsicherung.log>
FATAL: SCSI-Timeout bei Zugriff auf Bandbibliothek 

Prüfung mit einem kleinen Testskript:

C:> check_output.exe path=C:\batches\date_time.cmd args=echo exp=bla

OK: No matches found

Der Inhalt der Datei date_time.cmd ist dabei dieser:

echo %date:~0% - %time:~0,8% Uhr

Changelog

2014-07-06
1.1 – Support for .Net 4.0

2010-05-12
1.0 – First public version

Copyright

check_output wird unter der GNU General Public License zur Verfügung gestellt.

Autor

Joachim Luft beantwortet gerne Ihre Fragen zu diesem Plugin freut sich natürlich auch über eine kleine Spende!