GitHub

The check_ntp_peer Plugin

check_ntp_peer v2.4.0.7.g78ce (monitoring-plugins 2.4git)
Copyright (c) 2006 Sean Finney
Copyright (c) 2006-2008 Monitoring Plugins Development Team
    <devel@monitoring-plugins.org>

This plugin checks the selected ntp server

Usage:
 check_ntp_peer -H <host> [-4|-6] [-w <warn>] [-c <crit>] [-W <warn>] [-C <crit>]
       [-j <warn>] [-k <crit>] [-v verbose]

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.
 -4, --use-ipv4
    Use IPv4 connection
 -6, --use-ipv6
    Use IPv6 connection
 -H, --hostname=ADDRESS
    Host name, IP Address, or unix socket (must be an absolute path)
 -p, --port=INTEGER
    Port number (default: 123)
 -q, --quiet
    Returns UNKNOWN instead of CRITICAL or WARNING if server isn't synchronized
 -w, --warning=THRESHOLD
    Offset to result in warning status (seconds)
 -c, --critical=THRESHOLD
    Offset to result in critical status (seconds)
 -W, --swarn=THRESHOLD
    Warning threshold for stratum of server's synchronization peer
 -C, --scrit=THRESHOLD
    Critical threshold for stratum of server's synchronization peer
 -j, --jwarn=THRESHOLD
    Warning threshold for jitter
 -k, --jcrit=THRESHOLD
    Critical threshold for jitter
 -m, --twarn=THRESHOLD
    Warning threshold for number of usable time sources ("truechimers")
 -n, --tcrit=THRESHOLD
    Critical threshold for number of usable time sources ("truechimers")
 -t, --timeout=INTEGER
    Seconds before connection times out (default: 10)
 -v, --verbose
    Show details for command-line debugging (output may be truncated by
    the monitoring system)

This plugin checks an NTP server independent of any commandline
programs or external libraries.

Notes:
 Use this plugin to check the health of an NTP server. It supports
 checking the offset with the sync peer, the jitter and stratum. This
 plugin will not check the clock offset between the local host and NTP
 server; please use check_ntp_time for that purpose.

 See:
 https://www.monitoring-plugins.org/doc/guidelines.html#THRESHOLDFORMAT
 for THRESHOLD format and examples.

Examples:
 Simple NTP server check:
  ./check_ntp_peer -H ntpserv -w 0.5 -c 1

 Check jitter too, avoiding critical notifications if jitter isn't available
 (See Notes above for more details on thresholds formats):
  ./check_ntp_peer -H ntpserv -w 0.5 -c 1 -j -1:100 -k -1:200

 Only check the number of usable time sources ("truechimers"):
  ./check_ntp_peer -H ntpserv -m @5 -n @3

 Check only stratum:
  ./check_ntp_peer -H ntpserv -W 4 -C 6

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