The negate Plugin
negate v2.4.0.7.g78ce (monitoring-plugins 2.4git)
Copyright (c) 2002-2008 Monitoring Plugins Development Team
<devel@monitoring-plugins.org>
Negates only the return code of a plugin (returns OK for CRITICAL and vice-versa) by default.
Additional switches can be used to control:
- which state becomes what
- changing the plugin output text to match the return code
Usage:
negate [-t timeout] [-Towcu STATE] [-s] <definition of wrapped plugin>
Options:
-h, --help
Print detailed help screen
-V, --version
Print version information
-t, --timeout=INTEGER
Seconds before plugin times out (default: 11)
Keep timeout longer than the plugin timeout to retain CRITICAL status.
-T, --timeout-result=STATUS
Custom result on Negate timeouts; see below for STATUS definition
-o, --ok=STATUS
-w, --warning=STATUS
-c, --critical=STATUS
-u, --unknown=STATUS
STATUS can be 'OK', 'WARNING', 'CRITICAL' or 'UNKNOWN' without single
quotes. Numeric values are accepted. If nothing is specified, permutes
OK and CRITICAL.
-s, --substitute
Substitute output text as well. Will only substitute text in CAPITALS
Examples:
negate /usr/local/nagios/libexec/check_ping -H host
Run check_ping and invert result. Must use full path to plugin
negate -w OK -c UNKNOWN /usr/local/nagios/libexec/check_procs -a 'vi negate.c'
This will return OK instead of WARNING and UNKNOWN instead of CRITICAL
Notes:
This plugin is a wrapper to take the output of another plugin and invert it.
The full path of the plugin must be provided.
If the wrapped plugin returns OK, the wrapper will return CRITICAL.
If the wrapped plugin returns CRITICAL, the wrapper will return OK.
Otherwise, the output state of the wrapped plugin is unchanged.
Using timeout-result, it is possible to override the timeout behaviour or a
plugin by setting the negate timeout a bit lower.
Send email to help@monitoring-plugins.org if you have questions regarding
use of this software. To submit patches or suggest improvements, send email
to devel@monitoring-plugins.org