Skip to Content
ModulesTopology & Service Map

Topology & Service Map

The Topology module provides a real-time, interactive service dependency map of your infrastructure. It visualizes how services connect, where traffic flows, and which components are healthy or degraded.

Key Features

  • Auto-generated topology — Built from trace data (APM service map), CMDB relationships, and Edge Agent discovery
  • Real-time health overlay — Nodes and edges change color based on current health (green, yellow, red)
  • List and graph views — Switch between list (services with request/error counts) and graph (nodes and edges)
  • Time range — Set from / to to scope the service map to a time window
  • Impact analysis — In incident context, topology shows affected services and blast radius (see Incidents); select a node to see upstream/downstream impact
  • Blast radius — See which services would be affected if a component fails (API: /api/topology/blast-radius, used in incident evidence)
  • Graph and Graph Explorer — For infrastructure-level topology, use Graph (/graph) or Graph Explorer (/graph-explorer) from the command palette (e.g. Cmd+K → “Graph”); node types include service, database, queue, cache, load balancer, gateway, storage, external

How to Access

  • Primary: OBSERVE in the left sidebar → Topology. The route is /service-map. You see either a list of services with request/error counts or a graph of nodes and edges (toggle view).
  • From incidents: When viewing an incident, the Evidence panel can show Incident Impact Topology — a subgraph of services related to the incident with health overlay (red = affected).
  • Advanced: Open the command palette (Cmd+K / Ctrl+K), type Graph or Graph Explorer, to open the full infrastructure topology (nodes by type: service, database, queue, cache, etc.).

Topology / Service Map — list or graph view with sample services

Capture from: Tenant Plane → OBSERVE → Topology (Service Map), with sample data. Add your screenshot as public/img/topology-service-map.png.

Basic Usage

  1. Open Topology (Service Map) from OBSERVE in the sidebar.
  2. Set time range (from / to) so the map reflects the desired window; the map loads from /api/apm/service-map.
  3. Switch between list and graph view: list shows service names with request and error counts; graph shows nodes and edges.
  4. In the graph, zoom and pan to explore; click a node to see details.
  5. For blast radius and impact from an incident, open the incident and use the Evidence panel → topology attachment, or use RCA (topology is used in root-cause analysis).
  6. For infrastructure-level topology (layers, node types), use Graph or Graph Explorer from the command palette.

See also

APMCMDB