How google/cadvisor works
cAdvisor is a running container-monitoring daemon: it discovers container and machine state, gathers and retains resource statistics, then exposes them through its web UI, REST API, Prometheus endpoint, and optional storage drivers. Its container support spans Docker, Podman, containerd, CRI-O, and generic/raw containers. The graph emphasizes those product stages and the manager/cache layer. Some subsystem links rely on README descriptions; unsampled implementation details are not treated as inspected evidence.
Main entry points: manager.go Container Manager · container.go Resource Data Model · handlers.go HTTP Routing · handler.go Docker Handler
Components 26
Runtime Discovery
- Docker Handler
container/docker/handler.go - Podman Handler
container/podman/handler.go - containerd Handler
lib/container/containerd/handler.go - CRI-O Handler
lib/container/crio/handler.go - libcontainer Handler
lib/container/libcontainer/handler.go - Raw Handler
lib/container/raw/handler.go - Machine Info
lib/machine/machine.go
Collection and State
- Container Manager
lib/manager/manager.go - Resource Data Model
lib/model/container.go - Memory Cache
lib/cache/memory/memory.go - Container Events
events/handler.go - Perf Metrics
perf/manager_libpfm.go - Resctrl Metrics
resctrl/intel/manager.go
User Interfaces
- HTTP Routing
cmd/internal/http/handlers.go - Versioned REST API
cmd/internal/api/handler.go - Web UI
cmd/internal/pages/pages.go - Prometheus Export
lib/metrics/prometheus.go - Validation Endpoint
validate/validate.go - Go API Client
client/client.go
Storage Export
- Storage Registry
lib/storage/storage.go - BigQuery Driver
cmd/internal/storage/bigquery/bigquery.go - Other Storage Drivers
cmd/internal/storage
Other components
- Host and Containers
- cAdvisor Daemon
- BigQuery
- Operator or Client
Connections 35
- Host and Containers → cAdvisor Daemon: monitored by
README.md - cAdvisor Daemon → Container Manager: manages
- Container Manager → Raw Handler: registers
lib/manager/manager.go - Docker Handler → libcontainer Handler: uses
container/docker/handler.go - Docker Handler → containerd Handler: uses client
container/docker/handler.go - Docker Handler → Machine Info: reads info
container/docker/handler.go - Docker Handler → Resource Data Model: produces data
- Podman Handler → libcontainer Handler: uses
container/podman/handler.go - Podman Handler → Resource Data Model: produces data
- containerd Handler → Resource Data Model: uses model
lib/container/containerd/handler.go - CRI-O Handler → Resource Data Model: uses model
lib/container/crio/handler.go - libcontainer Handler → Resource Data Model: uses model
lib/container/libcontainer/handler.go - Raw Handler → Machine Info: reads info
lib/container/raw/handler.go - Raw Handler → Resource Data Model: uses model
lib/container/raw/handler.go - Container Manager → Machine Info: reads info
lib/manager/manager.go - Container Manager → Memory Cache: uses cache
lib/manager/manager.go - Container Manager → Resource Data Model: maintains
- Container Manager → Container Events: emits events
lib/manager/manager.go - Perf Metrics → Resource Data Model: collects metrics
perf/manager_libpfm.go - Resctrl Metrics → Raw Handler: uses container IDs
resctrl/intel/manager.go - HTTP Routing → Versioned REST API: registers routes
cmd/internal/http/handlers.go - HTTP Routing → Web UI: registers pages
cmd/internal/http/handlers.go - HTTP Routing → Validation Endpoint: routes requests
cmd/internal/http/handlers.go - HTTP Routing → Container Manager: serves metrics
cmd/internal/http/handlers.go - Prometheus Export → Resource Data Model: reads metrics
lib/metrics/prometheus.go - Versioned REST API → Container Manager: serves data
cmd/internal/api/handler.go - Versioned REST API → Container Events: serves events
cmd/internal/api/handler.go - Operator or Client → HTTP Routing: requests
README.md - Operator or Client → Go API Client: uses
- Go API Client → Versioned REST API: calls remotely
- Container Manager → Memory Cache: stores stats
- Storage Registry → BigQuery Driver: registers driver
cmd/internal/storage/bigquery/bigquery.go - Storage Registry → Other Storage Drivers: registers drivers
- Memory Cache → Storage Registry: forwards stats
- BigQuery Driver → BigQuery: writes rows
cmd/internal/storage/bigquery/bigquery.go