docker

Docker input 基于 telegraf/inputs.docker，通过 Docker API 采集 docker_* 指标。本目录的 Docker Dashboard 正是按这些指标编写并完成真实验证，因此使用该模板时必须启用 Docker input。

cAdvisor 也是推荐的容器采集方式，但它输出 container_* 指标，应使用 cAdvisor 目录下的仪表盘，不能与本模板混用。

采集配置

配置文件为 conf/input.docker/docker.toml：

[[instances]]
endpoint = "unix:///var/run/docker.sock"
gather_services = false
gather_extend_memstats = false
container_id_label_enable = true
container_id_label_short_style = false
timeout = "5s"
total_include = ["cpu", "blkio", "network"]

验证：

./categraf --test --inputs docker

至少应看到 docker_up、docker_n_containers_running 和 docker_container_cpu_usage_percent。

change

1. Using container_id as label not field
2. Some metrics have been deleted

容器ID标签

通过下面两个配置来控制 container_id 这个标签：

container_id_label_enable = true
container_id_label_short_style = false

默认 container_id_label_enable 设置为 true，表示启用，即会把容器ID放到标签里，container_id_label_short_style 是短格式，容器ID很长，如果把 short_style 设置为 true，就会只截取前面12位

权限问题

Categraf 最好是用 root 账号来运行，否则，请求 docker.sock 可能会遇到权限问题，需要把 Categraf 的运行账号，加到 docker group 中，假设 Categraf 使用 categraf 账号运行：

sudo usermod -aG docker categraf

运行在容器里

如果 Categraf 运行在容器中，docker 的 unix socket 就需要挂到 Categraf 的容器里，比如通过 -v /var/run/docker.sock:/var/run/docker.sock 这样的参数来启动 Categraf 的容器。如果是在 compose 环境下，也可以在 docker compose 配置中加上 volume 的配置：

volumes:
  - /var/run/docker.sock:/var/run/docker.sock

停用该插件

• 方法一：把 input.docker 目录改个别的名字，不用 input. 打头
• 方法二：docker.toml 中的 endpoint 配置留空