The check_ntp_peer Plugin



    check_ntp_peer v2.2.1.git (nagios-plugins 2.2.1)
    Copyright (c) 2006 Sean Finney
    Copyright (c) 2006-2014 Nagios Plugin Development Team
    	<devel@nagios-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.nagios-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:<timeout state>
        Seconds before connection times out (default: 10)
        Optional ":<timeout state>" can be a state integer (0,1,2,3) or a state STRING
     -v, --verbose
        Show details for command-line debugging (Nagios may truncate output)

    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.nagios-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@nagios-plugins.org if you have questions regarding use
    of this software. To submit patches or suggest improvements, send email to
    devel@nagios-plugins.org