autotel-cloudflare

name	autotel-cloudflare
description	OpenTelemetry for Cloudflare Workers. Instrument handlers, bindings (KV, R2, D1, AI, Vectorize, Queues, Durable Objects), and global fetch/cache. Multiple API styles for compatibility.

autotel-cloudflare

Complete OpenTelemetry for Cloudflare Workers. Three API styles, full bindings coverage.

Quick Start — pick one style

Style 1: instrument() (recommended)

import { instrument, instrumentKV } from 'autotel-cloudflare';

export default instrument(
  {
    async fetch(req, env, ctx) {
      const kv = instrumentKV(env.MY_KV, { name: 'my-kv' });
      const val = await kv.get('key'); // traced automatically
      return new Response(val);
    },
  },
  { service: { name: 'my-worker' } },
);

Style 2: wrapModule()

import { wrapModule } from 'autotel-cloudflare';

export default wrapModule(
  { service: { name: 'my-worker' } },
  { async fetch(req, env, ctx) { return new Response('OK'); } },
);

Style 3: Functional (from autotel-edge)

import { trace } from 'autotel-cloudflare';
export default { fetch: trace(async (req) => new Response('OK')) };

Bindings Instrumentation

Every Cloudflare binding has a wrapper. Each creates spans for all operations.

Binding	Wrapper	Import
KV	instrumentKV(env.KV, { name })	autotel-cloudflare or /bindings
R2	instrumentR2(env.BUCKET, { name })	same
D1	instrumentD1(env.DB, { name })	same
Service Binding	instrumentServiceBinding(env.SVC, { name })	same
Workers AI	instrumentAI(env.AI)	same
Vectorize	instrumentVectorize(env.INDEX, { name })	same
Hyperdrive	instrumentHyperdrive(env.HD, { name })	same
Queue Producer	instrumentQueueProducer(env.QUEUE, { name })	same
Durable Objects	instrumentDO(DOClass) or wrapDurableObject(config, DOClass)	same

Or use instrumentBindings(env) to auto-instrument all bindings at once.

Handler Types

instrument() and wrapModule() automatically trace: fetch, scheduled, queue, email.

Common Mistakes

• Do NOT call instrumentKV() etc. outside the handler — bindings aren't available at module scope.
• Do NOT use await import() for dynamic imports — use autotel's safeRequire helpers.
• Use autotel-cloudflare/bindings for tree-shaking if you only need binding wrappers.