EXE Sensors
EXE Sensors
Every time the sensor is run, the selected EXE file is executed. The string entered in the parameter field of the sensor's settings is placed in the command line. The EXE file must send the results to the Standard OUT. The data must be in the following format:
value:message
Value has to be a 32bit integer and will be used as the resulting value for this sensor (e.g. bytes, milliseconds, etc.), message can be any string and will be stored in the database.
The exit code of the EXE has to be one of the following values:
· 0 ok
· 1 warning
· 2 system error (e.g. a network/socket error)
· 3 protocol error (e.g. web server returns a 404)
· 4 content error (e.g. a webpage does not contains a required word)
If the EXE does not return control to the IPCheck Server Monitor process it is killed as soon as the timeout value set for this sensor is reached.
You can test the EXE file you want to use for the sensor very easily on the command line (cmd.exe). Simply start the EXE file and pipe the results into a file, e.g.:
sensorexe parameter > result.txt
The results are then written into the file result.txt and you can check the results with notepad or any other text editor.