Skip to main content
By the end of this guide, you’ll have services from the Status Data catalog added as dependencies, with alerts configured to notify you when they have outages.
  • DevHelm CLI installed or an API token
  • At least one alert channel — see First alert
For conceptual background, see Dependencies.

​
Add your first dependency

1

Browse the catalog

devhelm status-data services list
devhelm status-data services list --category cloud-infrastructure
Find the services your application depends on — GitHub, Stripe, AWS, Vercel, etc.
2

Add a dependency

devhelm status-data dependencies add github
devhelm status-data dependencies add stripe
devhelm status-data dependencies add aws
3

Configure alert sensitivity

Control which events trigger alerts:
devhelm status-data dependencies update <dependency-id> \
  --alert-sensitivity INCIDENTS_ONLY
LevelAlerts on
ALLAny status change, including minor degradations
INCIDENTS_ONLYOnly active incidents
MAJOR_ONLYOnly major outages
4

Verify routing

Dependency alerts route through the same notification policies as monitor alerts. Verify with a catch-all policy or create a targeted one:
{
  "name": "Dependency alerts to Slack",
  "matchRules": [
    { "type": "service_id_in", "values": ["<github-service-id>", "<stripe-service-id>"] }
  ],
  "escalation": {
    "steps": [{
      "delayMinutes": 0,
      "channelIds": ["<slack-channel-id>"]
    }]
  }
}

​
Track specific components

If you only depend on part of a service (e.g., GitHub API but not GitHub Pages), add a component-level dependency: 
curl -X POST "https://api.devhelm.io/api/v1/service-subscriptions/github?componentId=<component-id>" \
  -H "Authorization: Bearer $DEVHELM_API_TOKEN"
Find component IDs by listing a service’s components: 
devhelm status-data services components github

​
Manage dependencies

devhelm status-data dependencies list
devhelm status-data dependencies remove <dependency-id>
Free plans support up to 10 dependencies. Starter and above have unlimited.

​
Next steps

Dependencies reference

Alert sensitivity, component tracking, and plan limits.

Service incidents

View incidents from your tracked services.

Uptime reporting

Query historical uptime for your dependencies.