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.

Prerequisites

• You have created a ThousandEyes test.

• You have created a Honeycomb 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.

• You have retrieved your Honeycomb 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.

Stream OpenTelemetry Metrics to Honeycomb

Step 1: Create a Metrics Integration

Using the ThousandEyes UI

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

2. Click New Integration and select OpenTelemetry Integration.

3. Enter a Name for the integration.

4. Set the Target to GRPC.

   Honeycomb supports both HTTP and GRPC

5. Enter the Endpoint URL.

6. For Preset Configurations, select Honeycomb.

7. For Auth Type, select Custom.

8. Add the following Custom Headers:

   • X-Honeycomb-Team: Enter your Honeycomb API key.

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

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

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-team": "{API_KEY}",
      "x-honeycomb-dataset": "{ENVIRONMENT_NAME}"
    }
  }'
  }
}'

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

ThousandEyes Dashboard in Honeycomb

1. In Honeycomb, select your Environment.

2. Open the Query Builder.

3. Select a ThousandEyes metric dataset and apply filters.

ThousandEyes Dashboard in Honeycomb

Stream OpenTelemetry Traces to Honeycomb

Step 1: Create a Traces Integration

Using the ThousandEyes UI

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

2. Click New Integration and select OpenTelemetry Integration.

3. Enter a Name for the integration.

4. Set the Target to GRPC.

   Honeycomb supports both HTTP and GRPC

5. Enter the Endpoint URL.

6. For Preset Configurations, select Honeycomb.

7. For Auth Type, select Custom.

8. Add the following Custom Headers:

   • X-Honeycomb-Team: Enter your Honeycomb API key.

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

9. For the OpenTelemetry Signal, select Trace.

10. Select a test.

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

11. Click Save.

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

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

Step 2: Visualize Traces in Honeycomb

1. In Honeycomb, select your Environment.

2. Open the Query Builder.

3. Select a ThousandEyes trace dataset and apply filters.

ThousandEyes Traces in Honeycomb

Stream OpenTelemetry Logs to Honeycomb

Step 1: Create a Logs Integration

Using the ThousandEyes UI

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

2. Click New Integration and select OpenTelemetry Integration.

3. Enter a Name for the integration.

4. Set the Target to GRPC.

   Honeycomb supports both HTTP and GRPC

5. Enter the Endpoint URL.

6. For Preset Configurations, select Honeycomb.

7. For Auth Type, select Custom.

8. Add the following Custom Headers:

   • X-Honeycomb-Team: Enter your Honeycomb API key.

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

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

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",
    "endpointType": "http",
    "signal": "log",
    "streamEndpointUrl": "https://api.honeycomb.io:443/v1/logs",
    "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",
    "endpointType": "grpc",
    "signal": "log",
    "streamEndpointUrl": "https://api.honeycomb.io:443",
    "customHeaders": {
      "x-honeycomb-team": "{API_KEY}",
      "x-honeycomb-dataset": "{ENVIRONMENT_NAME}"
    }
}'

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

Step 2: Visualize Logs in Honeycomb

1. In Honeycomb, select your Environment.

2. Open the Query Builder.

3. Select a ThousandEyes log dataset and apply filters.

ThousandEyes Logs in Honeycomb