Notice: This repository is no longer actively maintained by Sysdig.

As of 21st June 2024, we will not be providing any further updates, bug fixes, or support for this project. Instead of forking this repository, we recommend using the original repository from which this project was forked: NTP_EXPORTER.

We have transitioned to using the Docker image for this Prometheus exporter, which is based on the original repository. You can find more information and the Docker image here: Docker Image Link.

We appreciate the community's contributions and support over the lifespan of this project.

Thank you for your understanding.

This is a Prometheus exporter that, when running on a node, checks the drift of that node's clock against a given NTP server or servers.

These are the metrics supported.

• ntp_build_info
• ntp_drift_seconds
• ntp_stratum
• ntp_rtt_seconds
• ntp_reference_timestamp_seconds
• ntp_root_delay_seconds
• ntp_root_dispersion_seconds
• ntp_root_distance_seconds
• ntp_precision_seconds
• ntp_leap
• ntp_scrape_duration_seconds

As an alternative to the node-exporter's time module, this exporter does not require an NTP component on localhost that it can talk to. We only look at the system clock and talk to the configured NTP server(s).

Compile make && make install or docker build. The binary can also be installed with go get:

go install github.com/sapcc/ntp_exporter@latest

We also publish pre-built images on Docker Hub as sapcc/ntp-exporter:

docker pull sapcc/ntp-exporter:v2.1.0

Common command-line options:

-ntp.source string
   source of information about ntp server (cli / http). (default "cli")
-version
   Print version information.
-web.listen-address string
   Address on which to expose metrics and web interface. (default ":9559")
-web.telemetry-path string
   Path under which to expose metrics. (default "/metrics")

By default, or when the option -ntp.source cli is specified, the NTP server and connection options is defined by command-line options:

-ntp.measurement-duration duration
   Duration of measurements in case of high (>10ms) drift. (default 30s)
-ntp.protocol-version int
   NTP protocol version to use. (default 4)
-ntp.server string
   NTP server to use (required).

When the option -ntp.source http is specified, the NTP server and connection options are obtained from the query parameters on each GET /metrics HTTP request:

• target: NTP server to use
• protocol: NTP protocol version (2, 3 or 4)
• duration: duration of measurements in case of high drift

For example:

$ curl 'http:https://localhost:9559/metrics?target=ntp.example.com&protocol=4&duration=10s'

Several people have suggested adding a metric like ntp_up that's always 1, so that people can alert on absent(ntp_up) or something like that. This is not necessary. Prometheus already generates such a metric by itself during scraping. A suitable alert expression could look like

up{job="ntp_exporter",instance="example.com:9559"} != 1 or absent(up{job="ntp_exporter",instance="example.com:9559"})

but the concrete labels will vary depending on your setup and scrape configuration.