kubler/cadvisor

cadvisor 镜像文档

镜像概述

cadvisor（Container Advisor）是由Google开发的容器监控工具，用于收集、聚合和导出容器的资源使用情况及性能数据。本镜像基于官方cadvisor构建，优化后镜像大小约31MB，轻量级设计使其适合在资源受限环境中部署。

核心功能与特性

• 资源监控：实时收集容器CPU、内存、磁盘I/O、网络等资源使用数据
• 多容器支持：兼容Docker、rkt等主流容器运行时
• 数据导出：支持通过HTTP API、Prometheus等方式导出监控数据
• Web UI：内置Web界面，直观展示容器性能指标
• 轻量级：镜像大小仅约31MB，资源占用低

使用场景

• 容器化应用的资源监控与性能分析
• Kubernetes集群中的容器监控补充
• Docker主机的本地容器监控
• 集成到监控系统（如Prometheus + Grafana）构建完整监控方案

使用方法

基本运行

通过以下命令启动cadvisor容器：

bash
docker run -d \
  --name cadvisor \
  --volume=/:/rootfs:ro \
  --volume=/var/run:/var/run:ro \
  --volume=/sys:/sys:ro \
  --volume=/var/lib/docker/:/var/lib/docker:ro \
  --publish=8080:8080 \
  kubler/cadvisor

关键参数说明

• 卷挂载：

  • /:/rootfs:ro：只读挂载主机根文件系统，用于获取系统信息
  • /var/run:/var/run:ro：挂载Docker socket，用于获取容器信息
  • /sys:/sys:ro：挂载系统sys目录，用于获取硬件和系统资源数据
  • /var/lib/docker/:/var/lib/docker:ro：挂载Docker数据目录，用于获取容器详细信息

• 端口映射：8080:8080，暴露cadvisor Web UI和API端口

自定义配置

可通过命令行参数调整cadvisor行为，常用参数：

• --port=8080：指定HTTP服务端口
• --storage_driver=prometheus：设置存储驱动为Prometheus
• --housekeeping_interval=10s：设置数据收集间隔（默认10秒）

示例：使用Prometheus存储驱动并调整收集间隔

bash
docker run -d \
  --name cadvisor \
  --volume=/:/rootfs:ro \
  --volume=/var/run:/var/run:ro \
  --volume=/sys:/sys:ro \
  --volume=/var/lib/docker/:/var/lib/docker:ro \
  --publish=8080:8080 \
  kubler/cadvisor \
  --storage_driver=prometheus \
  --housekeeping_interval=5s

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  cadvisor:
    image: kubler/cadvisor
    container_name: cadvisor
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - /:/rootfs:ro
      - /var/run:/var/run:ro
      - /sys:/sys:ro
      - /var/lib/docker/:/var/lib/docker:ro
    command: --housekeeping_interval=5s

启动：docker-compose up -d

访问与集成

• Web UI：访问http://<主机IP>:8080查看容器监控数据
• API接口：通过http://<主机IP>:8080/api/v1.3/containers获取JSON格式监控数据
• Prometheus集成：Prometheus可通过http://<主机IP>:8080/metrics端点抓取监控指标

注意事项

• 确保主机文件系统挂载权限正确，避免因权限问题导致监控数据收集失败
• 在生产环境中建议配合持久化存储和监控告警系统使用
• 根据实际需求调整资源限制，避免cadvisor本身占用过多系统资源