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.


-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.

-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).

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.

Return Value

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$


See Also

check_remote_by_http(1) , knoerred(1) , knoerre(1)


Frank Bergmann, udp://

Table of Contents