Cloudflare Workers

Here’s a quick guide to setting up Subtrace in your Cloudflare Workers. First, add @subtrace/cloudflare to your Worker package.json:

npm install @subtrace/cloudflare

Wrap your Worker’s fetch handler to use the Subtrace middleware:

src/index.js

import { subtrace } from "@subtrace/cloudflare";

export default {
  fetch: subtrace(async (request, env, ctx) => {
    return new Response("Hello World!");
  }),
};

Set a SUBTRACE_TOKEN environment variable in your Wrangler config file:

wrangler.jsonc

{
  "name": "my-worker",
  "main": "src/index.js",
  "compatibility_date": "2025-09-27",
  "vars": {
    // Go to https://subtrace.dev/dashboard to generate a token
    "SUBTRACE_TOKEN": "subt_..."
  }
}

name = "my-worker"
main = "src/index.js"
compatibility_date = "2025-09-27"

[vars]
# Go to https://subtrace.dev/dashboard to generate a token
SUBTRACE_TOKEN = "subt_..."

Deploy your Cloudflare Worker:

npx wrangler deploy

And that’s it, you can now see all inbound and outbound HTTP requests in your Cloudflare Worker via the Subtrace dashboard!

Elastic Kubernetes Service Vercel + Next.js

Getting Started

Platforms

Language guides

Configuration

Tutorials

Advanced

Reference

Cloudflare Workers