By integrating Datadog Incident Management 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 Datadog to DX, you need:

a service account and 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 connector setup form in DX.
Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

Set the Datadog API Base URL to https://app.datadoghq.com if you are unsure of your company's specific base URL.

API Reference

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

Endpoint URL	Documentation Link	Permissions Needed
/api/v2/team	List Teams	teams_read
/api/v2/team/#{team_uuid}/memberships	List Team Members	teams_read
/api/v2/services/definitions	List Service Definitions	apm_service_catalog_read
/api/v2/incidents/search	List Incidents	incident_read
/api/v2/users	List Users	user_access_invite

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.