Cloudflare Workers OpenTelemetry Guide

Cloudflare Workers supports exporting OpenTelemetry (OTel)-compliant traces directly to SigNoz without code changes, using Cloudflare's built-in observability features.

Step 1: Create destination in Cloudflare

1. Go to Workers Observability in your Cloudflare dashboard
2. Click on Destinations Tab
3. Click Add destination
4. Configure:
   • Name: Choose a name (e.g., signoz-traces)
   • Type: Traces
   • OTLP Endpoint:
     • https://ingest.<region>.signoz.cloud:443/v1/traces
     • See SigNoz Ingestion Docs
   • Headers:
     • Add signoz-ingestion-key: <your-ingestion-key>
5. Click Save

Step 2: Configure Wrangler

Update wrangler.jsonc ( use the destination name created in Step 1 ):

{
  "observability": {
    "traces": {
      "enabled": true,
      "destinations": ["signoz-traces"]
    }
  }
}

Additional configuration options:

You can customize the configuration with additional options such as:

• head_sampling_rate: Control sampling rate for traces
• persist: false: Disable storing data in Cloudflare dashboard (only send to SigNoz)

For complete configuration options, refer to Cloudflare's OpenTelemetry documentation.

Step 3: Deploy

Run wrangler deploy. Data appears in SigNoz within minutes.

Limitations

• Beta status: OpenTelemetry data export from Cloudflare Workers is in beta. Features may change.

Step 1: Install the SDK

Install @microlabs/otel-cf-workers in your project.

npm i @microlabs/otel-cf-workers

Step 2: Add Node.js Compatibility Flag

OpenTelemetry requires the Node.js compatibility flag to be enabled at the top level of your wrangler.toml.

compatibility_flags = [ "nodejs_compat" ]

Step 3: Configure tracer in Cloudflare Workers project

Navigate to the wrangler project directory, and add the following code to your src/index.ts file.

import { instrument, ResolveConfigFn } from '@microlabs/otel-cf-workers'
 
const handler = {
    async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
        // your cloudflare worker code
    },
}
 
const config: ResolveConfigFn = (env: Env, _trigger) => {
    return {
        exporter: {
            url: 'https://ingest.<region>.signoz.cloud:443/v1/traces',
            headers: { 'signoz-ingestion-key': '<your-ingestion-key>' },
        },
        service: { name: '<service-name>', version: '<service-version>' },
    }
}
 
export default instrument(handler, config)

Verify these values:

• <region>: Your SigNoz region
• <your-ingestion-key>: Your SigNoz ingestion key
• <service-name>: A descriptive name for your service (e.g., my-worker).
• <service-version> (optional): Your release version, image tag, or git SHA (e.g., 1.4.2, a01dbef8).

Step 4: Deploy the project

Deploy the project to Cloudflare Worker.

npm run deploy