Cloudflare Workers

Overview

Cloudflare Workers natively supports OpenTelemetry export for both traces (beta) and logs. This integration configures your Workers to send telemetry data directly to Dash0's ingestion endpoints using OTLP (OpenTelemetry Protocol). Once configured, your Workers will automatically export trace spans for request handling and any logs you emit during execution.

Prerequisites

Before setting up Cloudflare Workers monitoring, ensure:

• You have an active Dash0 account (free 14-day trial available)
• You have a deployed Worker application that you want to monitor
• You have access to your Cloudflare account's Workers Observability settings

Step 1: Get Your Dash0 Authorization Token and Endpoint

1. Log in to your Dash0 account
2. Navigate to Organization Settings
3. In the Endpoints section, find your ingestion endpoints:
   • Traces endpoint: Your OTLP traces endpoint URL ending in /v1/traces
   • Logs endpoint: Your OTLP logs endpoint URL ending in /v1/logs
4. Create or copy your Authorization Token from the same section

Step 2: Configure Cloudflare Destinations

Navigate to your Cloudflare account's Workers Observability section to create destinations that point to Dash0.

Configure Trace Destination (beta)

1. Click Add destination
2. Configure your trace destination:
   • Destination Name: dash0-traces (or any descriptive name)
   • Destination Type: Select Traces
   • OTLP Endpoint: Your Dash0 traces endpoint URL from Organization Settings (ends in /v1/traces)
   • Custom Headers: Add the authentication header:
     • Header name: Authorization
     • Header value: Bearer {{token}}
   • Optional - Dataset Header: If you want to send data to a specific dataset:
     • Header name: Dash0-Dataset
     • Header value: Your dataset name (e.g., default)
3. Click Save

Configure Logs Destination (beta)

1. Click Add destination again
2. Configure your logs destination:
   • Destination Name: dash0-logs (or any descriptive name)
   • Destination Type: Select Logs
   • OTLP Endpoint: Your Dash0 logs endpoint URL from Organization Settings (ends in /v1/logs)
   • Custom Headers: Add the authentication header:
     • Header name: Authorization
     • Header value: Bearer {{token}} (same as above)
   • Optional - Dataset Header: If you want to send data to a specific dataset:
     • Header name: Dash0-Dataset
     • Header value: Your dataset name (e.g., default)
3. Click Save

Step 3: Configure Your Worker

With your destinations created in the Cloudflare dashboard, update your Worker's wrangler.toml configuration file to enable telemetry export:

Alternatively, if using JSON configuration (wrangler.json):

After updating your configuration, deploy your Worker for the changes to take effect:

Verification

1. Trigger some requests to your Worker application
2. Navigate to the Traces section in your Dash0 dashboard
3. Look for traces with service.name attribute matching your Worker name
4. Navigate to the Logs section to see log entries from your Worker
5. Verify that traces and logs contain the expected attributes and data

References

• Cloudflare Workers Traces Overview
• Cloudflare Workers Spans and Attributes
• Cloudflare Workers Traces Known Limitations
• Cloudflare Workers Logs Documentation
• OpenTelemetry Protocol (OTLP) Specification