文档文档

OpenNTPD 输入插件

此插件使用 ntpctl 命令从 OpenNTPD 收集指标。

ntpctl 二进制文件必须存在于系统上,并且 Telegraf 可以执行它。该插件支持使用 sudo 进行执行。

发布于: Telegraf v1.12.0 标签: server, network 操作系统支持: all

全局配置选项

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

配置

# Get standard NTP query metrics from OpenNTPD.
[[inputs.openntpd]]
  ## Run ntpctl binary with sudo.
  # use_sudo = false

  ## Location of the ntpctl binary.
  # binary = "/usr/sbin/ntpctl"

  ## Maximum time the ntpctl binary is allowed to run.
  # timeout = "5s"

权限

需要注意的是,此插件引用了 ntpctl,这可能需要额外的权限才能成功执行。根据执行此插件的 telegraf 用户的用户/组权限,您可能需要更改组的成员身份、设置 facls 或使用 sudo。

$ groups telegraf
telegraf : telegraf

$ usermod -a -G ntpd telegraf

$ groups telegraf
telegraf : telegraf ntpd

Sudo 权限

如果使用此方法,则需要在 telegraf 配置中添加以下内容

[[inputs.openntpd]]
  use_sudo = true

您还需要更新您的 sudoers 文件

$ visudo
# Add the following lines:
Cmnd_Alias NTPCTL = /usr/sbin/ntpctl
telegraf ALL=(ALL) NOPASSWD: NTPCTL
Defaults!NTPCTL !logfile, !syslog, !pam_session

请使用您认为最合适的解决方案。

Metrics

  • ntpctl
    • 标签 (tags)
      • remote (用于同步的远程对等节点)
      • stratum (远程对等节点的层级)
    • 字段 (fields)
      • delay (到远程对等节点的往返延迟(毫秒); float)
      • jitter (远程对等节点的平均偏差(抖动); float)
      • offset (到远程对等节点的平均偏移(相位)(毫秒); float)
      • poll (轮询间隔(秒); int)
      • next (距离下次轮询的秒数; int)
      • wt (对等节点权重; int)
      • tl (对等节点信任级别; int)

示例输出

openntpd,remote=194.57.169.1,stratum=2,host=localhost tl=10i,poll=1007i,
offset=2.295,jitter=3.896,delay=53.766,next=266i,wt=1i 1514454299000000000

此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2