注意：这是telegraf官方镜像的amd64架构构建专用仓库——更多信息请参见官方镜像文档中的“非amd64架构？”和官方镜像FAQ中的“镜像源在Git中已更改，该怎么办？”。

快速参考

• 维护者：
  InfluxData

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的Dockerfile链接

• 1.34, 1.34.4

• 1.34-alpine, 1.34.4-alpine

• 1.35, 1.35.4

• 1.35-alpine, 1.35.4-alpine

• 1.36, 1.36.2, latest

• 1.36-alpine, 1.36.2-alpine, alpine

快速参考（续）

• 提交issue：
  [***]

• 支持的架构：(更多信息)
  amd64、arm32v7、arm64v8

• 镜像 artifact 详情：
  repo-info 仓库的repos/telegraf/目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的library/telegraf标签
  official-images 仓库的library/telegraf文件（历史记录）

• 本描述的来源：
  docs 仓库的telegraf/目录（历史记录）

什么是 Telegraf？

Telegraf 是一款开源代理，用于收集、处理、聚合和写入指标。基于插件系统，社区开发者可轻松添加对额外指标收集的支持。有五种不同类型的插件：

• 输入插件：从系统、服务或第三方 API 收集指标
• 输出插件：将指标写入各种目标
• 处理器插件：转换、装饰和/或过滤指标
• 聚合器插件：创建聚合指标（如平均值、最小值、最大值、分位数等）
• 密钥存储插件：用于隐藏配置文件中的密钥

Telegraf 官方文档

!logo

如何使用本镜像

暴露端口

• 8125 UDP
• 8092 UDP
• 8094 TCP

配置文件

使用镜像需提供有效的配置文件，至少需指定一个输入插件和一个输出插件。以下是基本使用步骤。

基本示例

配置文件为 TOML 格式，用于声明使用的插件。一个非常简单的配置文件telegraf.conf（收集系统 CPU 指标并输出到标准输出）如下：

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

用户拥有自定义配置文件后，可通过挂载配置文件启动 Telegraf 容器：

$ docker run -v $PWD/telegraf.conf:/etc/telegraf/telegraf.conf:ro amd64/telegraf

将$PWD修改为存储配置文件的目录。

更多 Telegraf 配置详情见此处。

样本配置

用户可使用config子命令生成样本配置，包含部分启用的系统指标输入插件，但仍需至少配置一个输出插件才能使用：

$ docker run --rm amd64/telegraf telegraf config > telegraf.conf

支持的插件参考

以下是 Telegraf 可用插件的链接：

• 输入插件
• 输出插件
• 处理器插件
• 聚合器插件

示例

监控 Docker 引擎主机

Telegraf 的常见用例是从容器内监控 Docker 引擎主机。推荐方法是将主机文件系统挂载到容器中，并通过环境变量指定文件系统位置。

不同插件所需挂载的文件不同，以下示例展示完整支持的位置：

$ docker run -d --name=telegraf \
	-v $PWD/telegraf.conf:/etc/telegraf/telegraf.conf:ro \
	-v /:/hostfs:ro \
	-e HOST_ETC=/hostfs/etc \
	-e HOST_PROC=/hostfs/proc \
	-e HOST_SYS=/hostfs/sys \
	-e HOST_VAR=/hostfs/var \
	-e HOST_RUN=/hostfs/run \
	-e HOST_MOUNT_PREFIX=/hostfs \
	amd64/telegraf

监控 Docker 容器

要监控其他 Docker 容器，可使用 docker 插件并挂载 docker 套接字。示例配置如下：

[[inputs.docker]]
  endpoint = "unix:///var/run/docker.sock"

启动 telegraf 容器：

$ docker run -d --name=telegraf \
      --net=influxdb \
      -v /var/run/docker.sock:/var/run/docker.sock \
      -v $PWD/telegraf.conf:/etc/telegraf/telegraf.conf:ro \
      amd64/telegraf

更多信息见 docker 插件文档。

安装额外包

部分插件需安装额外包，例如ntpq插件需要ntpq命令。建议创建自定义衍生镜像安装所需命令。

以下 Dockerfile 示例在基础镜像中添加mtr-tiny，保存为telegraf-mtr.docker：

FROM telegraf:1.12.3

RUN apt-get update && apt-get install -y --no-install-recommends mtr-tiny && \
	rm -rf /var/lib/apt/lists/*

构建衍生镜像：

$ docker build -t telegraf-mtr:1.12.3 - < telegraf-mtr.docker

创建telegraf.conf配置文件：

[[inputs.exec]]
  interval = "60s"
  commands=["mtr -C -n example.org"]
  timeout = "40s"
  data_format = "csv"
  csv_skip_rows = 1
  csv_column_names=["", "", "status", "dest", "hop", "ip", "loss", "snt", "", "", "avg", "best", "worst", "stdev"]
  name_override = "mtr"
  csv_tag_columns = ["dest", "hop", "ip"]

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

运行衍生镜像：

$ docker run --name telegraf --rm -v $PWD/telegraf.conf:/etc/telegraf/telegraf.conf telegraf-mtr:1.12.3

镜像变体

amd64/telegraf镜像有多种版本，适用于不同场景。

amd64/telegraf:<version>

这是默认镜像。若不确定需求，建议使用此版本。既可作为临时容器（挂载配置文件启动），也可作为构建其他镜像的基础。

amd64/telegraf:<version>-alpine

此镜像基于流行的Alpine Linux 项目（来自alpine官方镜像）。Alpine Linux 比大多数发行版基础镜像小得多（约5MB），因此生成的镜像更精简。

当首要需求是最小化最终镜像大小时，此变体非常有用。需注意它使用musl libc而非glibc，部分软件可能因 libc 依赖出现问题（详见此 Hacker News 讨论）。

为最小化镜像大小，Alpine 镜像通常不包含额外工具（如git或bash）。可基于此镜像创建 Dockerfile 安装所需工具（参见alpine镜像描述了解安装包方法）。

许可证

查看此镜像包含软件的许可证信息。

与所有 Docker 镜像一样，本镜像可能包含其他软件，这些软件可能采用其他许可证（如基础发行版的 Bash 等，以及主要软件的直接或间接依赖）。

部分可自动检测的额外许可证信息见repo-info仓库的telegraf/目录。

对于任何预构建镜像的使用，用户有责任确保其使用符合镜像中所有软件的相关许可证。