Introduction to plugins
A plugin is a small executable that takes optional command line parameters as input and performs the following:
- Performs a test.
- Reports a diagnostic message in the OP5 Monitor user interface.
- Returns an exit code.
Plugins are used by OP5 Monitor to run the check commands at the core of its monitoring functionality.
Plugins delivered with OP5 Monitor
OP5 Monitor is delivered with a standard set of frequently used plugins, in default plugin directory
Note: The Slim Poller does not include all the plugins delivered with OP5 Monitor.
You can view the list of plugins in OP5 Monitor by clicking Manage > Configure > Plugins. Each plugin is listed with its support level. You can expand a plugin to see its details, and click any of the command links to go to the command configuration page, where you can view the command arguments and other details.
For a reference of the standard OP5 Monitor plugins, see Plugin reference.
Plugin support levels
The table below describes the support levels available for plugins.
Information returned by plugins
The return code of a plugin is used by OP5 Monitor to determine the state a of service. It can be any of the following:
0, 1, 2, 3
Any return code above
0 indicates a problem state.
The table below explains the meanings of different return codes.
||OK — the check went well and everything seems to be working fine.|
||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.|
||Critical — the plugin detected that either the service was not running or it was above some critical threshold.|
||Unknown — something unknown happened during the check. Invalid command line arguments or low-level failures internal to the plugin are not reported as unknown.|
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 can find the status information on the service or host detail page:
The text can be anything you want to use to describe the status situation for your plugin, including HTML.
The plugin displays the performance data result in numbers. It is not mandatory to include performance data in responses, but the data is used to produce performance graphs in OP5 Monitor, so you must include it if you want to produce graphs from your plugin. You configure the performance data as follows:
The label can contain any characters. If it includes spaces you need quotes.
The performance data number value.
Unit of measurement of the performance data value. Can be any of the following:
Example performance data output
The following example shows performance data output from a plugin with two values separated by one space:
This example executes the
check_tcp plugin to test ports 80 and 143 on IP address 18.104.22.168:
# /opt/plugins/check_tcp -H 22.214.171.124 -p 80 TCP OK - 0.043 second response time on port 80|time=0.042824s;0.000000;0.000000;0.000000;10.000000 # echo $? 0 # /opt/plugins/check_tcp -H 126.96.36.199 -p 143 Connection refused # echo $? 2
Port 80/tcp sends a response, so the plugin returns a success exit code of
0. It also returns a response output with two parts divided by a | sign (pipe). The text on the left of the pipe is the status information, and the text on the right is the performance data.
Port 143/tcp on the same host is not open, so the plugin returns a critical exit code of