文档文档

Telegraf 词汇表

代理

Agent 是 Telegraf 的核心部分,它根据给定配置启用的插件,从声明的输入插件收集指标并将指标发送到声明的输出插件。

相关条目: 输入插件, 输出插件

aggregator plugin

聚合器插件接收来自输入插件的原始指标,并从中创建聚合指标。然后将聚合指标传递给配置的输出插件。

相关条目: 输入插件, 输出插件, 处理器插件

batch size

Telegraf 代理以批处理的方式将指标发送到输出插件,而不是单独发送。批处理大小控制 Telegraf 发送到输出插件的每个写入批次的大小。

相关条目: 输出插件

collection interval

从每个输入插件收集数据的默认全局间隔。收集间隔可以被每个单独的输入插件的配置覆盖。

相关条目: 输入插件

collection jitter

收集抖动用于防止所有输入插件同时收集指标,这可能会对系统产生可衡量的影响。在每个收集间隔,每个输入插件将在收集指标之前随机睡眠零到收集抖动之间的时间。

相关条目: 收集间隔, 输入插件

external plugin

在 Telegraf 外部构建并通过 execd 插件运行的程序。它提供了添加 Telegraf 内部插件中不存在的功能的灵活性。

flush interval

将数据从每个输出插件刷新到其目的地的全局间隔。此值不应低于收集间隔。

相关条目: 收集间隔, 刷新抖动, 输出插件

flush jitter

刷新抖动用于防止每个输出插件同时发送写入,这可能会使某些数据接收器不堪重负。在每个刷新间隔,每个输出插件将在发出指标之前随机睡眠零到刷新抖动之间的时间。这有助于在运行大量 Telegraf 实例时平滑写入峰值。

相关条目: 刷新间隔, 输出插件

input plugin

输入插件主动收集指标并将其传递给核心代理,然后聚合器、处理器和输出插件可以在这些指标上进行操作。要激活输入插件,需要在 Telegraf 的配置文件中启用并配置它。

相关条目: 聚合器插件, 收集间隔, 输出插件, 处理器插件

metric buffer

当输出插件的写入失败时,指标缓冲区会缓存单个指标。Telegraf 会在成功写入输出插件后尝试刷新缓冲区。当缓冲区已满时,最旧的指标将首先被丢弃。

相关条目: 输出插件

output plugin

输出插件将指标传递到其配置的目的地。要激活输出插件,需要在 Telegraf 的配置文件中启用并配置它。

相关条目: 聚合器插件, 刷新间隔, 输入插件, 处理器插件

precision

精度配置设置决定了从输入插件接收的点中保留多少时间戳精度。所有传入的时间戳都将被截断到给定的精度。然后 Telegraf 会用零填充截断的时间戳以创建纳秒级时间戳;输出插件将以纳秒为单位发出时间戳。有效的精度为 ns(纳秒)、usµs(微秒)、ms(毫秒)和 s(秒)。

例如,如果精度设置为 ms,则纳秒级 epoch 时间戳 1480000000123456789 将被截断为 1480000000123(毫秒精度),然后用零填充以创建一个新的、精度较低的纳秒级时间戳 1480000000123000000。输出插件不会进一步修改时间戳。精度设置对于服务输入插件将被忽略。

相关条目: 聚合器插件, 输入插件, 输出插件, 处理器插件, 服务输入插件

processor plugin

处理器插件转换、装饰和/或过滤由输入插件收集的指标,并将转换后的指标传递给输出插件。

相关条目: 聚合器插件, 输入插件, 输出插件

service input plugin

服务输入插件是在 Telegraf 代理运行时以被动收集模式运行的输入插件。它们监听套接字以接收已知的协议输入,或在将指标传递给 Telegraf 代理之前应用自己的逻辑来处理已摄取的指标。

相关条目: 聚合器插件, 输入插件, 输出插件, 处理器插件


此页面是否有帮助?

感谢您的反馈!


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