Datadog Incident Management

By integrating Datadog Incident Management with DX, you can analyze incident data and metrics such as MTTR and Change Fail Rate. Please refer to the API documentation below and our schema explorer to see what data DX imports.

Prerequisites

To connect Datadog to DX, you need:

a service account
an Application Key
an API key

Setup instructions

Follow the steps below to connect Datadog to DX.

Step 1

Create a Read Only service account with an application key—the scopes will be set automatically by the Read Only Role.

Step 2

Create an API key by navigating to Organization Settings → API Keys.

Step 3

Navigate to the connections page in DX and select “+ Connection” in the top right.
Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.
Set your base URL by referring to the table below:

Site URL	Base URL
`https://app.datadoghq.com`	`https://api.datadoghq.com`
`https://us3.datadoghq.com`	`https://api.us3.datadoghq.com`
`https://us5.datadoghq.com`	`https://api.us5.datadoghq.com`
`https://app.datadoghq.eu`	`https://api.datadoghq.eu`
`https://app.ddog-gov.com`	`https://api.ddog-gov.com`
`https://ap1.datadoghq.com`	`https://api.ap1.datadoghq.com`

API reference

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

Endpoint	Documentation	Permissions needed
/api/v2/team	Link	teams_read
/api/v2/team/{teamUuid}/memberships	Link	teams_read
/api/v2/services/definitions	Link	apm_service_catalog_read
/api/v2/incidents/search	Link	incident_read
/api/v2/users	Link	user_access_read

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.