bobrik/collectd-docker

Collectd Docker容器资源监控镜像

镜像概述

该镜像提供Collectd插件，用于收集Docker容器的资源使用情况，通过Docker Stats API获取数据并发送至Graphite监控系统。支持容器动态增减，无需重启Collectd即可自动识别新容器。

核心功能

• 实时收集容器的CPU、内存、网络等资源指标
• 支持通过容器标签或环境变量配置应用（App）和任务（Task）名称
• 动态监控容器，新增/移除容器无需重启Collectd
• 将指标数据发送至Graphite，可结合Grafana展示可视化dashboard

使用场景

• Docker容器集群的资源监控与性能分析
• 微服务架构中各服务容器的资源使用追踪
• 持续集成/部署环境中的容器资源消耗监控

配置说明

设置容器的应用名称

可通过以下方式为容器指定应用名称：

1. 直接设置容器标签 collectd_docker_app
2. 设置容器标签 collectd_docker_app_label，指向实际使用的标签（如 app_id）
3. 设置容器环境变量 COLLECTD_DOCKER_APP
4. 设置容器环境变量 COLLECTD_DOCKER_APP_ENV，指向实际使用的环境变量（如 MARATHON_APP_ID）

全局配置可通过运行Collectd容器时设置 APP_LABEL_KEY 或 APP_ENV_KEY 变量，例如：

bash
docker run ... -e APP_ENV_KEY=MARATHON_APP_ID ...

设置容器的任务名称

类似应用名称设置，可通过以下方式指定任务名称：

1. 容器标签 collectd_docker_task
2. 容器标签 collectd_docker_task_label（指向实际标签）
3. 环境变量 COLLECTD_DOCKER_TASK
4. 环境变量 COLLECTD_DOCKER_TASK_ENV（指向实际环境变量，如 MESOS_TASK_ID）

全局配置通过 TASK_LABEL_KEY 或 TASK_ENV_KEY 变量设置。

限制

• 未识别应用名称的容器将不被监控
• <app>.<task> 字符串长度限制为63字符，可通过 COLLECTD_DOCKER_APP_ENV_TRIM_PREFIX 或 COLLECTD_DOCKER_TASK_ENV_TRIM_PREFIX 修剪前缀

报告的指标

指标名称格式：collectd.<host>.docker_stats.<app>.<task>.<type>.<metric>

主要指标包括：

• CPU：cpu.user、cpu.system、cpu.total
• 内存：memory.limit、memory.usage、memory.cache等
• 网络（仅桥接模式）：net.rx_bytes、net.tx_packets等

部署示例

最小化运行命令

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock \
    -e GRAPHITE_HOST=<Graphite主机地址> -e COLLECTD_HOST=<Collectd主机名> \
    bobrik/collectd-docker

环境变量说明

• COLLECTD_HOST：指标中的主机名，默认使用 MESOS_HOST（若存在）
• COLLECTD_INTERVAL：指标更新间隔（秒），默认10
• GRAPHITE_HOST：Graphite碳服务主机地址
• GRAPHITE_PORT：Graphite碳服务端口，默认2003
• GRAPHITE_PREFIX：指标前缀，默认 collectd.
• APP_LABEL_KEY：应用名称的容器标签键，默认 collectd_docker_app
• APP_ENV_KEY：应用名称的环境变量键，默认 COLLECTD_DOCKER_APP
• TASK_LABEL_KEY：任务名称的容器标签键，默认 collectd_docker_task
• TASK_ENV_KEY：任务名称的环境变量键，默认 COLLECTD_DOCKER_TASK

注意：镜像内的libc不支持 /etc/resolv.conf 中的 search 指令，需提供完整可解析的主机名。

许可证

MIT