By connecting Dynatrace with DX, you can analyze entities and SLO data. Please visit our schema explorer to see what data DX imports.

Prerequisites

To connect Dynatrace to DX, you need:

An access token or personal access token

Setup instructions

Follow the steps below to connect Dynatrace to DX.

Step 1

Create a Personal access token by searching for "Access Token" in the search bar present on the left hand panel.

Click on "Generate new token".

Generate a token by filling out the details. The required scopes for the token are Read SLO and Read entities.

When opting for a personal access token, please ensure Read SLO and Read entities scopes have been assigned while generating the token.

To set up OAuth authentication, go to Account Management > Oauth clients > Create Client and create an OAuth client with slo:slos:read, environment-api:slo:read and environment-api:entities:read permissions

Step 2

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.

Configure the Dynatrace API Base URL to match your instance's URL, for example: https://your-environment-id.live.dynatrace.com.

API Reference

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

Endpoint	Documentation Link	Permissions Needed
/api/v2/entities	List entities	entities.read
/api/v2/slo	List SLO	slo.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.
`no_resources`	The provided credentials does not have access to any entities or SLOs.