Cluster topology

See the whole cluster at a glance

An interactive map of nodes, shards, replicas and Keeper quorum — live replication links, health states and per-node metrics, drawn from system tables.

Livehealth states per node
Keeperquorum with leader and followers
Virtualoverlapping logical clusters
0 configbuilt from system tables
01 · The map

Shards, replicas and Keeper in one picture

chmonitor draws your physical and logical clusters from system.clusters and system.zookeeper — ClickHouse nodes grouped by shard, replicas linked, and the Keeper ensemble with its current leader.

  • Physical and logical clusters, overlapping virtual clusters
  • Replication links between replicas
  • Inspector panel with quorum health and znode count
02 · Node health

Per-node vitals, color-coded

Every node carries live CPU, memory and latency. Healthy, warning and unreachable states are visible from across the room — no drilling into host pages to find the sick replica.

  • Per-node CPU, memory and latency
  • Healthy / warn / unreachable states
  • Click any node for its detail view
Gallery

More of Cluster topology in action

Capabilities

Everything in the box

Shard layout

Nodes grouped by shard with replica links.

Keeper quorum

Leader, followers and znode counts live.

Virtual clusters

Overlapping logical clusters rendered as overlays.

Node vitals

CPU, memory and latency per node.

Health states

Healthy, warning and unreachable at a glance.

Inspector

Click any element for its details.

FAQ

Common questions

Does it work without Keeper / ZooKeeper?

Yes. system.zookeeper is treated as optional — single-node and non-replicated setups render the map without the Keeper ensemble.

How is the topology discovered?

Entirely from system tables (clusters, replicas, zookeeper). No agents and no extra configuration.

Does the map update live?

Yes — health states and metrics refresh on the standard dashboard interval.

Start monitoring — advisor and alerts built in

Open the hosted dashboard and connect a cluster, or self-host with Docker, Kubernetes, or from source. Self-hosting is always free.