A plugin is a small executable that takes optional command line parameters as input and
- Performs a test
- Reports a diagnostic message on stdout (will be shown in the web GUI)
- Returns an exit code.
check_tcp to test the port 80/tcp on 220.127.116.11
# /opt/plugins/check_tcp -H 18.104.22.168 -p 80
TCP OK - 0.043 second response time on port 80|time=0.042824s;0.000000;0.000000;0.000000;10.000000
# echo $?
# /opt/plugins/check_tcp -H 22.214.171.124 -p 143
# echo $?
In the example above we first execute
check_tcp to test that port 80/tcp on 126.96.36.199 responds, which it does, hence the exit code of 0. Then we check port 143/tcp on the same host and that port is not open, hence the result is Critical - exit code 2.
The result output is actually built upon two parts divided by a | sign (pipe). The text on the
- left hand side of the | is the status information
- right hand side of the | is the performance data.
The performance data is not mandatory but you need it if you want your plugin to be able to produce graphs for you in OP5 Monitor.
The Status information is the text describing the result in human readable form. The plugin must print the status output to stdout when your plugin is executed.
You will see it in the Status state information on the Service or Host information page.
This text can be anything, you like to use to describe the status situation for your plugin, including HTML.
The performance data is data displaying the result in numbers. The plugin must print the status output to stdout when your plugin is executed. It is also to produce performance graphs in OP5 Monitor. So if you want graphs from your plugin you need to have performance data in your output. The performance data is setup like this:
Performance parts with descriptions:
The label can contain any characters. If space is included quotes are needed.
The plugin was able to check the service, but it appeared to be above some "warning" threshold or did not appear to be working properly
Can be any of:
warn, crit, min, max
Performance data output:
The example 2 above shows a performance data output from a plugin with two values separated with one space in the output.
The return code is the one that OP5 Monitor uses to determine what state the services is in. It may be one of the following:
0, 1, 2, 3
Any return code above 0 is to be known as problem states.
The return codes in detail:
|0||Ok||The check did ok and everything seems to be working fine.|
|1||Warning||The plugin was able to check the service, but it appeared to be above some "warning" threshold or did not appear to be working properly.|
|2||Critical||The plugin detected that either the service was not running or it was above some "critical" threshold.|
|3||Unknown||Something unknown happened during the check. Things like invalid command line arguments or low-level failures internal to the plugin shall not be reported as Unknown state.|