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.

Step 1: Generate an API Key

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

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 need the API key to send telemetry data to Datadog.

For more information, see API and Application Keys.

Step 2: Create an Integration

Create an Integration Using the ThousandEyes UI

To integrate Datadog with ThousandEyes, follow these steps.

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) 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 to complete the integration setup.

You have now successfully integrated your ThousandEyes data with DataDog.

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:

 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://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

ThousandEyes Dashboard in Datadog

You can download the dashboard template from the following link: Download ThousandEyes Dashboard Datadog dashboard template.