Dynatrace

Dynatrace is an observability and security platform that uses causal AI to deliver precise insights and automate DevSecOps at scale. This guide shows how to stream ThousandEyes metrics, traces, and logs to Dynatrace using OpenTelemetry.

For Dynatrace’s OpenTelemetry overview, see OpenTelemetry and Dynatrace. For the signals ThousandEyes supports, see Supported Signals.

Prerequisites

• You have created a ThousandEyes test.

• You have a Dynatrace API access token with scopes Ingest metrics, Ingest logs, and Ingest OpenTelemetry traces:

  1. In Dynatrace, search for access token.

  2. Go to Access Tokens > Generate new token.

  3. Enter a token name and select the scopes above.

  4. Click Generate token, then copy the token for later use.

Stream OpenTelemetry Metrics to Dynatrace

Step 1: Create a Metrics Integration

Using the ThousandEyes UI

1. In ThousandEyes, go to Manage > Integration 1.0.

2. Click +New Integration and choose OpenTelemetry Integration.

3. Enter a Name.

4. Set Target to HTTP.

5. Set the Endpoint URL to https://{INSTANCE}.live.dynatrace.com/api/v2/otlp/v1/metrics (replace {INSTANCE}).

6. For Preset Configurations, select Dynatrace.

7. Set Auth Type to Custom and add "Authorization": "Api-Token {TOKEN}" (use the token from Prerequisites).

8. For Signal, select Metric.

9. For Data Model Version, select v2.

10. Select a test. For help, see General Setup Instructions.

11. Click Save.

Using the ThousandEyes API

Create the HTTP stream programmatically:

 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",
  "signal": "metric",
  "streamEndpointUrl": "https://<instance>.live.dynatrace.com/api/v2/otlp/v1/metrics",
  "customHeaders" : {
    "Authorization": "Api-Token <TOKEN>"
  }
}'

Replace {TOKEN} and {INSTANCE} with your Dynatrace values.

Step 2: Enable ThousandEyes Resource Attributes in Dynatrace

Allow ThousandEyes resource attributes so they appear on metrics:

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

2. Under Allow list: resource and scope attributes, add these keys (click Add Item for each):

   • thousandeyes.stream.id

   • thousandeyes.test.id

   • thousandeyes.test.name

   • thousandeyes.source.agent.id

   • thousandeyes.source.agent.name

3. For the full list, see common resource attributes.

4. Click Save Changes.

ThousandEyes Dashboard in Dynatrace

1. Download the dashboard template: ThousandEyes Dynatrace dashboard template.

2. In Dynatrace, go to Dashboards and click Upload.

3. Open the dashboard to visualize ThousandEyes data.

ThousandEyes Dashboard in Dynatrace

Stream OpenTelemetry Traces to Dynatrace

Step 1: Create a Traces Integration

Using the ThousandEyes UI

1. In ThousandEyes, go to Manage > Integration 1.0.

2. Click +New Integration and select OpenTelemetry Integration.

3. Enter a Name.

4. Set Target to HTTP.

5. Set the Endpoint URL to https://{INSTANCE}.live.dynatrace.com/api/v2/otlp/v1/traces (replace {INSTANCE}).

6. For Preset Configurations, select Dynatrace.

7. Set Auth Type to Custom and add "Authorization": "Api-Token {TOKEN}".

8. For Signal, select Trace.

9. Select a test. See General Setup Instructions if needed.

10. Click Save.

Using the ThousandEyes API

Create the HTTP stream programmatically:

 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",
  "signal": "trace",
  "streamEndpointUrl": "https://<instance>.live.dynatrace.com/api/v2/otlp/v1/traces",
  "customHeaders" : {
    "Authorization": "Api-Token <TOKEN>"
  }
}'

Replace {TOKEN} and {INSTANCE} with your Dynatrace values.

Step 2: Visualize Traces in Dynatrace

1. In Dynatrace, open Distributed Tracing.

2. Search for spans from ThousandEyes and apply filters (duration, errors, target URL, etc.).

ThousandEyes Traces in Dynatrace

Stream OpenTelemetry Logs to Dynatrace

Step 1: Create a Logs Integration

Using the ThousandEyes UI

1. In ThousandEyes, go to Manage > Integration 1.0.

2. Click +New Integration and select OpenTelemetry Integration.

3. Enter a Name.

4. Set Target to HTTP.

5. Set the Endpoint URL to https://{INSTANCE}.live.dynatrace.com/api/v2/otlp/v1/logs (replace {INSTANCE}).

6. For Preset Configurations, select Dynatrace.

7. Set Auth Type to Custom and add "Authorization": "Api-Token {TOKEN}".

8. For Signal, select Log.

9. Select a test. For details, see General Setup Instructions.

10. Click Save.

Using the ThousandEyes API

Create the HTTP stream programmatically:

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

Replace {TOKEN} and {INSTANCE} with your Dynatrace values.

Step 2: Visualize Logs in Dynatrace

1. In Dynatrace, open Logs.

2. Search for ThousandEyes logs and apply filters (body, timestamp, account name, user name, user email, etc.).

ThousandEyes Logs in Dynatrace