Timex 输入插件

此插件使用 Linux 内核 adjtimex 系统调用收集系统时间的指标。

该调用获取由 ntpd、systemd-timesyncd、chrony 或其他时间同步服务控制的内核时间变量的信息。

引入于: Telegraf v1.37.0 标签: hardware, system 操作系统支持: linux

全局配置选项

插件支持其他全局和插件配置设置，用于修改指标、标签和字段，创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md。

配置

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

Metrics

指标字段通常带有表示字段单位的后缀，其中 ns 表示纳秒，sec 表示秒，ppm 表示百万分之几。百万分之几的单位定义为 1 ppm 相当于 10^-6 或 0.0001 %。

• timex
  • 标签 (tags)
    • status (string) - 时钟命令/状态。
  • 字段 (fields)
    • offset_ns (int64) - 本地时钟和参考时钟的偏移量。
    • frequency_offset_ppm (float) - 本地时钟频率偏移（百万分之几）。
    • maxerror_ns (int64) - 最大误差（纳秒）。
    • estimated_error_ns (int64) - 估计误差（纳秒）。
    • loop_time_constant (int64) - 锁相环时间常数。
    • tick_ns (int64) - 时钟滴答之间的纳秒数。
    • pps_frequency_ppm (float) - 每秒脉冲频率（百万分之几）。
    • pps_jitter_ns (int64) - 每秒脉冲抖动（纳秒）。
    • pps_shift_sec (int64) - 每秒脉冲间隔持续时间（秒）。
    • pps_stability_ppm (float) - 每秒脉冲稳定性，相对值的平均值（百万分之几）。
    • pps_jitter_total (int64) - 每秒脉冲抖动限制计数。
    • pps_calibration_total (int64) - 每秒脉冲校准间隔计数。
    • pps_error_total (int64) - 每秒脉冲校准错误计数。
    • pps_stability_exceeded_total (int64) - 每秒脉冲总稳定性超过计数。
    • tai_offset_sec (int64) - TAI 偏移量（秒）。
    • synchronized (boolean) - 时钟是否与服务器同步。
    • status (int) - 时钟命令/状态。

示例输出

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