Skip to main content
The service map gives you a live graph of your infrastructure — which services exist, how they depend on one another, and what breaks when any one of them fails. During an incident, this graph powers blast radius calculations and downstream impact analysis, letting responders quickly understand the full scope of a failure rather than discovering affected services one by one. This guide walks you through registering services, defining their dependencies, querying the topology, and calculating blast radius.

Prerequisites

  • A valid API key with service map read/write permissions
  • Knowledge of your services and their inter-dependencies

Register a service

Add each service to the map with a name, owner, and criticality level. This forms the nodes in your dependency graph.
The response includes a service id. Store this — you will need it when defining dependencies.

Define dependencies

Tell Scrubbe which services depend on which. A dependency from service A to service B means that a failure in B can affect A.
Use HARD for dependencies that cause an outage when the upstream fails, and SOFT for degraded-but-functional scenarios. Accurate dependency types produce more precise blast radius estimates.

View the topology

Retrieve the full dependency graph for your workspace. This is the canonical view of all services and their relationships.
The response returns nodes (services) and edges (dependencies) suitable for rendering in a graph visualisation tool.

List and retrieve individual services


Analyse downstream impact

For a specific service, retrieve every downstream service that would be affected if it became unavailable.
Run this during an incident to immediately understand which other teams need to be notified or which SLAs are at risk.

Update a service

Keep service metadata current as ownership, regions, or criticality tiers change.

Blast radius

The blast radius endpoints quantify the potential impact of a failure, expressed as a percentage of users or transactions affected. Use these during incident triage to prioritise response effort.
1

Calculate blast radius for a service

The response includes an estimated percentage of impacted users and a list of affected downstream services.
2

Get the current blast radius summary

3

Review the risk summary

Pull a prioritised view of risk across all services — useful for capacity planning and incident preparedness reviews.

Remove dependencies and services

Deleting a service removes it from the topology and severs all of its dependency edges. This will affect blast radius calculations for any service that depended on it.