d3vilh/cadvisor

cAdvisor 容器监控镜像

镜像概述

cAdvisor（Container Advisor）是一款容器监控工具，版本为0.49.1，源自https://github.com/google/cadvisor%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E6%94%AF%E6%8C%81AMD64%E3%80%81ARM64v8%E3%80%81ARM32v7%E5%92%8CARM32v5%E6%9E%B6%E6%9E%84%EF%BC%8C%E5%B7%B2%E5%9C%A8x86_64 AMD设备和树莓派上测试通过。

cAdvisor作为运行中的守护进程，为容器用户提供对容器资源使用和性能特性的深入了解。它能够收集、聚合、处理并导出有关运行中容器的信息，包括资源隔离参数、历史资源使用情况、完整历史资源使用的直方图以及网络统计数据，这些数据按容器和整机级别导出。

核心功能与特性

• 全面的容器监控：为每个容器记录资源隔离参数、历史资源使用、资源使用直方图及网络统计
• 多容器类型支持：原生支持https://github.com/docker/docker%E5%AE%B9%E5%99%A8%EF%BC%8C%E5%90%8C%E6%97%B6%E5%8F%AF%E5%BC%80%E7%AE%B1%E5%8D%B3%E7%94%A8%E5%9C%B0%E6%94%AF%E6%8C%81%E5%87%A0%E4%B9%8E%E6%89%80%E6%9C%89%E5%85%B6%E4%BB%96%E5%AE%B9%E5%99%A8%E7%B1%BB%E5%9E%8B
• 层级容器抽象：基于https://github.com/google/lmctfy%E7%9A%84%E5%AE%B9%E5%99%A8%E6%8A%BD%E8%B1%A1%EF%BC%8C%E5%AE%B9%E5%99%A8%E5%A4%A9%E7%84%B6%E6%94%AF%E6%8C%81%E5%B1%82%E7%BA%A7%E5%B5%8C%E5%A5%97
• 跨架构支持：适配AMD64、ARM64v8、ARM32v7和ARM32v5多种架构

使用场景与适用范围

• 容器资源使用监控与分析
• 容器性能特性跟踪
• 整机容器集群资源管理
• 与Prometheus、Grafana等监控工具集成构建完整监控系统

使用方法与配置说明

快速启动：在Docker容器中运行cAdvisor

通过以下Docker Compose配置可快速在本地启动cAdvisor，监控整个机器的容器状态：

yaml
---
version: "3.1"

networks:
  back-tier:

services:
  cadvisor:
    container_name: cadvisor
    image: d3vilh/cadvisor:latest
    restart: unless-stopped
    privileged: true
    command:
      - '--raw_cgroup_prefix_whitelist=/docker/'
      - '--docker_only=true'
      - '--disable_metrics=memory_numa,advtcp,cpuset,referenced_memory,cpu_topology,tcp,udp,percpu,process,hugetlb,sched'
      - '--housekeeping_interval=30s'
    volumes:
      - /:/rootfs:ro
      - /var/run:/var/run:ro
      - /sys/fs/cgroup:/cgroup:ro
      - /sys:/sys:ro
      - /var/lib/docker/:/var/lib/docker:ro
      - /etc/machine-id:/etc/machine-id:ro
    devices:
      - '/dev/kmsg:/dev/kmsg'
    ports:
      - '8081:8080/tcp'
    networks:
      - back-tier

启动后，cAdvisor将在后台运行，可通过http://localhost:8080访问Web界面。配置中包含了cAdvisor观测Docker状态所需的目录挂载。

与Grafana集成可视化

cAdvisor收集的数据可通过Grafana进行可视化展示，示例如下：

!https://github.com/d3vilh/raspberry-gateway/raw/master/images/raspi-monitoring_5.png !https://github.com/d3vilh/raspberry-gateway/raw/master/images/raspi-monitoring_6.png

与Prometheus集成

可通过以下Prometheus配置集成cAdvisor：

yaml
services:
  prometheus:
    container_name: prometheus
    image: prom/prometheus:latest
    restart: always
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
      - '--storage.tsdb.retention.time=90'
      - '--web.console.libraries=/usr/share/prometheus/console_libraries'
      - '--web.console.templates=/usr/share/prometheus/consoles'
    volumes:
      - ./prometheus/:/etc/prometheus/
      - prometheus_data:/prometheus
    ports:
      - 9090:9090
    links:
      - ping:ping
      - speedtest:speedtest
    networks:
      - back-tier

详细的Prometheus配置可参考https://github.com/d3vilh/raspberry-gateway/blob/master/templates/prometheus.yml.j2%E3%80%82

构建方法

Dockerfile

构建该镜像使用的Dockerfile如下：

dockerfile
FROM golang:buster AS builder
ARG VERSION
RUN apt-get update \
 && apt-get install make git bash gcc \
 && mkdir -p $GOPATH/src/github.com/google \
 && git clone https://github.com/google/cadvisor.git $GOPATH/src/github.com/google/cadvisor
WORKDIR $GOPATH/src/github.com/google/cadvisor
RUN git fetch --tags 
RUN git checkout $VERSION 
RUN go env -w GO111MODULE=auto
RUN make build
RUN cp ./_output/cadvisor /
# ------------------------------------------
# 从deploy/Dockerfile复制而来，移除了ARM架构Alpine上不可用的"zfs"依赖
FROM alpine:latest
MAINTAINER dengnan@google.com vmarmol@google.com vishnuk@google.com jimmidyson@gmail.com stclair@google.com
LABEL maintainer="Mr.Philipp <d3vilh@github.com>"
RUN sed -i 's,https://dl-cdn.alpinelinux.org,http://dl-4.alpinelinux.org,g' /etc/apk/repositories
RUN apk --no-cache add libc6-compat device-mapper findutils thin-provisioning-tools && \
    echo 'hosts: files mdns4_minimal [NOTFOUND=return] dns mdns4' >> /etc/nsswitch.conf && \
    rm -rf /var/cache/apk/*
# 从构建阶段复制cAdvisor
COPY --from=builder /cadvisor /usr/bin/cadvisor
EXPOSE 8080
HEALTHCHECK --interval=30s --timeout=3s \
CMD wget --quiet --tries=1 --spider http://localhost:8080/healthz || exit 1
ENTRYPOINT ["/usr/bin/cadvisor", "-logtostderr"]

构建命令

执行以下命令构建镜像：

shell
docker build --progress=plain  -t local/cadvisor .