Overview
The Network Time Protocol (NTP) integration is enabled by default and reports the time offset from an ntp server every 15 minutes. When the local Agent’s time is more than 15 seconds off from the Datadog service and other hosts you are monitoring, you may experience:
- Incorrect alert triggers
- Metric delays
- Gaps in graphs of metrics
By default, the check detects which cloud provider the Agent is running on and uses the private
NTP server of that cloud provider, if available. If no cloud provider is detected, the agent will
default to the NTP servers below:
0.datadog.pool.ntp.org1.datadog.pool.ntp.org2.datadog.pool.ntp.org3.datadog.pool.ntp.org
Note: NTP requests do not support proxy settings.
Setup
Installation
The NTP check is included in the Datadog Agent package, so you don’t need to install anything else on your servers.
Configuration
The Agent enables the NTP check by default. To configure the check yourself, edit the file ntp.d/conf.yaml in the conf.d/ folder at the root of your Agent’s configuration directory. See the sample ntp.d/conf.yaml for all available configuration options.
Note: If you edit the Datadog-NTP check configuration file, restart the Agent to effect any configuration changes.
Validation
Run the Agent’s status subcommand and look for ntp under the Checks section.
Data Collected
Metrics
ntp.offset
(gauge) | The time difference between the NTP reference clock and the local clock.
Shown as second |
Events
The NTP check does not include any events.
Service Checks
ntp.in_sync
Returns CRITICAL if the host clock is more than the configured threshold away from the NTP time. Returns UNKNOWN if the Agent can not connect to the NTP server. Returns OK otherwise.
Statuses: ok, critical, unknown
Troubleshooting
Need help? Contact Datadog support.
