cpatscheider/cadvisor

镜像概述

该镜像提供Google Cadvisor（Container Advisor）的多平台构建版本，支持不同硬件架构。Cadvisor是一款开源容器监控工具，能够收集、聚合和导出运行中容器的资源使用情况及性能指标，帮助用户实时监控容器状态。

核心功能与特性

• 多平台支持：提供针对不同硬件架构（如amd64、arm64等）的构建版本，适配多种运行环境。
• 全面监控：实时收集容器的CPU使用率、内存消耗、网络I/O、磁盘I/O等关键指标。
• 指标导出：支持将监控数据导出至Prometheus、InfluxDB等主流监控系统，便于数据持久化和分析。
• 轻量级设计：资源占用低，可在容器环境中高效运行，对宿主系统影响小。
• 自动发现：自动检测并监控主机上运行的所有容器，无需手动配置。

使用场景与适用范围

• 容器监控：适用于需要实时监控Docker容器资源使用情况的场景。
• 性能分析：帮助开发和运维人员分析容器性能瓶颈，优化资源配置。
• 资源优化：通过监控数据调整容器资源限制（如CPU、内存配额），提高资源利用率。
• 多架构环境：在混合架构（如x86与ARM服务器）的容器集群中提供统一监控能力。

使用方法与配置说明

基本运行命令

通过以下命令启动Cadvisor容器，默认暴露8080端口提供Web界面和API：

bash
docker run -d \
  --name cadvisor \
  --privileged \
  -p 8080:8080 \
  -v /:/rootfs:ro \
  -v /var/run:/var/run:ro \
  -v /sys:/sys:ro \
  -v /var/lib/docker/:/var/lib/docker:ro \
  gcr.io/cadvisor/cadvisor:latest

关键参数说明

• --privileged：赋予容器访问系统资源的权限，确保Cadvisor能收集完整的容器信息。
• 挂载卷说明：
  • /:/rootfs:ro：只读挂载根文件系统，用于获取系统级信息。
  • /var/run:/var/run:ro：挂载Docker运行时目录，获取容器元数据。
  • /sys:/sys:ro：挂载sysfs，收集系统硬件和内核信息。
  • /var/lib/docker/:/var/lib/docker:ro：挂载Docker数据目录，获取容器详细信息。

环境变量与配置选项

Cadvisor支持通过命令行参数调整配置，常用参数包括：

• --port：指定HTTP服务端口，默认8080。
• --storage_driver：指定存储驱动（如prometheus、influxdb），用于数据持久化。
• --housekeeping_interval：数据收集间隔时间，默认1秒。
• --max_housekeeping_interval：最大数据收集间隔，默认1分钟。

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

bash
docker run -d \
  --name cadvisor \
  --privileged \
  -p 8080:8080 \
  -v /:/rootfs:ro \
  -v /var/run:/var/run:ro \
  -v /sys:/sys:ro \
  -v /var/lib/docker/:/var/lib/docker:ro \
  gcr.io/cadvisor/cadvisor:latest \
  --storage_driver=prometheus \
  --housekeeping_interval=5s

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  cadvisor:
    image: gcr.io/cadvisor/cadvisor:latest
    container_name: cadvisor
    privileged: true
    ports:
      - "8080:8080"
    volumes:
      - /:/rootfs:ro
      - /var/run:/var/run:ro
      - /sys:/sys:ro
      - /var/lib/docker/:/var/lib/docker:ro
    command: --storage_driver=prometheus --housekeeping_interval=5s
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问与验证

启动后，通过http://<主机IP>:8080访问Cadvisor Web界面，可查看容器列表、资源使用图表及详细指标。API端点http://<主机IP>:8080/metrics提供Prometheus格式的监控数据，可配置Prometheus进行数据抓取。