Monitoring NTP

This article will help you get the Ntp plugin for sd-agent configured and returning metrics

Installing the ntp plugin package

Install the ntp plugin on Debian/Ubuntu:

sudo apt-get install sd-agent-ntp

Install the ntp plugin on RHEL/CentOS:

sudo yum install sd-agent-ntp

Read more about agent plugins.

Additional Information

The NTP check will run every 15 minutes, so minute data will not be available for the Offset metric.

This check is automatically minimally configured, however further configuration options are available

Configuring the agent to monitor NTP

1. Configure /etc/sd-agent/conf.d/ntp.yaml


- offset_threshold: 60

# Optional params:
# host:
# port: ntp
# version: 3
# timeout: 5

The - offset_threshold: option is used for a feature not yet implemented, and currently has no effect. Despite this, the configuration file must have this option present, so we recommend leaving this option in it's default state.

2. Restart the agent

sudo /etc/init.d/sd-agent restart


sudo systemctl restart sd-agent

Verifying the configuration
Execute info to verify the configuration with the following:

sudo /etc/init.d/sd-agent info 


/usr/share/python/sd-agent/ info

If the agent has been configured correctly you'll see an output such as:

  - instance #0 [OK]
  - Collected * metrics

You can also view the metrics returned with the following command:

sudo -u sd-agent /usr/share/python/sd-agent/ check ntp

Configuring graphs

Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the ntp metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.


Monitored metrics

Metric Values

The time difference between the local clock and the NTP reference clock.
second / None
Type: float

Metrics Conversion

Please refer to the metrics conversion document to map old metrics names to the new metric names.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Monday  —  Friday.

10am  —  6pm UK.

Dedicated Support.