neowaylabs/cadvisor

镜像概述

本Docker镜像基于官方Google Cadvisor构建，额外集成了findutils工具集。主要用于解决Cadvisor在部分环境中因缺少findutils（包含find、xargs等命令）导致的功能异常问题，具体参考GitHub issue: https://github.com/google/cadvisor/issues/1641%E3%80%82

核心功能和特性

• 完整保留Cadvisor原生功能：支持Docker容器资源监控，包括CPU、内存、磁盘I/O、网络等性能指标的实时收集与展示。
• 集成findutils工具：添加find、xargs等基础命令，修复原Cadvisor镜像在执行特定文件查找操作时的功能缺失问题。
• 与官方镜像兼容：基于官方Cadvisor镜像构建，保持接口和使用方式的一致性，可直接替换官方镜像使用。

使用场景和适用范围

• 需要对Docker容器进行资源监控和性能分析的环境。
• 在使用官方Cadvisor镜像时遇到因缺少findutils导致的功能异常（如文件查找失败、监控数据采集不完整等）的场景。
• 适用于开发、测试及生产环境中的容器监控需求。

使用方法和配置说明

基本使用要求

• Docker环境：需安装Docker Engine（1.12+版本推荐）。
• 权限要求：运行容器时需挂载必要的系统目录，因此可能需要--privileged权限或相应的文件系统访问权限。

Docker部署示例

基础运行命令

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

参数说明

• --privileged：赋予容器访问系统资源的权限，确保Cadvisor能正常读取主机和容器信息。
• 卷挂载：
  • /:/rootfs:ro：只读挂载主机根文件系统，用于获取系统级信息。
  • /var/run:/var/run:ro：挂载Docker socket，用于与Docker daemon通信。
  • /sys:/sys:ro：挂载sysfs，用于获取系统硬件和内核信息。
  • /var/lib/docker/:/var/lib/docker:ro：挂载Docker数据目录，用于获取容器详细信息。
• -p 8080:8080：映射容器8080端口到主机，通过http://<主机IP>:8080访问Cadvisor Web界面。

访问监控界面

启动容器后，通过浏览器访问 http://<主机IP>:8080 即可打开Cadvisor监控界面，查看主机及容器的资源使用情况。

注意事项

• 本镜像仅添加findutils工具，未修改Cadvisor核心功能，使用方式与官方镜像完全一致。
• 生产环境中建议结合持久化存储和日志收集配置，确保监控数据的可靠性。
• 根据实际需求调整资源限制（如--memory、--cpus参数），避免Cadvisor自身过度占用主机资源。