/sensu-plugins-ntp

This plugin provides native NTP instrumentation for monitoring and metrics collection, including: server drift, and metrics via `ntpdate` and `ntpstats`.

Primary LanguageRubyMIT LicenseMIT

sensu-plugins-ntp

Build Status Gem Version Code Climate Test Coverage Dependency Status

Functionality

Provides plugins for checking and measuring Network Time Protocol (NTP) servers.

Usage

check-ntp.rb

Check the synchronization state of the local NTP server.

parameters:

  • warn: Maximum offset in ms for warning state (default: 10)
  • crit: Maximum offset in ms for critical state (default: 100)
  • stratum: Maximum stratum value (default: 15)
  • unsynced_status: Default status when unsynced (default: UNKNOWN)

metrics-ntpdate.rb

Get metrics from ntpdate.

parameters:

  • server: Comma separated list of NTP server(s) to measure (default: localhost)
  • scheme: Prefix for metrics (default: hostname)

values:

  • offset: Time difference between server and source (unit: ms)
  • delay: Roundtrip time from server to source (unit: ms)

metrics-ntpstats.rb

Get metrics from ntpstats.

parameters:

  • host: Target host (default: localhost)
  • scheme: Prefix for metrics (default: hostname)

values:

Descriptions taken from https://www.eecis.udel.edu/~mills/ntp/html/ntpq.html.

  • clk_jitter: Clock jitter
  • clk_wander: Clock frequency wander
  • frequency: Frequency offset relative to hardware clock
  • mintc: Minimum time constant
  • offset: Combined offset of server relative to this host
  • stratum: Stratum
  • sys_jitter: Combined system jitter
  • tc: Time constant and poll exponent

Installation

sensu-install --plugin sensu-plugins-ntp