check_ping_multiaddr

Project Notes

Usage: check_ping_multiaddr {-4|-6} [options] -- address ...

Check that one or more IP addresses responds to ping.

The intent of this Nagios plugin is to check that a host is alive and
reachable on all of its addresses, in particular both IPv4 and IPv6
addresses, which can be tested at the same time.

Addresses can be specified either as numeric IP addresses, or as host
names that will be resolved at runtime. By default, only the first
address the resolver library returns for each host name will be used,
but the -A/--all flag will cause all of the addresses returned by the
resolver to be used. You need to give at least one of --ipv4 or --ipv6,
but both can be specified at the same time.

Note that Nagios does not allow you to declare multiple addresses for
a host. To use this in a check_command for a host, you need to either
let check_ping_multiaddr resolve addresses at runtime (thus depending on
DNS), or you need to generate a unique command declaration for each
host; something like:

define host {
host_name smurf
address 198.51.100.23
check_command check-host-alive::smurf
}
define command {
command_name check-host-alive::smurf
command_line $USER1$/check_ping_multiaddr -A46 -- 198.51.100.23 2001:db8:4711:17::1:23
}

Options:
--version show program's version number and exit
-h, --help show this help message and exit
-4, --ipv4 Use IPv4 [default: False]. At least one of --ipv4 and
--ipv6 must be given.
-6, --ipv6 Use IPv6 [default: False]. At least one of --ipv4 and
--ipv6 must be given.
-A, --all-addresses Check all addresses each hostname resolves to. By
default, only the first address for each host is
checked.
-r RETRIES, --retries=RETRIES
Number of ICMP ECHO retries to send [default: 9]. Must
be in the range 1 <= RETRIES <= 20.
-d, --debug Increase debug level [default: 0].