Telegraf

Telegraf 是一款用于收集、处理、聚合并写入指标、日志及其他任意数据的代理程序。

• 提供包含 300 多个插件的全面套件，覆盖系统监控、云服务、消息传递等广泛功能。
• 支持集成用户自定义代码，以高效地收集、转换和传输数据。
• 编译为独立的静态二进制文件，无任何外部依赖，确保部署流程简洁流畅。
• 使用 TOML 格式进行配置，提供友好且清晰明确的设置体验。
• 由来自超过 1,200 名贡献者的多元化社区共同开发。

用户可以从众多主题中选择插件，包括但不限于：

• 设备：OPC UA、Modbus
• 日志：File、Tail、Directory Monitor
• 消息传递：AMQP、Kafka、MQTT
• 监控：OpenTelemetry、Prometheus
• 网络：Cisco TelemetryMDT、gNMI
• 系统监控：CPU、Memory、Disk、Network、SMART、Docker、Nvidia SMI 等。
• 通用插件：Exec、HTTP、HTTP Listener、SNMP、SQL
• Windows：Event Log、Management Instrumentation、Performance Counters

🔨 安装

有关 Telegraf 的二进制构建、Docker 镜像、RPM 和 DEB 包以及其他构建方式，请参阅 安装指南。

版本控制及发布详情请参阅 发行说明文档。

💻 使用

用户需使用 TOML 格式定义包含所需插件和设置的配置文件，并将其传递给 Telegraf。Telegraf 代理会按照每个输入的采集间隔收集数据，并在每次刷新间隔将数据发送至输出端。

如需基本操作指南，请参阅 快速入门。

📖 文档

完整的文档列表（包括教程、参考材料等）可从 /docs 目录 开始查阅。

此外，每个插件都有自己的 README 文件，其中包含关于如何配置、使用，有时还包括调试或故障排除的详细信息。具体插件的相关文档可在 /plugins 目录 中找到。

以下是一些常用文档：

• 变更日志
• 配置
• 常见问题解答
• 发行版
• 安全声明

❤️ 贡献

我们非常珍视由超过 1,200 名贡献者组成的社区！Telegraf 中许多插件最初都是由社区成员贡献的。如果您有兴趣参与贡献，请查看我们的 贡献指南。同时，欢迎加入我们的 社区 Slack 或 社区论坛，与工程团队交流问题或提出建议。

如果您是 Telegraf 和 InfluxDB 的新手，还可以免费注册 InfluxDB 大学 参加课程，进一步学习相关知识。

ℹ️ 支持

如您有任何问题或意见想反馈给我们的工程团队，请使用 社区 Slack 或 社区论坛。GitHub 问题仅限于实际问题和功能请求。

📜 许可证

Telegraf 快速上手指南

Telegraf 是一个由 InfluxData 开发的开源代理程序，用于收集、处理、聚合和写入指标、日志及其他任意数据。它拥有超过 300 个插件，支持从系统监控到云服务的广泛场景，且编译为无外部依赖的静态二进制文件，部署极其简便。

环境准备

• 操作系统：支持 Linux (各种发行版), macOS, Windows, BSD 等主流操作系统。
• 前置依赖：无。Telegraf 是静态编译的二进制文件，无需安装 Go 运行时或其他库即可直接运行。
• 权限要求：部分插件（如读取系统内核指标或 Docker 守护进程）可能需要 root 权限或加入特定用户组（如 docker 组）。

安装步骤

您可以选择包管理器、Docker 或直接下载二进制文件进行安装。

方式一：使用包管理器（推荐 Linux 用户）

Ubuntu/Debian:

wget -qO- https://repos.influxdata.com/influxdata-archive_compat.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg > /dev/null
echo "deb [signed-by=/etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg] https://repos.influxdata.com/deb stable main" | sudo tee /etc/apt/sources.list.d/influxdata.list
sudo apt-get update && sudo apt-get install telegraf

CentOS/RHEL:

cat <<EOF | sudo tee /etc/yum.repos.d/influxdata.repo
[influxdata]
name = InfluxData Repository - Stable
baseurl = https://repos.influxdata.com/stable/\$basearch/main
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdata-archive_compat.key
EOF
sudo yum install telegraf

方式二：使用 Docker

docker run -d --name=telegraf \
  -v $(pwd)/telegraf.conf:/etc/telegraf/telegraf.conf:ro \
  influxdb/telegraf

方式三：手动安装二进制文件

访问 Releases 页面 下载对应平台的压缩包，解压后即可直接使用 ./telegraf 运行。

提示：国内用户若下载速度较慢，可尝试通过国内镜像站下载二进制包，或在配置网络代理后使用上述命令。

基本使用

Telegraf 的核心工作流程是：生成配置 -> 启动代理 -> 采集并输出数据。

1. 生成配置文件

使用以下命令生成一个包含默认系统监控插件（CPU、内存、磁盘等）的基础配置文件：

telegraf config > telegraf.conf

若需添加特定插件（例如同时采集 CPU 和 Prometheus 指标），可使用：

telegraf config --input-filter cpu:prometheus --output-filter influxdb_v2 > telegraf.conf

2. 编辑配置

打开 telegraf.conf，TOML 格式清晰易读。主要关注两个部分：

• [[inputs]]：定义数据采集源（如系统指标、日志文件、HTTP 接口）。
• [[outputs]]：定义数据写入目标（如 InfluxDB、Prometheus、Kafka、stdout）。

最简单示例：将采集到的系统指标直接打印到标准输出（便于调试）：

# telegraf.conf

[agent]
  interval = "10s"
  round_interval = true
  debug = false

[[inputs.cpu]]
  percpu = true
  totalcpu = true

[[outputs.file]]
  files = ["stdout"]

3. 运行 Telegraf

指定配置文件启动服务：

telegraf --config telegraf.conf

或者使用后台服务模式（如果通过包管理器安装）：

sudo systemctl start telegraf
sudo systemctl enable telegraf

启动后，您将看到类似以下的指标输出：

cpu,cpu=cpu0,host=myServer usage_idle=98.5,usage_user=0.5... 1715623400000000000
cpu,cpu=cpu-total,host=myServer usage_idle=99.1,usage_system=0.2... 1715623400000000000
mem,host=myServer available=4523123200,used_percent=45.2... 1715623400000000000

现在，Telegraf 已经开始工作，您可以根据需求在配置文件中启用更多插件并将数据发送至您的监控系统。