---
description: Detect, group, and investigate recurring failures in Cloudflare Workers, then route issues to your team or coding agent.
title: Issues
image: https://developers.cloudflare.com/workers/observability/issues/og.png?v=70c1409b88ecfd49
---

[Skip to content](#main-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.

# Issues

Last updated Sep 30, 2026|Copy as Markdown| [View as Markdown](https://developers.cloudflare.com/workers/observability/issues/index.md)| [Agent setup](https://developers.cloudflare.com/agent-setup/)

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.

![Issues overview showing occurrence totals and active and resolved issues.](https://developers.cloudflare.com/cdn-cgi/image/onerror=redirect,width=1856,height=864,format=webp/_astro/issues-overview.Dim3BiE9.png)

## 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](https://developers.cloudflare.com/workers/observability/issues/investigate/).

You can also create an [automation](https://developers.cloudflare.com/workers/observability/issues/automations/) 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
   ```


2. Deploy your Worker.npmyarnpnpm

   ```
   npx wrangler deploy
   ```

   ```
   yarn wrangler deploy
   ```

   ```
   pnpm wrangler deploy
   ```



1. Go to the **Issues** page. [Go to **Issues** ↗](https://dash.cloudflare.com/?to=/:account/workers/services/view/:worker/production/issues?status=active)
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: "<COMPATIBILITY_DATE>",
       observability: {
         issues: {
           enabled: true,
         },
       },
     },
   });
   ```


2. 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*

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

*src/index.tsts*

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

## Related resources

- [Investigate issues](https://developers.cloudflare.com/workers/observability/issues/investigate/)
- [Set up an automation](https://developers.cloudflare.com/workers/observability/issues/automations/)

## Pricing

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

## Limits

| Limit | Value |
| --- | --- |
| Automations per account | 50 |
| Minimum occurrence threshold | 1 |
| Recurrence inactivity period | 1 hour to 365 days |
| Completed automation-run history | 30 days |

Was this helpful?

YesNo

## On this page

[![](https://developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://developers.cloudflare.com/)

```json
{"@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-09-30","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/"}}
```