docs/npm/topology/README.md
Netdata shows you how your infrastructure is connected — which device links to which, which service depends on which, and where each part sits — built automatically from what you already monitor.
Two maps, in the same view:
Neither needs topology-specific setup: once you are monitoring the devices and running Agents on the hosts, the maps build themselves. There is nothing to instrument, no topology to declare, and no diagram to maintain.
The topology view, assembled automatically from the devices you already monitor — Layer 2 and Layer 3 links, kept current as devices come and go.
When Netdata monitors your SNMP devices, it reads what they already know about their neighbors and assembles the topology, with no extra setup:
The result is a live Layer 2 and Layer 3 map, kept current as devices come and go. Each link carries the evidence behind it — how it was discovered and how confident Netdata is in it — so a confirmed link is distinguishable from an inferred one.
The device fabric tells you how the wires run. On a monitored host, Netdata also reads the kernel's live socket table
and maps the software: what each process is talking to, and on Linux which container, image, systemd unit, or
Kubernetes pod, namespace, and workload owns it — without instrumenting any of it (topology:network-connections).
You can regroup that map by process name, container, or PID, so you can look at the host at whichever level answers your question — the services it runs, or exactly which worker process opened a connection.
The map is available on Linux, FreeBSD, and macOS; container and Kubernetes attribution is Linux-only. A host install needs nothing configured. Running the Agent in a container needs a few extra privileges, which Application Dependency Mapping lists.
Live host and service connections (topology:network-connections) appear in the same topology view, alongside your device fabric.
See Application Dependency Mapping for what it maps and how to use it.
The topology view brings in the rest of your infrastructure in the same form, so it all sits together:
topology:streaming).topology:vsphere).topology:cato_networks).The device fabric (topology:snmp) and application dependencies come up on their own once the devices and hosts are monitored. The streaming map appears once Agents are streaming to a Parent (configured in stream.conf); vSphere and Cato come from their own collectors, configured separately.