time_exporter

README

Time Exporter

Prometheus exporter for covering all possible timesync and time services.

NOTE: This repo is partial fork of node_exporter

NOTE: Exporter is only tested on linux machines

• Time Exporter
• Sample
• Installation and Usage
  • Docker
  • Binary
• Collectors
  • chrony
  • ntp
  • time
  • timex

Sample

Before the actual usage take a look at the metrics sample

Installation and Usage

The time_exporter listens on HTTP port 9818 by default. See the --help output for more options.

Docker

docker run --rm -d \
  --name time_exporter \
  --net=host \
  -v /var/run/chrony/chronyd.sock:/var/run/chrony/chronyd.sock:ro \
  dmi7ry/time-exporter --log.level=debug --collector.chrony.address=127.0.0.1:323

or

docker run --rm -d \
  --name time-exporter \
  -p 9818:9818 \
  -v /var/run/chrony/chronyd.sock:/var/run/chrony/chronyd.sock:ro \
  dmi7ry/time-exporter --log.level=debug --collector.chrony.address=/var/run/chrony/chronyd.sock

Binary

export version=0.0.2
curl -L https://github.com/dmitry-ee/time_exporter/releases/download/$version/time_exporter-$version.linux-amd64.tar.gz | tar -zxf -
./time_exporter-$version.linux-amd64/time_exporter

Collectors

All collectors are enabled by default

That could be disabled with both flags --collector.disable-defaults and if you want to get rid of the default (go_|process_|promhttp_) set --web.disable-exporter-metrics

chrony

Enables and disables with flag --collector.chrony and --no-collector.chrony

collector.chrony.address

The most important flag here: it could be socket path (/var/run/chrony/chronyd.sock by default) or host:port (chronyd is listening 127.0.0.1:323 by default).

That could be useful to get the statistics even from outside the host itself

--collector.chrony.log-response-json

Log chronyd response in debug logging, could be helpful to get the real response for debugging purposes

ntp

Enables and disables with flag --collector.ntp and --no-collector.ntp

time

Enables and disables with flag --collector.time and --no-collector.time

timex

Enables and disables with flag --collector.timex and --no-collector.timex