Telegraf 安装指南：4 种方案怎么选，10 分钟跑通指标采集 Agent

Telegraf 安装指南：4 种方案怎么选，10 分钟跑通指标采集 Agent

【免费下载链接】telegrafAgent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.项目地址: https://gitcode.com/GitHub_Trending/te/telegraf

Telegraf 是一个轻量的指标采集 Agent：它把 CPU、内存、数据库、中间件等来源的数据抽出来，写进 InfluxDB、文件或任何你指定的目的地。读完这篇，你能在一分钟内选定适合自己环境的安装方式，再用一条命令把它跑起来。

先定场景：4 条安装路径对照

先判断你的处境，再挑方式。Telegraf 的安装路径差异很大，先看这张表选定一条：

用 Docker 镜像最快跑通

装好 Docker 的话，这是最快的路。官方镜像有 Debian 和 Alpine 两种基底，Alpine 版更轻：

docker pull telegraf

确认方法：docker images | grep telegraf能看到刚拉下来的镜像。

配置文件是跑通的关键。Telegraf 启动至少需要一个 input 和一个 output。写一个最小的config.toml，把 CPU 和内存指标打到 stdout：

[[inputs.cpu]] [[inputs.mem]] [[outputs.file]]

然后挂载配置启动容器：

docker run --rm --volume $PWD/config.toml:/etc/telegraf/telegraf.conf telegraf

怎么确认成功了：开头几行会打印加载的配置文件和已启用的插件；几秒后开始滚动输出cpu,host=... usage_idle=...这类指标行。一直没有任何输出，就去检查配置里是否同时存在[[inputs.*]]和[[outputs.*]]。

用包管理器装进系统

包管理器安装最适合生产环境，后续升级最省事。Ubuntu/Debian 先加官方源再安装：

wget -q https://repos.influxdata.com/influxdata-archive.key gpg --dearmor < influxdata-archive.key | sudo tee /etc/apt/trusted.gpg.d/influxdata.gpg echo 'deb [signed-by=/etc/apt/trusted.gpg.d/influxdata.gpg] https://repos.influxdata.com/debian stable main' | sudo tee /etc/apt/sources.list.d/influxdata.list sudo apt-get update && sudo apt-get install telegraf

macOS 上直接：

brew update && brew install telegraf

确认方法：终端执行telegraf --version，能打印出版本号（如 1.40.x）即安装成功。RHEL/CentOS 的 RPM 流程是先写 repo 文件再yum install，完整命令见 docs/INSTALL_GUIDE.md。

从源码构建 Telegraf

源码构建面向要定制插件集合或尝鲜最新版本的场景。环境要求 Go 1.27 以上和 GNU make：

git clone https://gitcode.com/GitHub_Trending/te/telegraf cd telegraf make build

确认方法：当前目录生成可执行的telegraf文件，./telegraf --version能输出版本号。

💡二进制体积大？仓库自带custom_builder工具，它能解析你的配置文件，只编译实际用到的插件，生成一个大幅缩水的二进制。用法见 tools/custom_builder/。

Kubernetes 用户走 Helm chart 更顺：

helm repo add influxdata https://helm.influxdata.com/ helm search repo influxdata

确认方法：helm search输出列表里能看到 telegraf 相关 chart，再按 chart 说明执行 install。

验证安装与排查高频坑

装完先跑这两条命令验收：

telegraf --version telegraf --config /etc/telegraf/telegraf.conf --test

确认方法：--test会把 input 跑一轮、把指标直接打印到 stdout 后退出，看到指标行就是通的。完整参数说明在 docs/COMMANDS_AND_FLAGS.md。

三个高频坑：

• 出现Insufficient lockable memory警告：Docker 启动时加--ulimit memlock=8192:8192，或给启动参数加--unprotected（改用非锁定内存，安全性略降）。
• 启动后没有任何输出：九成是配置缺了 input 或 output，二者缺一不可。
• 提示插件未识别：构建时没有编进该插件，用 custom_builder 重新生成二进制。

装完之后的行动清单

• telegraf --version能输出版本号
• --test能打印出至少一行完整指标
• 在 plugins/inputs/ 里选定了要采集的 input 插件
• 在 plugins/outputs/ 里选定了指标的去向
• 二进制体积敏感的话，用 custom_builder 重建了精简版

更多可参考 docs/QUICK_START.md 里的最小示例流程。

【免费下载链接】telegrafAgent for collecting, processing, aggregating, and writing metrics, logs, and other arbitrary data.项目地址: https://gitcode.com/GitHub_Trending/te/telegraf