Table of Contents
check_remote_by_udp_multi - nagios plugin for getting multiple remote
values by udp
check_remote_by_udp_multi -I ip-address -H shorthostname
-p port [ -O ] [ -D ] [ -L ] [ -t timeout ] [ -u unit ] -w warnlevel1 -c critlevel1
[ -s servicename1 ] -k key1 [ -w warnlevel2 -c critlevel2 [ -s servicename2
] -k key2 ] keymulti
check_remote_by_udp_multi is a nagios plugin for remote checking
hosts by udp. It is designed to work with knoerred, a small and experimental
The local system time in seconds since epoch and the given hostname are
appended to the multikey with slash as separator and LF as terminator. check_remote_by_udp_multi
sends the multikey string to the remote server (see EXAMPLES below). Then
it expects multiple values as a result of the remote checks. Further explanations
are found in check_remote_by_udp(1)
The difference to check_remote_by_udp is that check_remote_by_udp_multi
can make multiple service checks with one single UDP remote request. It
should be called by nagios as active check and it returns the active check
value in a normal way. Additional checks are send back to nagios through
the command pipe as passive check results.
Currently the performance data are only handled for the first key, the
active check. Later versions of check_remote_by_udp_multi will include a
direct handling of performance data.
You guess that there is no faster way of monitoring than getting a small
UDP packet containing multiple check results from a binary remote server,
check_remote_by_udp_multi does not use any configuration files.
- -p port
- Specify the port of the udp server on the remote
- -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).
- Do not submit passive checks which
values are OK.
- Enable debug output.
- On warning or critical values print
also a knoerre-compatible link
- -H shorthostname
- Specify the shorthostname
for sending passive check results to nagios. The hostname will also be used
for hostname checking (-k hostname).
- -I ip-address
- Specify the IP address
of the remote server to check.
- -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
- -s servicename
- Specify the servicename of a single check to
send back as passive check result to nagios. If no servicename was specified
for a single check then its singlekey name will be used instead.
- -k singlekey
- Specify the key of a single check to be searched for in the returned results.
following call asks remote for multikey loadmulti strips out the value
of load1 and sends it back as active check result to nagios. The values
of diskusage/ (with servicename dfroot), load5 (servicename load5), system
time difference in seconds and hostname compare result will be send back
to nagios as passive check results of host localhost.
-I 127.0.0.1 -H gway -p 8888 -w 7 -c 20 load1 -w 80 -c 90 -s dfroot -k diskusage/ -w
10 -c 20 -k load5 -w 0 -c 0 -k hostname -w 10 -c 30 -k timediff loadmulti
The following example uses netcat to show the results of the example above,
including check of hostname and systime:
$ echo loadmulti/$(date +%s)/gway
|nc -w 1 -u 127.0.0.1 8888
diskusage/ 0GB free
diskinodes/ 47205 free
0.00 0.00 0.00 3/138 21264
Frank Bergmann, udp://www.tuxad.com
Table of Contents