---
title: ''
description: Telegraf plugin for collecting metrics from Timex
url: https://docs.influxdata.com/telegraf/v1/input-plugins/timex/
estimated_tokens: 782
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/timex/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v1.37.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.1/plugins/inputs/timex/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.1/plugins/inputs/timex/sample.conf)

# Timex Input Plugin

This plugin gathers metrics on system time using the Linux Kernel[adjtimex syscall](https://man7.org/linux/man-pages/man2/adjtimex.2.html).

The call gets the information of the kernel time variables that are controlled
by the ntpd, systemd-timesyncd, chrony or other time synchronization services.

**Introduced in:** Telegraf v1.37.0**Tags:** hardware, system**OS support:** linux

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Read time metrics from linux timex interface.
[[inputs.timex]]
  ## No input configuration
```

## Metrics

Metric fields usually have a suffix denoting the unit of the field with`ns` being nanoseconds, `sec` being seconds and `ppm` being parts-per-million.
The parts-per-million unit is defined as`1 ppm` corresponds to `10^-6` or `0.0001 %`.

* timex
  * tags:
    * status (string) - Clock command/status.

  * fields:
    * offset\_ns (int64) - The offset from local and reference clock.
    * frequency\_offset\_ppm (float) - Local clock frequency offset in parts per
      million.
    * maxerror\_ns (int64) - The maximum error in nanoseconds.
    * estimated\_error\_ns (int64) - The estimated error in nanoseconds.
    * loop\_time\_constant (int64) - Phase-locked loop time constant.
    * tick\_ns (int64) - Nanoseconds between clock ticks.
    * pps\_frequency\_ppm (float) - Pulse-per-second frequency in parts per
      million.
    * pps\_jitter\_ns (int64) - Pulse-per-second jitter in nanoseconds.
    * pps\_shift\_sec (int64) - Pulse-per-second interval duration in
      seconds.
    * pps\_stability\_ppm (float) - Pulse-per-second stability, average of
      relative in parts per million.
    * pps\_jitter\_total (int64) - Pulse-per-second per second count of jitter
      limit.
    * pps\_calibration\_total (int64) - Pulse-per-second count of calibration
      intervals.
    * pps\_error\_total (int64) - Pulse-per-second count of calibration errors.
    * pps\_stability\_exceeded\_total (int64) - Pulse-per-second total stability.
    * tai\_offset\_sec (int64) - TAI offset in seconds.
    * synchronized (boolean) - Is clock synchronized with a server.
    * status (int) - Clock command/status.

## Example Output

```text
timex,host=testvm,status=ok maxerror_ns=1516000i,estimated_error_ns=4000i,tick_ns=10000000i,loop_time_constant=2i,pps_jitter_total=0i,synchronized=true,offset_ns=0i,frequency_offset_ppm=55.05543,pps_shift_sec=0i,pps_stability_ppm=0,tai_offset_sec=37i,status=0i,pps_frequency_ppm=0,pps_jitter_ns=0i,pps_calibration_total=0i,pps_error_total=0i,pps_stability_exceeded_total=0i 1761121800000000000
```