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).
- -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/nagios-fwb
Frank Bergmann, udp://www.tuxad.com
Table of Contents