KubeBolt docs
ENES GitHub

Core Concepts

Cluster Map

The Cluster Map draws your cluster's resources and how they relate, grouped by namespace, in Grid, Flow and Traffic layouts you can read and filter.

On this page
  1. Layout modes
  2. Reading and filtering the map
  3. Relationship Detection

The Cluster Map draws the active cluster’s resources and how they relate, grouped by namespace. Open it with Cluster Map in the top bar, next to Dashboard. It reads the live API connection, so it is not available on a metrics-only cluster.

Layout modes

The Cluster Map: workloads and their dependencies, laid out by namespace.
The Cluster Map: workloads and their dependencies, laid out by namespace. KubeBolt 2.1.1
Traffic mode: only the pods that appear in observed Hubble flows, with external destinations as their own nodes.
Traffic mode: only the pods that appear in observed Hubble flows, with external destinations as their own nodes. KubeBolt 2.1.1

Reading and filtering the map

Namespace regions are laid out in a grid whose column count grows with the number of visible regions (up to 4), with infrastructure namespaces and external endpoints placed last. Clicking a resource opens its details in a side panel. The configuration panel on the left holds:

The layout, the flow window, the grouping and the nodes you drag are remembered per browser, with drag positions kept separately for each layout. The map refreshes every minute and on live changes.

Relationship Detection

RelationshipDetection MethodEdge Type
Deployment → ReplicaSet → Pod, StatefulSet / DaemonSet / Job → Pod, CronJob → JobownerReferences chainowns
Service → PodsLabel selector matchingselects
Ingress → Servicespec.rules.http.paths.backendroutes
Gateway → HTTPRouteHTTPRoute spec.parentRefsroutes
HTTPRoute → Servicespec.rules.backendRefsroutes
HPA → its scale targetspec.scaleTargetRefhpa
Pod → PVCspec.volumes.persistentVolumeClaimuses
PVC → PVspec.volumeNamebound
Pod → ConfigMap / Secretvolumes (projected included)mounts
Pod → ConfigMap / SecretenvFrom and env valueFromenvFrom
Pod → Secretspec.imagePullSecretsimagePull
Caller → Service → Pod, Pod → external endpointobserved Hubble flowstraffic