Honeycomb

Honeycomb is an observability platform designed for high-cardinality and high-dimensional analysis. This enables deep debugging of complex systems to help teams quickly identify and resolve issues. This guide explains how to integrate ThousandEyes metrics with Honeycomb using OpenTelemetry.

For more information about sending metrics to Honeycomb using OpenTelemetry, see Honeycomb: Send Data with OpenTelemetry.

Step 1: Create a Honeycomb API Key

To send telemetry data to Honeycomb, you need an API key. Follow these steps to create one:

Create an environment

1. In the Honeycomb platform, go to Manage Data > Environments.

2. Click Create Environment.

3. Enter a Name and Description for your environment.

4. Click Create Environment to create your environment.

Retrieve your API key

1. Click the newly created environment.

2. Click API Keys > Configuration.

3. Copy the API Key to use it to send telemetry data to Honeycomb.

Step 2: Create an Integration

Create an Integration Using the ThousandEyes UI

1. Log in to your account on the ThousandEyes platform.

2. Navigate to Integrations > Integration 1.0 from the side menu.

3. Click New Integration and select OpenTelemetry Integration.

4. Enter a Name for the integration.

5. Set the Target to GRPC. Honeycomb supports both HTTP and GRPC

6. Enter the Endpoint URL.

7. For Preset Configurations, select Honeycomb.

8. For Auth Type, select Custom.

9. Add the following Custom Headers:

   • X-Honeycomb-Tear: Enter your Honeycomb API key from step 1.

   • X-Honeycomb-Dataset: Enter your Environment Name as the Dataset value.

10. For the OpenTelemetry Signal, select Metric.

11. For the Data Model Version, select v2.

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

13. Click Save to complete the integration setup.

You have now successfully integrated your ThousandEyes data with Honeycomb.

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:

Using HTTP Protocol

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://api.honeycomb.io:443/v1/metrics",
  "customHeaders" : {
    "x-honeycomb-team": "{API_KEY}",
    "x-honeycomb-dataset": "{ENVIRONMENT_NAME}"
  }
}'

Using gRPC Protocol

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": "grpc",
    "streamEndpointUrl": "https://api.honeycomb.io:443",
    "customHeaders": {
      "x-honeycomb-tear": "{API_KEY}",
      "x-honeycomb-dataset": "{ENVIRONMENT_NAME}"
    }
  }'
  }
}'

Replace {API_KEY} and {ENVIRONMENT_NAME} with the correct values for your instance.

ThousandEyes Dashboard in Honeycomb

ThousandEyes Dashboard in Honeycomb