PagerDuty

Connect DevHelm to PagerDuty to automatically trigger and resolve incidents. DevHelm uses the PagerDuty Events API v2, maintaining incident state — when a DevHelm incident resolves, the corresponding PagerDuty alert resolves too.

Setup

Get your PagerDuty routing key

In PagerDuty, go to Services → select your service → Integrations
Click Add Integration and select Events API v2
Copy the Integration Key (this is your routing key)

Create the alert channel in DevHelm

devhelm alert-channels create \
  --name "On-Call PagerDuty" \
  --type pagerduty \
  --config '{"channelType":"pagerduty","routingKey":"your-events-api-v2-routing-key"}'

alertChannels:
  - name: On-Call PagerDuty
    config:
      channelType: pagerduty
      routingKey: ${PAGERDUTY_ROUTING_KEY}

Test the channel

devhelm alert-channels test <channel-id>

Configuration

Field	Description	Required
`routingKey`	PagerDuty Events API v2 routing (integration) key	Yes
`severityOverride`	Override PagerDuty severity: `critical`, `error`, `warning`, `info`	No

Lifecycle behavior

PagerDuty uses trigger-resolve lifecycle:

DevHelm event	PagerDuty action
Incident created	Triggers a new alert
Incident resolved	Resolves the corresponding alert
Incident reopened	Triggers a new alert

This keeps PagerDuty incident state in sync with DevHelm — no manual cleanup needed.

Severity mapping

By default, DevHelm maps severities to PagerDuty:

DevHelm severity	PagerDuty severity
DOWN	`critical`
DEGRADED	`warning`

Use severityOverride to force all alerts to a specific PagerDuty severity regardless of the DevHelm incident severity.

Troubleshooting

Alerts not triggering

Verify the routing key is for Events API v2 (not the REST API)
Check that the PagerDuty service is enabled and has an escalation policy
Run devhelm alert-channels test <id> to verify delivery

Alerts not auto-resolving

Resolution uses the same routing key. If you rotated the key in PagerDuty, update it in DevHelm too.

Overview

Alert Channels

CI/CD

Setup

Configuration

Lifecycle behavior

Severity mapping

Troubleshooting

​Setup

​Configuration

​Lifecycle behavior

​Severity mapping

​Troubleshooting

Setup

Configuration

Lifecycle behavior

Severity mapping

Troubleshooting