By connecting PagerDuty with DX, you can analyze incident data and metrics such as time to resolution. Please visit our schema explorer to see what data DX imports.

Prerequisites

To connect PagerDuty to DX, you need:

a PagerDuty API token

Setup instructions

Follow the steps below to connect PagerDuty to DX.

Step 1

Step 2

Click 'Create a New API Key' and generate a new read-only key.

Step 3

Navigate to the new connection form in DX.
Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

API Reference

The table below lists the specific API endpoints that are used by DX.

Endpoint	Documentation Link	Required Permissions
/incidents	PagerDuty API: List Incidents	General Access REST API Key with Read-Only Access
/analytics/raw/incidents	PagerDuty API: Get Raw Data for Multiple Incidents	General Access REST API Key with Read-Only Access
/services	PagerDuty API: List Services	General Access REST API Key with Read-Only Access
/users	PagerDuty API: List Users	General Access REST API Key with Read-Only Access
/teams	PagerDuty API: List Teams	General Access REST API Key with Read-Only Access
/incidents/{incident_id}/log_entries	PagerDuty API: List Log Entries for an Incident	General Access REST API Key with Read-Only Access

Errors

The table below lists potential error codes when adding a connection in DX.

Error	Description
`invalid_credentials`	Your API credentials entered are not valid.
`invalid_permissions`	Your API token does not have the permissions required by DX.