peytonyip/cadvisor

cadvisor容器监控镜像

镜像概述

cadvisor（Container Advisor）是由Google开发的开源容器监控工具，专注于收集、聚合和导出运行中容器的资源使用情况与性能指标。它能够自动发现主机上的容器，监控CPU、内存、磁盘I/O、网络等关键资源，并通过Web界面和REST API提供数据访问，同时支持与Prometheus等主流监控系统集成，是容器环境监控的核心组件之一。

核心功能与特性

• 自动容器发现：支持Docker、rkt等多种容器运行时，自动识别并监控主机上的所有容器
• 全面指标收集：实时采集容器的CPU使用率、内存使用量、磁盘读写速率、网络吞吐量等资源指标
• Web可视化界面：提供直观的Web UI，展示容器资源使用趋势图表和详细指标数据
• 开放API支持：提供RESTful API接口，便于第三方系统集成和数据查询
• 监控系统集成：原生支持Prometheus，可作为数据源无缝对接监控告警平台
• 轻量级设计：资源占用低，适合在生产环境中长时间稳定运行

使用场景与适用范围

• 容器资源监控：适用于单机Docker环境、Kubernetes集群等各类容器部署场景，监控容器资源使用状态
• 性能分析调优：通过历史数据识别容器性能瓶颈，优化资源分配策略
• 监控体系构建：作为基础监控组件，与Prometheus、Grafana等工具配合，构建完整的容器监控告警体系
• 多环境兼容：支持Linux系统及各类容器运行时，兼容主流容器编排平台

使用方法与配置说明

基本部署（Docker Run）

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

bash
docker run \
  --volume=/:/rootfs:ro \
  --volume=/var/run:/var/run:ro \
  --volume=/sys:/sys:ro \
  --volume=/var/lib/docker/:/var/lib/docker:ro \
  --volume=/dev/disk/:/dev/disk:ro \
  --publish=8080:8080 \
  --detach=true \
  --name=cadvisor \
  gcr.io/cadvisor/cadvisor:latest

参数说明：

• --volume=/:/rootfs:ro：挂载主机根文件系统（只读），用于获取系统级信息
• --volume=/var/run:/var/run:ro：挂载容器运行时socket文件，获取容器状态
• --volume=/sys:/sys:ro：挂载系统内核目录，获取硬件和内核指标
• --volume=/var/lib/docker/:/var/lib/docker:ro：挂载Docker数据目录，监控Docker容器
• --publish=8080:8080：暴露Web界面和API服务端口

Web界面访问

容器启动后，通过 http://<主机IP>:8080 访问cadvisor Web界面，可查看：

• 主机整体资源使用概况
• 所有容器的实时资源监控数据
• 容器资源使用趋势图表（支持按时间范围筛选）
• 容器详细指标（包括CPU、内存、磁盘、网络等）

API接口使用

cadvisor提供RESTful API用于数据查询，常用接口示例：

• 获取主机信息：http://<主机IP>:8080/api/v1.3/machine
• 获取容器列表：http://<主机IP>:8080/api/v1.3/containers
• 获取特定容器详情：http://<主机IP>:8080/api/v1.3/containers/<容器ID或名称>
• 获取容器CPU指标：http://<主机IP>:8080/api/v1.3/containers/<容器ID>/stats/cpu

与Prometheus集成

1. 配置Prometheus
   在Prometheus配置文件（prometheus.yml）中添加cadvisor作为数据源：

   yaml
   scrape_configs:
     - job_name: 'cadvisor'
       static_configs:
         - targets: ['<cadvisor主机IP>:8080']
   

2. 常用监控指标
   cadvisor向Prometheus暴露的核心指标包括：

   • container_cpu_usage_seconds_total：容器CPU累计使用时间
   • container_memory_usage_bytes：容器内存使用量
   • container_network_receive_bytes_total：容器网络接收字节数
   • container_network_transmit_bytes_total：容器网络发送字节数
   • container_fs_reads_bytes_total：容器磁盘读字节数
   • container_fs_writes_bytes_total：容器磁盘写字节数

高级配置参数

可通过命令行参数自定义cadvisor行为，常用参数：

• --storage_duration：数据存储时长（默认2分钟，格式：1m、5m等）
• --housekeeping_interval：数据收集间隔（默认10秒，格式：5s、10s等）
• --max_housekeeping_interval：最大数据收集间隔（默认30秒）
• --disable_metrics：禁用指定指标（如"cpu,memory"）

示例（调整数据存储时长和收集间隔）：

bash
docker run \
  --volume=/:/rootfs:ro \
  --volume=/var/run:/var/run:ro \
  --volume=/sys:/sys:ro \
  --volume=/var/lib/docker/:/var/lib/docker:ro \
  --publish=8080:8080 \
  --detach=true \
  --name=cadvisor \
  gcr.io/cadvisor/cadvisor:latest \
  --storage_duration=5m \
  --housekeeping_interval=5s

注意事项

• 部署时需确保挂载必要的主机目录（/、/var/run、/sys、/var/lib/docker等），否则可能导致监控数据不完整
• 在Kubernetes环境中，建议通过DaemonSet方式部署，实现集群内所有节点的容器监控
• 对于大规模容器环境，建议结合Prometheus+Grafana使用，以实现数据持久化和高级可视化
• 生产环境中可通过设置资源限制（--memory、--cpus）避免cadvisor自身过度占用主机资源