GitHub

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