drpsychick/telegraf

drpsychick/telegraf Docker镜像

镜像概述和主要用途

基于telegraf:alpine镜像构建，旨在通过环境变量实现Telegraf的全面配置，支持无状态、环境配置的容器运行（符合12factor原则），适用于各类监控数据的收集与上报场景。

核心功能和特性

• 环境变量驱动配置：完全通过环境变量配置Telegraf，无需手动修改配置文件
• 单镜像多场景适配：一个镜像支持多种监控配置，满足不同监控需求
• 无状态容器设计：遵循12factor原则，配置通过环境变量注入，容器无本地状态
• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低

使用场景和适用范围

适用于需要灵活配置Telegraf进行系统、应用监控数据收集的场景，可对接InfluxDB等时序数据库，特别适合Docker环境下的监控部署与扩展。

使用方法和配置说明

环境变量格式变更（2021-04-28）

重要：存在不兼容变更，当前使用toml_update工具处理配置文件，环境变量格式调整如下：

• 旧格式：TEL_AGENT_HOSTNAME=hostname = "myhostname"
• 新格式：TEL_AGENT_NAMEDOESNOTMATTER=agent.hostname=myhostname

变量值需为单行文本，每个配置项使用独立变量。

三步快速使用流程

1. 创建环境变量配置文件

bash
docker run --rm -it drpsychick/telegraf:latest cat /default.env > telegraf.env

2. 配置关键参数

编辑telegraf.env，至少配置主机名和输出目标（如InfluxDB）：

TLG_AGENT_HOSTNAME=agent.hostname="myhostname"
TLG_INFLUXDB_URL=outputs.influxdb.urls=["http://yourinfluxhost:8086"]

配置规则：

1. 变量必须以默认前缀（default.env中的CONF_PREFIX，通常为TLG_）开头
2. 变量值为单行文本（受Docker环境变量限制）
3. 每个配置项使用一个独立变量

扩展配置示例：

TLG_INPUTS_CPU_PERCPU=inputs.cpu.percpu=true
TLG_INPUTS_CPU_TOTAL=inputs.cpu.totalcpu=true
TLG_INPUTS_CPU_TIME=inputs.cpu.collect_cpu_time=false
TLG_INPUTS_DISK_FLAGS=inputs.disk.ignore_fs=["tmpfs", "devtmpfs", "devfs"]

3. 测试与运行容器

测试配置有效性：

bash
docker run --rm -it --cap-add NET_ADMIN --env-file telegraf.env --name telegraf-test drpsychick/telegraf:latest telegraf --test

启动正式容器：

bash
docker run --rm -d --cap-add NET_ADMIN --env-file telegraf.env --name telegraf drpsychick/telegraf:latest

注意事项

• Docker环境变量不支持引号、单引号及换行符，配置值必须为单行文本
• toml_update工具会按配置的前缀顺序处理所有匹配变量，依次更新配置文件
• 运行时需根据监控需求添加必要的容器权限（如--cap-add NET_ADMIN用于网络监控）

验证配置成功后，可在目标输出系统（如InfluxDB）中查看收集的监控数据。