Skip to main content

NTP daemon collector

Monitors the system variables of the local ntpd daemon (optional incl. variables of the polled peers) using the NTP Control Message Protocol via UDP socket, similar to ntpq, the standard NTP query program.

Metrics

All metrics have "ntpd." prefix.

Labels per scope:

  • global: no labels.
  • peer: peer_address.
MetricScopeDimensionsUnits
sys_offsetglobaloffsetmilliseconds
sys_jitterglobalsystem, clockmilliseconds
sys_frequencyglobalfrequencyppm
sys_wanderglobalclockppm
sys_rootdelayglobaldelaymilliseconds
sys_rootdispglobaldispersionmilliseconds
sys_stratumglobalstratumstratum
sys_tcglobalcurrent, minimumlog2
sys_precisionglobalprecisionlog2
peer_offsetpeeroffsetmilliseconds
peer_delaypeerdelaymilliseconds
peer_dispersionpeerdispersionmilliseconds
peer_jitterpeerjittermilliseconds
peer_xleavepeerxleavemilliseconds
peer_rootdelaypeerrootdelaymilliseconds
peer_rootdisppeerdispersionmilliseconds
peer_stratumpeerstratumstratum
peer_hmodepeerhmodehmode
peer_pmodepeerpmodepmode
peer_hpollpeerhpolllog2
peer_ppollpeerppolllog2
peer_precisionpeerprecisionlog2

Configuration

Edit the go.d/ntpd.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory, if different
sudo ./edit-config go.d/ntpd.conf

Configuration example:

jobs:
- name: local
address: '127.0.0.1:123'
collect_peers: no

- name: remote
address: '203.0.113.0:123'
timeout: 3
collect_peers: no

For all available options please see module configuration file.


Troubleshooting

To troubleshoot issues with the ntpd collector, run the go.d.plugin with the debug option enabled. The output should give you clues as to why the collector isn't working.

  • Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on your system, open netdata.conf and look for the plugins setting under [directories].

    cd /usr/libexec/netdata/plugins.d/
  • Switch to the netdata user.

    sudo -u netdata -s
  • Run the go.d.plugin to debug the collector:

    ./go.d.plugin -d -m ntpd

Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.