Service flow map
The flow map puts one service (or a DB, external system or queue) in the middle: its callers are drawn to the left, what it calls and what those call to the right, layer by layer. APM must be on (see APM).
Flow map
- Open APM → Services → Topology, pick the range at the top (e.g. Last 1 hour) and the environment if needed. The whole map is drawn.
- Click a node. The map puts it in the middle and the Flow map · Focus: bar appears at the top. It also opens from a service page: APM → Services → → Flow map.
- In Callers and Callees pick how many steps back and forward to go (0-5; default 1 back, 2 forward).
- A node with +N on its side has N neighbours not drawn. Click +N and they open in place; − closes them, Close opened nodes closes all.
- The arrow in a node's bottom-right corner opens the service page (the detail page for a DB, external system or queue). Whole map leaves the focus; the browser's Back button returns to the previous focus.
- Check: the address bar shows parameters such as
focus=payments,in=1,out=3,open=service:orders. Sharing the link opens the same map.
Colours and lines
| What you see | Meaning |
|---|---|
| Green stripe on the node's left | error rate under 1%, p95 under 500 ms |
| Orange stripe | error rate 1% or p95 500 ms and above |
| Red stripe | error rate 5% or p95 2 s and above |
| Thick orange border | the node in focus |
| Box with cut corners | load balancer or proxy (nginx, envoy, HAProxy) |
| Dashed box | DB, external system or messaging |
| Arrow thickness | calls in the range |
| Red arrow | a call with errors |
Hover an arrow for its calls and p50/p95/p99.
Node limit
The map draws at most 60 nodes. The neighbours that do not fit are hidden starting from the least called links, stay as +N on the node's side, and a "The map draws at most 60 nodes" note appears above the map. Nodes opened with +N do not count toward this limit (at most 50 per node, 300 in total).
If the focus service got no calls in the chosen range, the map draws it alone and says "No calls seen for in this range". Widen the range (e.g. Last 24 hours) or go back to Whole map.
Table
The Table button shows the links with the same focus, steps and opened nodes as a table: caller, callee, requests/min, calls, p50, p95, p99, error % and the load balancers in between.
API
The same map is read with GET /api/v1/apm/topology?focus=payments&in=1&out=2&limit=60&open=service:orders. focus is a service name or a node id (db:postgresql/shop, external:api.example.com, messaging:kafka/orders); without it the whole map comes back. Each node carries layer (0 the focus, negative callers, positive callees), hiddenIn and hiddenOut; each link count, p50Ms, p95Ms, p99Ms. Details: API reference.