PagerDuty Integration

Learn how to send PagerDuty alerts from Synnax when statuses change.

The PagerDuty integration allows Synnax to watch status keys and automatically trigger or resolve PagerDuty incidents when those statuses change. When a status transitions to an error, warning, or info state, a PagerDuty event is sent. When the status returns to success, the corresponding incident is automatically resolved.

Prerequisites

To use the PagerDuty integration, you’ll need:

1. A PagerDuty account
2. A PagerDuty service with an Events API v2 integration
3. The 32-character Integration Key (also called the routing key) from that integration

To create an Events API v2 integration in PagerDuty, navigate to Services → Service Directory → select your service → Integrations → Add Integration → Events API v2.

How It Works

The PagerDuty integration uses Synnax’s status system to determine when to send alerts. Each alert task watches one or more status keys and maps their variants to PagerDuty event severities.

When a watched status changes:

• Error, Warning, or Info variants trigger a PagerDuty event with the corresponding severity
• Success variant resolves any open PagerDuty incident for that status

Events are deduplicated by status key, so repeated changes to the same status update the existing incident rather than creating duplicates.

Severity Mapping

Supported Operating Systems

The PagerDuty integration runs directly on the Synnax Core, NOT on the Standalone or Embedded Driver.