Check manual page of ntp

February 03. 2012

ntp

Author: Mathias Kettner

License: GPL

Distribution: official part of Check_MK

Supported Agents: Linux

This check uses the output of ntpq -p as sent by the agent. It is a list of all NTP peers with their state, stratum, offset and jitter. The check gets critical if the time offset exceeds a configurable level, if the stratum is too high or on othe error conditions. It gets UNKNOWN if the peer is unreachable or has not answered for a long time.

Note: This check creates one individual service for each peer. It is useful for monitoring the health of the peers. If you want to monitor only the time of the NTP client, you might rather use ntp.time.

Item

The name or IP address of the peer (first column in output of ntpq -p.

Check parameters

Parameter	Type	Description
critical_stratum	int	The stratum at which the check gets critical
warning	float	The offset in ms at which a warning is triggered
critical	float	the critical offset in ms

Performance data

Two variables: the time offset to the peer in milliseconds and the jitter in ms.

Inventory

Checks are created for all peers which have been contacted at least once, if ntp_inventory_mode is set to "detailed" or "both". In case of "summary" a check of type ntp.time is being created.

Configuration variables

Variable	Type	Description
ntp_default_levels	int, float, float	The global default levels for all checks of this type. This is preset to (10, 20.0, 50.0) (which means that the check gets critical if the stratum is 10 or higher).
ntp_inventory_mode	string	This variable controls which kind of NTP checks are created. A check of this type (ntp) is only created, if this variable is set to "detailed" or "both". Default is "summary".

Examples

main.mk

# Set critical stratum to 3, global warning/critical levels to 5.0 and 10.0 ms
ntp_default_levels = (3, 5.0, 10.0)


	Navigation: Check_MK Homepage Detailed Introduction Documentation Downloads Download with OMD (Subscription needed) FAQ Mailinglists Public GIT repository Interview with Ethan Galstad Stories, Statements, Successes (NEW) Screenshots of Multsite Live-Demo of Multsite GUI Support Contracts (German) - NEW