sentry-cloudflare-sdk

Full Sentry SDK setup for Cloudflare Workers and Pages. Use when asked to "add Sentry to Cloudflare Workers", "install @sentry/cloudflare", or configure error monitoring, tracing, logging, crons, or AI monitoring for Cloudflare Workers, Pages, Durable Objects, Queues, Workflows, or Hono on Cloudflare.

Ir a la instalación

Repositorio: getsentry/sentry-for-ai
Última actividad en el origen: 10 de julio de 2026 a las 15:51
Idioma detectado de SKILL.md: inglés
Estrellas: 252
Forks: 30

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/getsentry/sentry-for-ai --skill sentry-cloudflare-sdk

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

Explorador de archivos

6 archivos

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

# Detect Cloudflare project
ls wrangler.toml wrangler.jsonc wrangler.json 2>/dev/null

# Detect existing Sentry
cat package.json 2>/dev/null | grep -E '"@sentry/'

# Detect project type (Workers vs Pages)
ls functions/ functions/_middleware.js functions/_middleware.ts 2>/dev/null && echo "Pages detected"
cat wrangler.toml 2>/dev/null | grep -E 'main|pages_build_output_dir'

# Detect framework
cat package.json 2>/dev/null | grep -E '"hono"|"remix"|"astro"|"svelte"'

# Detect Durable Objects
cat wrangler.toml 2>/dev/null | grep -i 'durable_objects'

# Detect D1 databases
cat wrangler.toml 2>/dev/null | grep -i 'd1_databases'

# Detect Queues
cat wrangler.toml 2>/dev/null | grep -i 'queues'

# Detect Workflows
cat wrangler.toml 2>/dev/null | grep -i 'workflows'

# Detect Scheduled handlers (cron triggers)
cat wrangler.toml 2>/dev/null | grep -i 'crons\|triggers'

# Detect compatibility flags
cat wrangler.toml 2>/dev/null | grep -i 'compatibility_flags'
cat wrangler.jsonc 2>/dev/null | grep -i 'compatibility_flags'

# Detect AI/LLM libraries
cat package.json 2>/dev/null | grep -E '"openai"|"@anthropic-ai"|"ai"|"@google/generative-ai"|"@langchain"'

# Detect logging libraries
cat package.json 2>/dev/null | grep -E '"pino"|"winston"'

# Check for companion frontend
ls frontend/ web/ client/ 2>/dev/null
cat package.json 2>/dev/null | grep -E '"react"|"vue"|"svelte"|"next"'

Question	Impact
Workers or Pages?	Determines wrapper: `withSentry` vs `sentryPagesPlugin`
Hono framework?	Recommend standalone `@sentry/hono` package (v10.55.0+) for cleaner integration
`@sentry/cloudflare` already installed?	Skip install, go to feature config
Durable Objects configured?	Recommend `instrumentDurableObjectWithSentry`
D1 databases bound?	`withSentry` auto-instruments D1 bindings (v10.57.0+); no manual wrapping needed
Queues configured?	`withSentry` auto-instruments queue handlers
Workflows configured?	Recommend `instrumentWorkflowWithSentry`
Cron triggers configured?	`withSentry` auto-instruments scheduled handlers; recommend Crons monitoring
`nodejs_als` or `nodejs_compat` flag set?	Required — SDK needs `AsyncLocalStorage`
AI/LLM libraries?	Recommend AI Monitoring integrations
Companion frontend?	Trigger Phase 4 cross-link

Feature	Recommend when...
Error Monitoring	Always — non-negotiable baseline
Tracing	Always — HTTP request tracing and outbound fetch are high-value
Logging	App needs structured log search or log-to-trace correlation
Crons	Cron triggers configured in `wrangler.toml`
D1 Instrumentation	D1 database bindings present
Durable Objects	Durable Object bindings configured
Workflows	Workflow bindings configured
AI Monitoring	App uses Vercel AI SDK, OpenAI, Anthropic, or LangChain
Metrics	App needs custom counters, gauges, or distributions

You need to run this yourself — the wizard opens a browser for login and requires interactive input that the agent can't handle. Copy-paste into your terminal:
npx @sentry/wizard@latest -i sourcemaps
This sets up source map uploading so your production stack traces show readable code. It does not set up the SDK initialization — you still need to follow Option 2 below for the actual SDK setup.

Once it finishes, continue with Option 2 for SDK setup.

compatibility_flags = ["nodejs_als"]
# or: compatibility_flags = ["nodejs_compat"]

{
  "compatibility_flags": ["nodejs_als"]
}

npm install @sentry/cloudflare

import * as Sentry from "@sentry/cloudflare";

export default Sentry.withSentry(
  (env: Env) => ({
    dsn: env.SENTRY_DSN,
    tracesSampleRate: 1.0,
    enableLogs: true,
    dataCollection: {
      // To disable sending user data and HTTP bodies, uncomment the lines below. For more info visit:
      // https://docs.sentry.io/platforms/javascript/guides/cloudflare/configuration/options/#dataCollection
      // userInfo: false,
      // httpBodies: [],
    },
  }),
  {
    async fetch(request, env, ctx) {
      return new Response("Hello World!");
    },
  } satisfies ExportedHandler<Env>,
);

// functions/_middleware.ts
import * as Sentry from "@sentry/cloudflare";

export const onRequest = Sentry.sentryPagesPlugin((context) => ({
  dsn: context.env.SENTRY_DSN,
  tracesSampleRate: 1.0,
  enableLogs: true,
  dataCollection: {
    // To disable sending user data and HTTP bodies, uncomment the lines below. For more info visit:
    // https://docs.sentry.io/platforms/javascript/guides/cloudflare/configuration/options/#dataCollection
    // userInfo: false,
    // httpBodies: [],
  },
}));

import * as Sentry from "@sentry/cloudflare";

export const onRequest = [
  // Sentry must be first
  Sentry.sentryPagesPlugin((context) => ({
    dsn: context.env.SENTRY_DSN,
    tracesSampleRate: 1.0,
  })),
  // Add more middlewares here
];

import * as Sentry from "@sentry/cloudflare";

export const handle = ({ event, resolve }) => {
  return Sentry.wrapRequestHandler(
    {
      options: {
        dsn: event.platform.env.SENTRY_DSN,
        tracesSampleRate: 1.0,
      },
      request: event.request,
      context: event.platform.ctx,
    },
    () => resolve(event),
  );
};

npm install @sentry/hono @sentry/cloudflare

import { Hono } from "hono";
import { sentry } from "@sentry/hono/cloudflare";

type Bindings = { SENTRY_DSN: string };

const app = new Hono<{ Bindings: Bindings }>();

// Initialize Sentry middleware as early as possible
app.use(
  sentry(app, (env) => ({
    dsn: env.SENTRY_DSN,
    tracesSampleRate: 1.0,
  })),
);

app.get("/", (ctx) => ctx.json({ message: "Hello" }));

app.get("/error", () => {
  throw new Error("Test error");
});

export default app;

import { Hono } from "hono";
import * as Sentry from "@sentry/cloudflare";

const app = new Hono();

app.get("/", (ctx) => ctx.json({ message: "Hello" }));

export default Sentry.withSentry(
  (env: Env) => ({
    dsn: env.SENTRY_DSN,
    tracesSampleRate: 1.0,
  }),
  app,
);

# Local development: add to .dev.vars
echo 'SENTRY_DSN="https://examplePublicKey@o0.ingest.sentry.io/0"' >> .dev.vars

# Production: set as a secret
npx wrangler secret put SENTRY_DSN

interface Env {
  SENTRY_DSN: string;
  // ... other bindings
}

npm install @sentry/vite-plugin --save-dev

import { defineConfig } from "vite";
import { sentryVitePlugin } from "@sentry/vite-plugin";

export default defineConfig({
  build: {
    sourcemap: true,
  },
  plugins: [
    sentryVitePlugin({
      org: "___ORG_SLUG___",
      project: "___PROJECT_SLUG___",
      authToken: process.env.SENTRY_AUTH_TOKEN,
    }),
  ],
});

[version_metadata]
binding = "CF_VERSION_METADATA"

Feature	Reference file	Load when...
Error Monitoring	`references/error-monitoring.md`	Always (baseline) — unhandled exceptions, manual capture, scopes, enrichment
Tracing	`references/tracing.md`	HTTP request tracing, outbound fetch spans, D1 query spans, distributed tracing
Logging	`references/logging.md`	Structured logs via `Sentry.logger.*`, log-to-trace correlation
Crons	`references/crons.md`	Scheduled handler monitoring, `withMonitor`, check-in API
Durable Objects	`references/durable-objects.md`	Instrument Durable Object classes for error capture and spans

Option	Type	Default	Notes
`dsn`	`string`	—	Required. Read from `env.SENTRY_DSN` automatically if not set
`tracesSampleRate`	`number`	—	0–1; 1.0 in dev, lower in prod recommended
`tracesSampler`	`function`	—	Dynamic sampling function; mutually exclusive with `tracesSampleRate`
`dataCollection`	`object`	conservative unless set	Controls what data the SDK captures (`userInfo`, `httpBodies`, etc.). When omitted, falls back to `sendDefaultPii` (default `false`); passing the object — even `{}` — enables permissive defaults. See Data Collection Reference
`sendDefaultPii`	`boolean`	`false`	Legacy. Prefer `dataCollection` for control over captured data
`enableLogs`	`boolean`	`false`	Enable Sentry Logs product
`environment`	`string`	auto	Read from `env.SENTRY_ENVIRONMENT` if not set
`release`	`string`	auto	Detected from `CF_VERSION_METADATA.id` or `SENTRY_RELEASE`
`debug`	`boolean`	`false`	Read from `env.SENTRY_DEBUG` if not set. Log SDK activity to console
`tunnel`	`string`	—	Read from `env.SENTRY_TUNNEL` if not set
`beforeSend`	`function`	—	Filter/modify error events before sending
`beforeSendTransaction`	`function`	—	Filter/modify transaction events before sending
`beforeSendLog`	`function`	—	Filter/modify log entries before sending
`tracePropagationTargets`	`(string\|RegExp)[]`	all URLs	Control which outbound requests get trace headers
`skipOpenTelemetrySetup`	`boolean`	`false`	Opt-out of OpenTelemetry compatibility tracer
`instrumentPrototypeMethods`	`boolean \| string[]`	`false`	Durable Object: instrument prototype methods for RPC spans

dataCollection: {
  // To disable sending user data and HTTP bodies, uncomment the lines below. For more info visit:
  // https://docs.sentry.io/platforms/javascript/configuration/options/#dataCollection
  // userInfo: false,
  // httpBodies: [],
},

Variable	Purpose
`SENTRY_DSN`	DSN for Sentry init
`SENTRY_RELEASE`	Release version string
`SENTRY_ENVIRONMENT`	Environment name (`production`, `staging`)
`SENTRY_TRACES_SAMPLE_RATE`	Traces sample rate (parsed as float)
`SENTRY_DEBUG`	Enable debug mode (`"true"` / `"1"`)
`SENTRY_TUNNEL`	Tunnel URL for event proxying
`CF_VERSION_METADATA`	Cloudflare version metadata binding (auto-detected release)

Integration	Purpose
`dedupeIntegration`	Prevent duplicate events (disabled for Workflows)
`inboundFiltersIntegration`	Filter events by type, message, URL
`functionToStringIntegration`	Preserve original function names
`linkedErrorsIntegration`	Follow `cause` chains in errors
`fetchIntegration`	Trace outbound `fetch()` calls, create breadcrumbs
`honoIntegration`	Deprecated in v10.55.0 — use `@sentry/hono` package instead. Auto-capture Hono `onError` exceptions
`requestDataIntegration`	Attach request data to events
`consoleIntegration`	Capture `console.*` calls as breadcrumbs

// Add temporarily to your fetch handler, then remove
export default Sentry.withSentry(
  (env: Env) => ({
    dsn: env.SENTRY_DSN,
    tracesSampleRate: 1.0,
  }),
  {
    async fetch(request, env, ctx) {
      throw new Error("Sentry test error — delete me");
    },
  } satisfies ExportedHandler<Env>,
);

Check	How
Errors captured	Throw in a fetch handler, verify in Sentry
Tracing working	Check Performance tab for HTTP spans
Source maps working	Check stack trace shows readable file/line names
D1 spans (if configured)	Run a D1 query, check for `db.query` spans
Scheduled monitoring (if configured)	Trigger a cron, check Crons dashboard

# Check for companion frontend
ls frontend/ web/ client/ ui/ 2>/dev/null
cat package.json 2>/dev/null | grep -E '"react"|"vue"|"svelte"|"next"|"astro"'

# Check for companion backend in adjacent directories
ls ../backend ../server ../api 2>/dev/null
cat ../go.mod ../requirements.txt ../Gemfile 2>/dev/null | head -3

Issue	Cause	Solution
Events not appearing	DSN not set or `debug: false` hiding errors	Set `debug: true` temporarily in init options; verify `SENTRY_DSN` secret is set with `wrangler secret list`
`AsyncLocalStorage is not defined`	Missing compatibility flag	Add `nodejs_als` or `nodejs_compat` to `compatibility_flags` in `wrangler.toml`
Stack traces show minified code	Source maps not uploaded	Configure `@sentry/vite-plugin` or run `npx @sentry/wizard -i sourcemaps`; verify `SENTRY_AUTH_TOKEN` in CI
Events lost on short-lived requests	SDK not flushing before worker terminates	Ensure `withSentry` or `sentryPagesPlugin` wraps your handler — they use `ctx.waitUntil()` to flush
Hono errors not captured	Hono app not instrumented	Use `@sentry/hono/cloudflare` — import `sentry` middleware and call `app.use(sentry(app, options))`
Durable Object errors missing	DO class not instrumented	Wrap class with `Sentry.instrumentDurableObjectWithSentry()` — see `references/durable-objects.md`
D1 queries not creating spans	Handler not wrapped with `withSentry`, or querying a non-`env` binding	D1 bindings on `env` are auto-instrumented by `withSentry` (v10.57.0+) — no manual wrapping needed (`instrumentD1WithSentry` is deprecated). All query methods (`prepare`, `batch`, `exec`, `withSession`) are traced in v10.61.0+
Scheduled handler not monitored	`withSentry` not wrapping the handler	Ensure `export default Sentry.withSentry(...)` wraps your entire exported handler object
Release not auto-detected	`CF_VERSION_METADATA` binding not configured	Add `[version_metadata]` with `binding = "CF_VERSION_METADATA"` to `wrangler.toml`
Duplicate events in Workflows	Dedupe integration filtering step failures	SDK automatically disables dedupe for Workflows; verify you use `instrumentWorkflowWithSentry`

name	sentry-cloudflare-sdk
description	Full Sentry SDK setup for Cloudflare Workers and Pages. Use when asked to "add Sentry to Cloudflare Workers", "install @sentry/cloudflare", or configure error monitoring, tracing, logging, crons, or AI monitoring for Cloudflare Workers, Pages, Durable Objects, Queues, Workflows, or Hono on Cloudflare.
license	Apache-2.0
category	sdk-setup
parent	sentry-sdk-setup
disable-model-invocation	true

name	sentry-cloudflare-sdk
description	Full Sentry SDK setup for Cloudflare Workers and Pages. Use when asked to "add Sentry to Cloudflare Workers", "install @sentry/cloudflare", or configure error monitoring, tracing, logging, crons, or AI monitoring for Cloudflare Workers, Pages, Durable Objects, Queues, Workflows, or Hono on Cloudflare.
license	Apache-2.0
category	sdk-setup
parent	sentry-sdk-setup
disable-model-invocation	true

Frontend detected	Suggest skill
React	`sentry-react-sdk`
Next.js	`sentry-nextjs-sdk`
Svelte/SvelteKit	`sentry-svelte-sdk`
Vue/Nuxt	See docs.sentry.io/platforms/javascript/guides/vue/

Backend detected	Suggest skill
Go (`go.mod`)	`sentry-go-sdk`
Python (`requirements.txt`, `pyproject.toml`)	`sentry-python-sdk`
Ruby (`Gemfile`)	`sentry-ruby-sdk`
Node.js (Express, Fastify)	`sentry-node-sdk`

sentry-cloudflare-sdk

Opciones de instalación

Revisa los archivos de origen