Datadog

Datadog is a cloud-based observability platform that unifies metrics, traces, logs, and real user monitoring data to provide end-to-end visibility across applications, networks, and infrastructure. This guide explains how to integrate ThousandEyes metrics with Datadog using OpenTelemetry.

For more information about sending metrics to Datadog using OpenTelemetry, see Datadog OTLP Metrics Intake Endpoint.

Prerequisites

• You have created a ThousandEyes test.

• You have generated a Datadog API key:

  1. In the Datadog platform, go to Organization Settings > API Keys.

  2. Click + New Key.

  3. Enter a Name and click Create Key.

  4. Copy and store your API key securely.

• You have identified your Datadog OTLP endpoints. The endpoint depends on your Datadog site (<DATADOG_SITE>). To determine your site, see the Datadog documentation.

  Use the following endpoints:

  • For metrics: https://otlp.<DATADOG_SITE>/v1/metrics

    • Example: https://otlp.datadoghq.eu/v1/metrics

  • For logs: https://otlp.<DATADOG_SITE>/v1/logs

    • Example: https://otlp.datadoghq.eu/v1/logs

Stream OpenTelemetry Metrics to Datadog

Step 1: Create a Metrics 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 for the integration.

4. Set the Target to HTTP.

5. Enter the Endpoint URL to send data in OTLP (OpenTelemetry Protocol) format:

   See Datadog OTLP Metrics Intake Endpoint for the URL that corresponds to your region.

6. For Preset Configurations, select Datadog.

7. For Auth Type, select Custom.

8. Add the following Custom Headers:

   • dd-api-key: {DD_API_KEY}

   • dd-otel-metric-config: {"resource_attributes_as_tags": true}

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.

Using the ThousandEyes API

Create the HTTP stream programmatically:

 curl -v -XPOST https://api.thousandeyes.com/v7/streams -H "Content-Type: application/json" -H "Authorization: Bearer $BEARER_TOKEN" -d '{
  "type": "opentelemetry",
  "testMatch": [{
    "id": "281474976717575",
    "domain": "cea"
  }],
    }],
    "endpointType": "http",
    "streamEndpointUrl": "https://otlp.datadoghq.com/v1/metrics",
    "customHeaders": {
      "dd-api-key": "<DATADOG_API_KEY>",
      "dd-otel-metric-config": "{'resource_attributes_as_tags': true}"
    }
}'

Replace 281474976717575, cea, and <DATADOG_API_KEY> with your actual test ID, domain (if needed), and your Datadog API key.

ThousandEyes Dashboard in Datadog

1. Download the dashboard template: Download ThousandEyes Dashboard Datadog dashboard template

2. In Datadog, go to Dashboards and click New Dashboard > Import Dashboard JSON.

3. Upload the downloaded JSON file.

4. Open the dashboard to visualize ThousandEyes metrics in Datadog.

ThousandEyes Dashboard in Datadog

Stream OpenTelemetry Logs to Datadog

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 for the integration.

4. Set the Target to HTTP.

5. Enter the Endpoint URL to send data in OTLP (OpenTelemetry Protocol) format:

   See Datadog OTLP Logs Intake Endpoint for the URL that corresponds to your region.

6. For Preset Configurations, select Datadog.

7. For Auth Type, select Custom.

8. Add the following Custom Headers:

   • dd-api-key: {DD_API_KEY}

9. For the OpenTelemetry Signal, select Log.

10. Select a test.

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

11. Click Save.

Using the ThousandEyes API

Create the HTTP stream programmatically:

curl -v -XPOST https://api.thousandeyes.com/v7/streams \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -d '{
    "type": "opentelemetry",
    "endpointType": "http",
    "signal": "log",
    "streamEndpointUrl": "https://otlp.datadoghq.com/v1/logs",
    "customHeaders": {
      "dd-api-key": "<DATADOG_API_KEY>"
    }
  }'

Replace <DATADOG_API_KEY> with your Datadog API key.

Step 2: Visualize Logs in Datadog

1. In Datadog, navigate to Logs > Explorer.

2. Search for ThousandEyes logs and apply filters.

   For example, you can use the following query to find logs that contain ThousandEyes data: @resource.attributes.thousandeyes.account.id: *

ThousandEyes Logs in Datadog