Dynatrace

Dynatrace is an observability and security platform that uses causal AI to deliver precise insights and automate DevSecOps at scale. This guide explains how to integrate ThousandEyes metrics with Dynatrace using OpenTelemetry.

For more information about sending metrics to Dynatrace using Opentelemetry, see OpenTelemetry and Dynatrace.

Step 1: Generate an API Access Token

To send data to Dynatrace, you need an API access token. Follow these steps to create a Dynatrace API access token.

1. In the Dynatrace platform, search for access token.

2. Click Access Tokens > Generate new token.

3. Enter a Token name.

4. For scopes, select Ingest metrics. This is important to grant the token access to send metrics data .

5. Click Generate token to create your API access token.

   Copy the token to use it to send telemetry data to Dynatrace.

Step 2: Create an Integration

Create an Integration Using the ThousandEyes UI

1. Log in to your account on the ThousandEyes platform and go to Manage > Integration 1.0.

2. Click +New Integration and select OpenTelemetry Integration.

3. Enter a Name for the integration.

4. Set the Target to HTTP.

5. Enter the Endpoint URL to send data in OTLP (OpenTelemetry Protocol) using the following format: https://{INSTANCE}.live.dynatrace.com/api/v2/otlp/v1/metrics. Replace {INSTANCE} with your Dynatrace instance.

6. For Preset Configurations, select Dynatrace.

7. For Auth Type, select Custom.

8. Add the following Custom Headers: "Authorization": "Api-Token {TOKEN}".

   • Use your Dynatrace API access token from step 1. Make sure to prefix it with Api-Token. For example: Api-Token {TOKEN}.

9. For the OpenTelemetry Signal, select Metric.

10. For the Data Model Version, select v2.

11. Select a test. For more information on creating a test, see General Setup Instructions.

12. Click Save to complete the integration setup.

You have now successfully integrated your ThousandEyes data with Dynatrace.

Manage Integrations in the UI

For more information on managing OpenTelemetry integrations, including listing, editing, and deleting integrations, see Manage Integrations Using the UI - Integrations 1.0.

Create an Integration Using the ThousandEyes API

For a programmatic integration, use the following API command to create an HTTP stream integration:

 curl -v -XPOST https://api.thousandeyes.com/v7/stream -H "Content-Type: application/json" -H "Authorization: Bearer $BEARER_TOKEN" -d '{
  "type": "opentelemetry",
  "testMatch": [{
    "id": "281474976717575",
    "domain": "cea"
  }],
  "endpointType": "http",
  "streamEndpointUrl": "https://<instance>.live.dynatrace.com/api/v2/otlp/v1/metrics",
  "customHeaders" : {
    "Authorization": "Api-Token <TOKEN>"
  }
}'

Replace {TOKEN} and {INSTANCE} with the correct values for your Dynatrace instance.

Step 3: Enable ThousandEyes Resource Attributes in Dynatrace

After successfully integrating ThousandEyes with Dynatrace, you need to ensure that ThousandEyes resource attributes are visible. By default, these attributes are not enabled. Follow these steps to allow them:

1. In Dynatrace, go to Settings and search for metrics.

2. Click OpenTelemetry metrics.

3. Under the Allow list: resource and scope attributes section, enter the ThousandEyes resource attribute keys and click Add Item.

   You can start by adding the following ThousandEyes attribute keys:

   • thousandeyes.stream.id

   • thousandeyes.test.id

   • thousandeyes.test.name

   • thousandeyes.source.agent.id

   • thousandeyes.source.agent.name

   For more information on the available ThousandEyes resource attributes, see common resource attributes.

4. Click Save Changes to apply the settings.

This ensures that ThousandEyes resource attributes are included in Dynatrace for better monitoring and analysis.

ThousandEyes Dashboard in Dynatrace

ThousandEyes Dashboard in Dynatrace

You can download the dashboard template from the following link: Download ThousandEyes Dynatrace dashboard template (Google Drive).