Skip to content

Network Topology

Interactive map of how the cluster's network is wired. Renders nodes, bridges, bonds, VLANs, uplinks and the VMs attached to each bridge. Useful for change-tickets ("show me what touches vmbr2 before we shut down the uplink") and for catching mis-cabled bonds.

What's drawn

  • Nodes - one per PVE host.
  • Bonds (bond0, bond1, …) with mode (active-backup / 802.3ad / balance-alb), slave NICs, link state.
  • Bridges (vmbr0, …) with attached interfaces, VLAN aware flag, MTU.
  • VLANs - tagged sub-interfaces, hovering shows trunked VIDs.
  • VMs / CTs - leaf nodes attached to the bridge they live on, click to jump into the VM detail.

UX

  • SVG renderer with zoom (mouse wheel) + pan (drag), arrow-key shortcuts.
  • Search by interface name, MAC, VM name, VMID - matches highlight + auto-pan.
  • Optional traffic overlay: link width scales with current Mbps from the metrics exporter.
  • PDF / PNG snapshot button - drops the current viewport into a printable page.

API

Method Endpoint Description
GET /api/clusters/{id}/topology Returns {cluster, nodes:[{id,kind,label,parent_id,meta}], links:[{source,target,kind}], counts} where kind ∈ cluster | node | bridge | bond | sdn_vnet | vm | ct