Table of Contents
check_remote_by_udp - nagios plugin for getting remote values by udp
check_remote_by_udp [ -L ] [ -A(0|1|2|3|4) ] [ -W warnlevellow ] [ -C critlevellow
] -w warnlevel -c critlevel -H ip-address -p port [ -t timeout ] [ -u unit ] key
check_remote_by_udp is a nagios plugin for remote checking
hosts by udp. It was written as a (fast) alternative to net-snmp and it is
designed to work with knoerred, a small and fast udp-server.
check_remote_by_udp sends the given key with a LF to the remote server.
Then it expects a value as a result of the remote check. It takes the numeric
value from the last line of the remote udp response. The value will be interpreted
as a positive integer with up to 64 bits.
If the remote value is greater than the specified warning or critical level
then check_remote_by_udp will also recognize the line before and print
it contents as additional data. This additional or debug information is
printed between the remote value and the performance data.
- -w warnlevel
- Specify the warning level. The remote value must be
greater than the warnlevel to trigger.
- -W warnlevellow
- Specify the warning
low level. The remote value must be less than warnlevellow to trigger.
- -c
critlevel
- Specify the critical level. The remote value must be greater than
the critlevel to trigger.
- -C critlevellow
- Specify the critical low level.
The remote value must be less than the critlevellow to trigger.
- -H ip-address
- Specify the IP address of the remote server to check.
- -p port
- Specify the
port of the udp server on the remote host.
- -u unit
- Specify an optional unit
string which is placed after the remote value and which is visible in nagios.
- -t timeout
- The plugins internal timeout in seconds (default: 10).
- -L
- Show
additional data as link.
- -A(0|1|2|3|4)
- Specify the level of the remote value
which must be reached to print the additional data. "-A0" causes printing
if state is "OK" and "-A4" will disable printing. "-A1" is currently the default
setting.
According to the Nagios Plugin API the Return Code
is 0 for state "OK", 1 for "WARNING", 2 for "CRITICAL" and "3" for "UNKNOWN".
check_remote_by_udp does not use any files, but a sample nagios
config is shown here:
# cat /etc/nagios/msc.cfg
define service{
use service-1min
name load1
check_command check_remote_generic!8!20!load1
register 0
}
# cat /etc/nagios/remote-generic.cfg
define command{
command_name check_remote_generic
command_line $USER1$/check_remote_by_udp -w $ARG1$ -c $ARG2$ -H $HOSTADDRESS$
-p 8888 $ARG3$
}
check_remote_by_http(1)
, knoerred(1)
, knoerre(1)
http://downloads.tuxad.de/ngtx
Frank Bergmann, udp://www.tuxad.com
Table of Contents