singula/cadvisor

自定义cadvisor镜像文档

镜像概述

本镜像为重新修改编译后的cadvisor Docker镜像，基于cadvisor v0.27.4版本。核心变更为将原被动提供监控数据的工作方式优化为主动上传数据到网关，并新增自定义采集模块，适用于需要主动收集容器监控数据的场景。

核心功能与特性

• 主动数据上传：将容器监控数据主动上传至指定网关，替代原被动等待拉取的模式
• 自定义采集模块：支持通过配置文件添加自定义监控指标
• 可配置采集频率：支持通过环境变量设置数据采集与上传频率
• 兼容标准cadvisor功能：保留cadvisor原生的容器资源监控能力

使用场景

适用于容器监控系统中需要将多节点容器监控数据主动集中上传至监控网关的场景，尤其适合需要自定义监控指标的容器化环境。

镜像信息

• cadvisor版本：v0.27.4
• 源码下载地址：https://github.com/google/cadvisor/archive/v0.27.4.tar.gz

使用方法

1. 构建镜像

bash
docker build -t singula/cadvisor .

2. 启动监控网关

需先启动pushgateway作为数据接收网关：

bash
docker run --restart=always -d -p 9091:9091 prom/pushgateway:v0.4.0

注意：pushgateway版本需使用v0.4.0

3. 运行cadvisor镜像

bash
docker run -it \
  -v /:/rootfs:ro \
  -v /var/run:/var/run:rw \
  -v /sys:/sys:ro \
  -v /var/lib/docker/:/var/lib/docker:ro \
  -e PUSH_FREQ=120 \
  -e LOCAL_ADDR=xxxx \
  -e PUSH_ADDR=xxxx:9091 \
  singula/cadvisor

参数说明

挂载说明

• /:/rootfs:ro：只读挂载主机根文件系统，用于获取系统信息
• /var/run:/var/run:rw：读写挂载运行时目录，用于获取容器运行状态
• /sys:/sys:ro：只读挂载sys目录，用于获取系统设备信息
• /var/lib/docker/:/var/lib/docker:ro：只读挂载Docker数据目录，用于获取容器详细信息

4. 验证部署

在浏览器中访问以下地址验证数据是否正常采集：

http://[LOCAL_ADDR]/metrics

例如：http://xxxx:9091/metrics，页面将显示采集到的容器监控数据。

自定义指标配置

程序会从/tmp/sgl/userinfo文件中读取自定义指标，文件需按以下格式配置：

指标名1:指标值1
指标名2:指标值2
...

注意：需确保容器内该文件存在且格式正确，自定义指标将随监控数据一同上传至网关。