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.
According to the Nagios Plugin API the Return Code
is 0 for state "OK", 1 for "WARNING", 2 for "CRITICAL" and "3" for "UNKNOWN".
- -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.
- 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).
additional data as link.
- 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
check_remote_by_udp does not use any files, but a sample nagios
config is shown here:
# cat /etc/nagios/msc.cfg
# cat /etc/nagios/remote-generic.cfg
command_line $USER1$/check_remote_by_udp -w $ARG1$ -c $ARG2$ -H $HOSTADDRESS$
-p 8888 $ARG3$
Frank Bergmann, udp://www.tuxad.com
Table of Contents