SpitfireLoad Testing & APMWhat's new

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

  1. 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.
  2. 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.
  3. In Callers and Callees pick how many steps back and forward to go (0-5; default 1 back, 2 forward).
  4. 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.
  5. 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.
  6. 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.