Skip to main content
The PagerDuty integration connects your Sentry organization to one or more PagerDuty accounts. It lets you trigger PagerDuty incidents from Sentry alert rules, with automatic severity mapping based on the event level.

​
Features

Incident triggering

Trigger PagerDuty incidents from Sentry issue and metric alerts.

Severity mapping

Sentry event levels map automatically to PagerDuty severity levels.

Multi-service support

Connect multiple PagerDuty services to a single Sentry organization and route alerts to the appropriate service.

Alert rule actions

Use alert rule conditions to control exactly when and which PagerDuty service is notified.

​
Severity mapping

Sentry maps its event levels to PagerDuty severity levels as follows:
Sentry levelPagerDuty severity
debuginfo
infoinfo
warningwarning
errorerror
fatalcritical
When no level is set, the default severity is used. You can also override the severity in the alert rule action.

​
Installation

1

Start installation from Sentry

In Sentry, go to Settings > Integrations and find PagerDuty in the Notifications group. Click Install.
2

Authorize in PagerDuty

Sentry redirects you to your PagerDuty account to install the Sentry integration. Sign in, select the account, and approve access.
3

Select services

PagerDuty prompts you to choose which services should receive events from Sentry. Select one or more services and complete the setup.
4

Confirm in Sentry

Sentry redirects you back after setup. The configured PagerDuty services appear in Settings > Integrations > PagerDuty.
The PagerDuty integration adds a new alert rule action to all projects. To start sending incidents to PagerDuty, you must create an alert rule with the PagerDuty action enabled.

​
Managing services

After installation, you can add, update, or remove PagerDuty services from the integration settings:
  1. Go to Settings > Integrations > PagerDuty > Configure.
  2. The service table shows all connected PagerDuty services and their integration keys.
  3. Click Add to add a service manually by entering its name and PagerDuty integration key.
  4. Click the delete icon to remove a service. Any alert rules using the removed service will show it as removed.
Deleting a service from the integration settings does not delete it from PagerDuty. It only removes the connection in Sentry. Alert rules associated with the deleted service will stop working.

​
Setting up alert rule actions

1

Open alert rules

Go to Alerts > Alert Rules and create or edit a rule.
2

Add a PagerDuty action

Under Then perform these actions, click Add action and select Send a PagerDuty notification.
3

Configure the action

Select the PagerDuty account and the service to trigger. Optionally set a custom severity level.
4

Save the rule

Save the alert rule. Sentry will trigger a PagerDuty incident whenever the rule conditions are met.

​
Integration key

Each PagerDuty service connected to Sentry has a unique integration key (also called a routing key). Sentry uses this key to send events to the correct service via the PagerDuty Events API v2. You can find and update integration keys in Settings > Integrations > PagerDuty > Configure.

Build docs developers (and LLMs) love

Get started for freeTalk to us