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

快速参考

• 维护者：
  InfluxData

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

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

• 1.34, 1.34.4

• 1.35, 1.35.4

• 1.36, 1.36.2, latest

快速参考（续）

• 问题提交地址：
  [***]

• 支持的架构： (更多信息)
  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 arm32v7/telegraf

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

更多关于Telegraf配置的信息请参见此处。

示例配置

用户可使用config子命令生成示例配置。这将为用户提供一个基本配置，其中启用了一些从系统收集数据的输入插件。但用户仍需至少配置一个输出插件才能使用该文件：

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

支持的插件参考

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

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

示例

监控Docker引擎主机

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

不同插件所需的具体文件有所不同。以下示例展示了全套支持的位置：

$ 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 \
	arm32v7/telegraf

监控Docker容器

要监控其他Docker容器，可使用docker插件并将docker socket挂载到容器中。以下是示例配置：

[[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 \
      arm32v7/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

许可证

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

与所有Docker镜像一样，这些镜像可能还包含其他软件，可能受其他许可证约束（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可证信息可能位于repo-info仓库的telegraf/目录中。

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