The check_icmp Plugin
Copyright (c) 2005 Andreas Ericsson <ae@op5.se>
Copyright (c) 2005-2024 Monitoring Plugins Development Team
<devel@monitoring-plugins.org>
Usage:
check_icmp [options] [-H host1 [-H host2 [-H hostN]]]
Options:
-h, --help
Print detailed help screen
-V, --version
Print version information
--extra-opts=[section][@file]
Read options from an ini file. See
https://www.monitoring-plugins.org/doc/extra-opts.html
for usage and examples.
-H, --Host=HOST
specify a target, might be one of: resolveable name | IPv6 address | IPv4 address
(required, can be given multiple times)
[-4|-6], [--ipv4-only|--ipv6-only]
Use IPv4 or IPv6 only to communicate with the targets
-w, --warning=WARN_VALUE
warning threshold (default 200.000ms,40%)
-c, --critical=CRIT_VALUE
critical threshold (default 500.000ms,80%)
-R, --rta-mode-thresholds=RTA_THRESHOLDS
RTA (round trip average) mode warning,critical, ex. 100ms,200ms unit in ms
-P, --packet-loss-mode-thresholds=PACKET_LOSS_THRESHOLD
packet loss mode, ex. 40%,50% , unit in %
-J, --jitter-mode-thresholds=JITTER_MODE_THRESHOLD
jitter mode warning,critical, ex. 40.000ms,50.000ms , unit in ms
-M, --mos-mode-thresholds=MOS_MODE_THRESHOLD
MOS mode, between 0 and 4.4 warning,critical, ex. 3.5,3.0
-S, --score-mode-thresholds=SCORE_MODE_THRESHOLD
score mode, max value 100 warning,critical, ex. 80,70
-O, --out-of-order-packets
detect out of order ICMP packets, if such packets are found, the result is CRITICAL
[-n|-p], --number-of-packets=NUMBER_OF_PACKETS
number of packets to send (default 5)
-i
[DEPRECATED] packet interval (default 80.000ms)
This option was never actually used and is just mentioned here for historical purposes
-I, --target-interval=TARGET_INTERVAL
max target interval (default 0.000ms)
The time interval to wait in between one target and the next
-m, --minimal-host-alive=MIN_ALIVE
number of alive hosts required for success. If less than MIN_ALIVE hosts are OK, but MIN_ALIVE hosts are WARNING or OK, WARNING, else CRITICAL
-l, --outgoing-ttl=OUTGOING_TTL
TTL on outgoing packets (default 64)
-b, --size=SIZE
Number of icmp ping data bytes to send
Packet size will be SIZE + icmp header (default 68 + 8)
-v, --verbose
Verbosity, can be given multiple times (for debugging)
--output-format=OUTPUT_FORMAT
Select output format. Valid values: "multi-line", "mp-test-json"
Notes:
If none of R,P,J,M,S or O is specified, default behavior is -R -P
Naming a host (or several) to check is not.
Threshold format for -w and -c is 200.25,60% for 200.25 msec RTA and 60%
packet loss. The default values should work well for most users.
You can specify different RTA factors using the standardized abbreviations
us (microseconds), ms (milliseconds, default) or just plain s for seconds.
Send email to help@monitoring-plugins.org if you have questions regarding
use of this software. To submit patches or suggest improvements, send email
to devel@monitoring-plugins.org