Skip to content

Export to Honeycomb

Last updated View as MarkdownAgent setup

Honeycomb is an observability platform for high-cardinality telemetry data. Export Cloudflare telemetry to Honeycomb to query logs, inspect traces, and create dashboards.

Trace view including POST request, fetch operations, durable object subrequest, and queue send, with timing information displayed on a timeline

This guide configures Honeycomb to receive Cloudflare traces and logs.

Prerequisites

Before you begin, you need an active Honeycomb account ↗︎. You also need Cloudflare logs or traces to export.

1. Get your Honeycomb API key

  1. Log in to your Honeycomb account ↗︎.
  2. From your profile menu, select Team Settings.
  3. Select Environments, then select the gear icon.
  4. Select an environment or create one.
  5. Under API Keys, select Create Ingest API Key.
  6. Enter a descriptive name, such as cloudflare-otel.
  7. Select Can create services/datasets.
  8. Select Create.
  9. Copy and securely store the API key.

The API key starts with hcaik_.

2. Configure Cloudflare Observability destinations

Honeycomb provides separate OpenTelemetry Protocol (OTLP) endpoints for traces and logs:

  • Traces: https://api.honeycomb.io/v1/traces
  • Logs: https://api.honeycomb.io/v1/logs

Configure a traces destination

  1. In the Cloudflare dashboard, go to Observability > Destinations.

    Go to OpenTelemetry ↗
  2. Select Add destination.

  3. Configure the destination:

    • Destination name: honeycomb-traces
    • Destination type: Traces
    • OTLP endpoint: https://api.honeycomb.io/v1/traces
    • Custom header name: x-honeycomb-team
    • Custom header value: Your Honeycomb API key
  4. Select Save.

Configure a logs destination

  1. Select Add destination again.
  2. Configure the destination:
    • Destination name: honeycomb-logs
    • Destination type: Logs
    • OTLP endpoint: https://api.honeycomb.io/v1/logs
    • Custom header name: x-honeycomb-team
    • Custom header value: Your Honeycomb API key
  3. Select Save.

3. Enable export

Creating a destination does not start exporting telemetry. To export Workers Logs or Workers Traces, configure OpenTelemetry export for your Worker. To export Cloudflare Traces, configure export for your domain.

Data may take several minutes to appear in Honeycomb.

Was this helpful?