How esdmitrii/kconmon-ng works
kconmon-ng measures connectivity between cluster nodes and presents the results for operators. Agents register with the controller, receive peer assignments, run protocol-specific probes, and report measurements; the console turns those results into matrices, topology, diagnostics, and incident history, with a CLI for controller diagnostics. The README documents the product workflow and capabilities; source excerpts and the index support the principal wiring shown here, while some unsampled subsystem links are intentionally omitted.
Main entry points: server.go Controller RPC · controller.go Controller · grpc_client.go Agent RPC client · main.go Console service
Components 19
Measurement
- Node agent
internal/agent/agent.go - Probe tasks
internal/agent/tasks.go - Protocol probes
internal/checker - PMTU search
internal/checker/pmtu_search.go - Probe responder
internal/agent/probe_server.go
Control plane
- Agent RPC client
internal/agent/grpc_client.go - Controller
internal/controller/controller.go - Peer mesh planner
internal/controller/meshplan/meshplan.go - Controller RPC
internal/controller/server.go
Console
- Console service
cmd/console/main.go - HTTP API
internal/console/httpapi/server.go - Event ingester
internal/console/events/ingester.go - Diagnostic runs
internal/console/checks/runner.go - Event history
internal/console/store/events.go
Operator interfaces
- Web console
web/src/pages/overview.tsx - kubectl plugin
internal/cli
Telemetry
- Prometheus
- Prometheus metrics
internal/metrics/prometheus.go
Other components
- Operator
Connections 21
- Operator → Web console: investigates
- Operator → kubectl plugin: runs diagnostics
- Web console → HTTP API: requests data
- kubectl plugin → Controller RPC: queries diagnostics
- Node agent → Probe tasks: runs checks
- Probe tasks → Protocol probes: executes probes
internal/agent/tasks.go - Protocol probes → PMTU search: searches MTU
- Agent RPC client → Probe tasks: dispatches tasks
internal/agent/grpc_client.go - Node agent → Agent RPC client: registers and reports
- Controller → Peer mesh planner: builds peer plan
internal/controller/controller.go - Controller → Controller RPC: hosts service
- Agent RPC client → Controller: registers agents
- Controller RPC → Agent RPC client: sends assignments
- Console service → HTTP API: mounts routes
cmd/console/main.go - Console service → Event ingester: starts ingestion
cmd/console/main.go - Console service → Diagnostic runs: creates runner
cmd/console/main.go - Event ingester → Event history: persists events
internal/console/events/ingester.go - Event ingester → Controller RPC: watches events
internal/console/events/ingester.go - HTTP API → Controller RPC: requests topology
internal/console/httpapi/server.go - Prometheus → Prometheus metrics: scrapes
- Controller → Prometheus metrics: exports measurements
internal/controller/controller.go