# google/cadvisor architecture

> Architecture diagram of the GitHub repository google/cadvisor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/google/cadvisor
- Repository: https://github.com/google/cadvisor

## Overview

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: [`lib/manager/manager.go`](https://github.com/google/cadvisor/blob/master/lib/manager/manager.go) (Container Manager), [`lib/model/container.go`](https://github.com/google/cadvisor/blob/master/lib/model/container.go) (Resource Data Model), [`cmd/internal/http/handlers.go`](https://github.com/google/cadvisor/blob/master/cmd/internal/http/handlers.go) (HTTP Routing), [`container/docker/handler.go`](https://github.com/google/cadvisor/blob/master/container/docker/handler.go) (Docker Handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime Discovery"]
  node_docker["Docker Handler<br/>[handler.go]"]
  node_podman["Podman Handler<br/>[handler.go]"]
  node_containerd["containerd Handler<br/>[handler.go]"]
  node_crio["CRI-O Handler<br/>[handler.go]"]
  node_libcontainer["libcontainer Handler<br/>[handler.go]"]
  node_raw["Raw Handler<br/>[handler.go]"]
  node_machine["Machine Info<br/>[machine.go]"]
end

subgraph group_collection["Collection and State"]
  node_manager["Container Manager<br/>[manager.go]"]
  node_model["Resource Data Model<br/>[container.go]"]
  node_memory[("Memory Cache<br/>[memory.go]")]
  node_events["Container Events<br/>[handler.go]"]
  node_perf["Perf Metrics<br/>[manager_libpfm.go]"]
  node_resctrl["Resctrl Metrics<br/>[manager.go]"]
end

subgraph group_exposure["User Interfaces"]
  node_http["HTTP Routing<br/>[handlers.go]"]
  node_api["Versioned REST API<br/>[handler.go]"]
  node_pages["Web UI<br/>[pages.go]"]
  node_prometheus["Prometheus Export<br/>[prometheus.go]"]
  node_validate["Validation Endpoint<br/>[validate.go]"]
  node_client["Go API Client<br/>[client.go]"]
end

subgraph group_storage["Storage Export"]
  node_storage["Storage Registry<br/>[storage.go]"]
  node_bigquery["BigQuery Driver<br/>[bigquery.go]"]
  node_otherdrivers["Other Storage Drivers"]
end

node_host(("Host and Containers"))
node_daemon["cAdvisor Daemon"]
node_bigqueryservice[("BigQuery")]
node_user(("Operator or Client"))

node_host -->|"monitored by"| node_daemon
node_daemon -.->|"manages"| node_manager
node_manager -->|"registers"| node_raw
node_docker -->|"uses"| node_libcontainer
node_docker -->|"uses client"| node_containerd
node_docker -->|"reads info"| node_machine
node_docker -.->|"produces data"| node_model
node_podman -->|"uses"| node_libcontainer
node_podman -.->|"produces data"| node_model
node_containerd -->|"uses model"| node_model
node_crio -->|"uses model"| node_model
node_libcontainer -->|"uses model"| node_model
node_raw -->|"reads info"| node_machine
node_raw -->|"uses model"| node_model
node_manager -->|"reads info"| node_machine
node_manager -->|"uses cache"| node_memory
node_manager -.->|"maintains"| node_model
node_manager -->|"emits events"| node_events
node_perf -->|"collects metrics"| node_model
node_resctrl -->|"uses container IDs"| node_raw
node_http -->|"registers routes"| node_api
node_http -->|"registers pages"| node_pages
node_http -->|"routes requests"| node_validate
node_http -->|"serves metrics"| node_manager
node_prometheus -->|"reads metrics"| node_model
node_api -->|"serves data"| node_manager
node_api -->|"serves events"| node_events
node_user -->|"requests"| node_http
node_user -->|"uses"| node_client
node_client -->|"calls remotely"| node_api
node_manager -.->|"stores stats"| node_memory
node_storage -->|"registers driver"| node_bigquery
node_storage -->|"registers drivers"| node_otherdrivers
node_memory -.->|"forwards stats"| node_storage
node_bigquery -->|"writes rows"| node_bigqueryservice

click node_docker "https://github.com/google/cadvisor/blob/master/container/docker/handler.go"
click node_podman "https://github.com/google/cadvisor/blob/master/container/podman/handler.go"
click node_containerd "https://github.com/google/cadvisor/blob/master/lib/container/containerd/handler.go"
click node_crio "https://github.com/google/cadvisor/blob/master/lib/container/crio/handler.go"
click node_libcontainer "https://github.com/google/cadvisor/blob/master/lib/container/libcontainer/handler.go"
click node_raw "https://github.com/google/cadvisor/blob/master/lib/container/raw/handler.go"
click node_machine "https://github.com/google/cadvisor/blob/master/lib/machine/machine.go"
click node_manager "https://github.com/google/cadvisor/blob/master/lib/manager/manager.go"
click node_model "https://github.com/google/cadvisor/blob/master/lib/model/container.go"
click node_memory "https://github.com/google/cadvisor/blob/master/lib/cache/memory/memory.go"
click node_events "https://github.com/google/cadvisor/blob/master/events/handler.go"
click node_perf "https://github.com/google/cadvisor/blob/master/perf/manager_libpfm.go"
click node_resctrl "https://github.com/google/cadvisor/blob/master/resctrl/intel/manager.go"
click node_http "https://github.com/google/cadvisor/blob/master/cmd/internal/http/handlers.go"
click node_api "https://github.com/google/cadvisor/blob/master/cmd/internal/api/handler.go"
click node_pages "https://github.com/google/cadvisor/blob/master/cmd/internal/pages/pages.go"
click node_prometheus "https://github.com/google/cadvisor/blob/master/lib/metrics/prometheus.go"
click node_validate "https://github.com/google/cadvisor/blob/master/validate/validate.go"
click node_client "https://github.com/google/cadvisor/blob/master/client/client.go"
click node_storage "https://github.com/google/cadvisor/blob/master/lib/storage/storage.go"
click node_bigquery "https://github.com/google/cadvisor/blob/master/cmd/internal/storage/bigquery/bigquery.go"
click node_otherdrivers "https://github.com/google/cadvisor/tree/master/cmd/internal/storage"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_docker,node_podman,node_containerd,node_crio,node_libcontainer,node_raw,node_machine,node_user toneBlue
class node_manager,node_model,node_memory,node_events,node_perf,node_resctrl,node_bigqueryservice toneAmber
class node_http,node_api,node_pages,node_prometheus,node_validate,node_client toneMint
class node_storage,node_bigquery,node_otherdrivers toneRose
class node_host,node_daemon toneIndigo
```

## Components

### Runtime Discovery

- [Docker Handler](https://github.com/google/cadvisor/blob/master/container/docker/handler.go): `container/docker/handler.go`
- [Podman Handler](https://github.com/google/cadvisor/blob/master/container/podman/handler.go): `container/podman/handler.go`
- [containerd Handler](https://github.com/google/cadvisor/blob/master/lib/container/containerd/handler.go): `lib/container/containerd/handler.go`
- [CRI-O Handler](https://github.com/google/cadvisor/blob/master/lib/container/crio/handler.go): `lib/container/crio/handler.go`
- [libcontainer Handler](https://github.com/google/cadvisor/blob/master/lib/container/libcontainer/handler.go): `lib/container/libcontainer/handler.go`
- [Raw Handler](https://github.com/google/cadvisor/blob/master/lib/container/raw/handler.go): `lib/container/raw/handler.go`
- [Machine Info](https://github.com/google/cadvisor/blob/master/lib/machine/machine.go): `lib/machine/machine.go`

### Collection and State

- [Container Manager](https://github.com/google/cadvisor/blob/master/lib/manager/manager.go): `lib/manager/manager.go`
- [Resource Data Model](https://github.com/google/cadvisor/blob/master/lib/model/container.go): `lib/model/container.go`
- [Memory Cache](https://github.com/google/cadvisor/blob/master/lib/cache/memory/memory.go): `lib/cache/memory/memory.go`
- [Container Events](https://github.com/google/cadvisor/blob/master/events/handler.go): `events/handler.go`
- [Perf Metrics](https://github.com/google/cadvisor/blob/master/perf/manager_libpfm.go): `perf/manager_libpfm.go`
- [Resctrl Metrics](https://github.com/google/cadvisor/blob/master/resctrl/intel/manager.go): `resctrl/intel/manager.go`

### User Interfaces

- [HTTP Routing](https://github.com/google/cadvisor/blob/master/cmd/internal/http/handlers.go): `cmd/internal/http/handlers.go`
- [Versioned REST API](https://github.com/google/cadvisor/blob/master/cmd/internal/api/handler.go): `cmd/internal/api/handler.go`
- [Web UI](https://github.com/google/cadvisor/blob/master/cmd/internal/pages/pages.go): `cmd/internal/pages/pages.go`
- [Prometheus Export](https://github.com/google/cadvisor/blob/master/lib/metrics/prometheus.go): `lib/metrics/prometheus.go`
- [Validation Endpoint](https://github.com/google/cadvisor/blob/master/validate/validate.go): `validate/validate.go`
- [Go API Client](https://github.com/google/cadvisor/blob/master/client/client.go): `client/client.go`

### Storage Export

- [Storage Registry](https://github.com/google/cadvisor/blob/master/lib/storage/storage.go): `lib/storage/storage.go`
- [BigQuery Driver](https://github.com/google/cadvisor/blob/master/cmd/internal/storage/bigquery/bigquery.go): `cmd/internal/storage/bigquery/bigquery.go`
- [Other Storage Drivers](https://github.com/google/cadvisor/tree/master/cmd/internal/storage): `cmd/internal/storage`

### Other components

- **Host and Containers**
- **cAdvisor Daemon**
- **BigQuery**
- **Operator or Client**

## Connections

- Host and Containers → cAdvisor Daemon: monitored by (evidence: `README.md`)
- cAdvisor Daemon → Container Manager: manages
- Container Manager → Raw Handler: registers (evidence: `lib/manager/manager.go`)
- Docker Handler → libcontainer Handler: uses (evidence: `container/docker/handler.go`)
- Docker Handler → containerd Handler: uses client (evidence: `container/docker/handler.go`)
- Docker Handler → Machine Info: reads info (evidence: `container/docker/handler.go`)
- Docker Handler → Resource Data Model: produces data
- Podman Handler → libcontainer Handler: uses (evidence: `container/podman/handler.go`)
- Podman Handler → Resource Data Model: produces data
- containerd Handler → Resource Data Model: uses model (evidence: `lib/container/containerd/handler.go`)
- CRI-O Handler → Resource Data Model: uses model (evidence: `lib/container/crio/handler.go`)
- libcontainer Handler → Resource Data Model: uses model (evidence: `lib/container/libcontainer/handler.go`)
- Raw Handler → Machine Info: reads info (evidence: `lib/container/raw/handler.go`)
- Raw Handler → Resource Data Model: uses model (evidence: `lib/container/raw/handler.go`)
- Container Manager → Machine Info: reads info (evidence: `lib/manager/manager.go`)
- Container Manager → Memory Cache: uses cache (evidence: `lib/manager/manager.go`)
- Container Manager → Resource Data Model: maintains
- Container Manager → Container Events: emits events (evidence: `lib/manager/manager.go`)
- Perf Metrics → Resource Data Model: collects metrics (evidence: `perf/manager_libpfm.go`)
- Resctrl Metrics → Raw Handler: uses container IDs (evidence: `resctrl/intel/manager.go`)
- HTTP Routing → Versioned REST API: registers routes (evidence: `cmd/internal/http/handlers.go`)
- HTTP Routing → Web UI: registers pages (evidence: `cmd/internal/http/handlers.go`)
- HTTP Routing → Validation Endpoint: routes requests (evidence: `cmd/internal/http/handlers.go`)
- HTTP Routing → Container Manager: serves metrics (evidence: `cmd/internal/http/handlers.go`)
- Prometheus Export → Resource Data Model: reads metrics (evidence: `lib/metrics/prometheus.go`)
- Versioned REST API → Container Manager: serves data (evidence: `cmd/internal/api/handler.go`)
- Versioned REST API → Container Events: serves events (evidence: `cmd/internal/api/handler.go`)
- Operator or Client → HTTP Routing: requests (evidence: `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 (evidence: `cmd/internal/storage/bigquery/bigquery.go`)
- Storage Registry → Other Storage Drivers: registers drivers
- Memory Cache → Storage Registry: forwards stats
- BigQuery Driver → BigQuery: writes rows (evidence: `cmd/internal/storage/bigquery/bigquery.go`)
