imdevesh/cadvisor

cAdvisor Docker镜像文档

镜像概述和主要用途

cAdvisor（Container Advisor）为容器用户提供对运行中容器资源使用情况和性能特性的理解。它是一个运行的守护进程，负责收集、聚合、处理和导出有关运行中容器的信息。具体而言，它为每个容器保留资源隔离参数、历史资源使用情况、完整历史资源使用的直方图以及网络统计数据。这些数据按容器和整机范围导出。

核心功能和特性

• 容器支持：原生支持Docker容器，理论上支持几乎所有其他容器类型
• 数据收集：收集资源隔离参数、历史资源使用、网络统计等关键指标
• 层次结构：基于lmctfy的容器抽象，容器具有固有的嵌套层次结构
• 多平台兼容：可在多种操作系统和容器环境中运行

使用场景和适用范围

• 监控单台机器上的容器资源使用情况
• 分析容器性能特性和资源瓶颈
• 为容器编排平台（如Kubernetes）提供性能数据
• 构建容器监控和管理系统

使用方法和配置说明

快速开始：在Docker容器中运行cAdvisor

要在Docker环境中快速试用cAdvisor，可使用包含所有必要组件的Docker镜像。单个cAdvisor即可监控整个机器，运行以下命令：

bash
VERSION=v0.47.0 # 使用最新版本，可从https://github.com/SeptBlast/cadvisor/releases获取
sudo 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 \
  --privileged \
  --device=/dev/kmsg \
  gcr.io/cadvisor/cadvisor:$VERSION

cAdvisor将在后台运行，可通过http://localhost:8080访问。此设置包含cAdvisor观察Docker状态所需的目录。

注意：如果在CentOS、Fedora或RHEL（或使用LXC）上运行，请查看运行说明。

其他运行方式

• 独立运行：有关在Docker外部独立运行cAdvisor的详细说明，请参见独立运行文档
• 高级配置：高级用例可参考cAdvisor运行选项
• 自定义镜像构建：如需构建自己的cAdvisor Docker镜像，请参见部署页面

Kubernetes部署

对于Kubernetes用户，cAdvisor可作为守护进程集运行。有关入门说明以及如何https://github.com/kubernetes-sigs/kustomize#kustomize%E4%BB%A5%E6%BB%A1%E8%B6%B3%E9%9C%80%E6%B1%82%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81Kubernetes%E9%83%A8%E7%BD%B2%E6%96%87%E6%A1%A3%E3%80%82

构建和测试

有关构建和测试的详细说明，请参见构建页面，包括构建和部署cAdvisor Docker镜像的说明。

导出统计数据

cAdvisor支持将统计数据导出到各种存储插件。有关更多详细信息和示例，请参见存储文档。

Web UI

cAdvisor在其端口上公开Web UI：

http://<主机名>:<端口>/

有关更多详细信息，请参见Web UI文档。

远程REST API和客户端

cAdvisor通过版本化的远程REST API公开其原始和处理后的统计数据。有关更多信息，请参见API的文档。

在client/目录中还有官方的Go客户端实现。有关更多信息，请参见客户端文档。

路线图

cAdvisor旨在改善运行中容器的资源使用和性能特性。目前，我们收集并向用户公开这些信息。未来规划包括：

• 提供容器性能建议（例如：当容器受到其他容器负面影响时，或未获得所需资源时等）
• 基于建议自动调整容器性能
• 为集群调度器和编排层提供使用预测

社区

欢迎贡献、提问和评论！cAdvisor开发人员在Slack的#sig-node频道（通过此处获取邀请）交流。我们还有discuss.kubernetes.io。

请加入并参与项目，我们正在积极寻找更多贡献者！

核心团队

• https://github.com/bobbypage
• https://github.com/iwankgb
• https://github.com/creatone
• https://github.com/dims
• https://github.com/mrunalp

频繁贡献者

• https://github.com/haircommander

荣誉退休成员

• https://github.com/dashpole
• https://github.com/dchen1107
• https://github.com/derekwaynecarr