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 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 experimental 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.
- -c critlevel
- Specify the critical
level. The remote value must be greater than the critlevel to trigger.
- 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:
- Show 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 setting.
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