Skip to main content
Version: 1.37.x

NTP daemon monitoring with Netdata

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.


  • Version: NTPv4
  • Local interrogation allowed in /etc/ntp.conf (default):
# Local users may interrogate the ntp server more closely.
restrict ::1

It produces:

  1. system

    • offset
    • jitter
    • frequency
    • delay
    • dispersion
    • stratum
    • tc
    • precision
  2. peers

    • offset
    • delay
    • dispersion
    • jitter
    • rootdelay
    • rootdispersion
    • stratum
    • hmode
    • pmode
    • hpoll
    • ppoll
    • precision


Edit the python.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 python.d/ntpd.conf


update_every: 10

host: 'localhost'
port: '123'
show_peers: yes
# hide peers with source address in ranges and
peer_filter: '(127\..*)|(192\.168\..*)'
# check for new/changed peers every 60 updates
peer_rescan: 60

Sample (multiple jobs):

Note: ntp.conf on the host otherhost must be configured to allow queries from our local host by including a line like restrict <IP> nomodify notrap nopeer.

host: 'localhost'

host: 'otherhost'

If no configuration is given, module will attempt to connect to ntpd on ::1:123 or and show charts for the systemvars. Use show_peers: yes to also show the charts for configured peers. Local peers in the range are hidden by default, use peer_filter: '' to show all peers.

Was this page helpful?