Issues

Last updated Oct 12, 2026 Issues provides built-in error monitoring for Cloudflare Workers. It detects production failures and groups related failures into issues without an SDK or application wrapper.

Enable source maps so captured JavaScript and TypeScript exception stacks point to the original files and lines. Framework builds must generate maps as well as upload them.

How Issues works

When a Worker throws an uncaught exception, fails an invocation, returns a 5xx response, or logs an error, Issues records the failure as an occurrence. It groups related occurrences from the same Worker into one issue.

Use the Issues overview to identify recurring failures and changes in activity. To review the diagnostic context for a failure, refer to Investigate issues.

You can also create an automation to automatically send an issue to a coding agent, webhook, chat service, or incident-management tool.

Enable Issues

You can enable Issues through Wrangler, the dashboard, or the Cloudflare CLI (cf).

Requires Wrangler 4.134.0 or later.

1. In your Worker's Wrangler configuration file, set observability.issues.enabled to true.

jsonc { "$schema": "./node_modules/wrangler/config-schema.json", "observability": { "issues": { "enabled": true } } }

toml [observability.issues] enabled = true

1. Deploy your Worker.npmyarnpnpm

npx wrangler deploy

yarn wrangler deploy

pnpm wrangler deploy

1. Go to the Issues page. Go to Issues ↗
2. Select Enable issues.

Note

If you deploy with Wrangler, also set observability.issues.enabled to true in your Wrangler configuration file. Otherwise, the next deployment turns off Issues.

1. In your cloudflare.config.ts file, set worker.observability.issues.enabled to true.

cloudflare.config.tsts

```ts import { defineConfig } from "cf/config"; import * as entrypoint from "./src/index.ts" with { type: "cf-worker" };

export default defineConfig({ worker: { name: "example-worker", entrypoint, compatibilityDate: "", observability: { issues: { enabled: true, }, }, }, }); ```

1. Deploy your Worker.

sh cf deploy

Issues processes new traffic after you enable it. It does not process historical failures. Send production traffic to the Worker, then open a detected issue in the Issues dashboard.

Report handled errors

To record an error that your application catches, pass the caught value to console.error() before returning a fallback response.

src/index.jsjs

try {
    return await handleRequest(request);
} catch (error) {
    console.error(error);
    return new Response("Service unavailable", { status: 503 });
}

src/index.tsts

try {
    return await handleRequest(request);
} catch (error) {
    console.error(error);
    return new Response("Service unavailable", { status: 503 });
}

Related resources

• Investigate issues
• Set up an automation

Pricing

Issues is available to all Workers accounts in open beta. It is free to use during the beta period.

Limits

Was this helpful?

YesNo

On this page

Docs

{"@context":"https://schema.org","@type":"WebPage","@id":"https://developers.cloudflare.com/workers/observability/issues/#page","headline":"Issues","description":"Detect, group, and investigate recurring failures in Cloudflare Workers, then route issues to your team or coding agent.","url":"https://developers.cloudflare.com/workers/observability/issues/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/observability/issues/og.png?v=70c1409b88ecfd49","dateModified":"2026-10-12","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Route Workers Issues to coding agents, webhooks, chat services, or incident-management tools based on configurable triggers. title: Set up an automation image: https://developers.cloudflare.com/workers/observability/issues/automations/og.png?v=0d61505f991cb251

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.