Workers Usage Alerts Hit Your Inbox
Once your Worker is live, keeping tabs on production traffic shouldn't require a daily dashboard check. Cloudflare is introducing usage notifications for the Workers platform that deliver the key metrics directly to your inbox, letting you monitor request volumes and performance without interrupting your workflow.
Two notification types are rolling out. The first is a weekly summary that aggregates account-level usage and highlights your most active Workers. The second is an on-demand alert that fires when a specific Worker's CPU consumption spikes more than 25% above its average over the previous seven days, allowing you to catch sudden traffic surges or code regressions as they happen.
For new free accounts, both notification types will be enabled from the start. Existing accounts of any plan will receive them only after opting in via the dashboard, though Cloudflare plans to expand the default-on policy to all customers once the feature has matured based on user feedback.
Weekly Digest: Account-Level Metrics and Top Workers
The weekly summary provides a high-level operational picture without requiring login. It reports total request counts, total duration, and egress data transfer across your entire account. The email also breaks out your most popular Workers, including their median CPU time.
Note the distinction between duration and CPU time. Duration measures the full time your Worker spends responding to a request, while CPU time measures only the computational work performed at the Cloudflare edge. CPU time excludes time spent waiting on network operations, such as calls to third-party APIs, offering a clearer signal on script efficiency.
Event-Driven Usage Report
Where the weekly summary is a routine snapshot, the Workers Usage Report is an event-driven alert designed for immediate action. It targets Workers whose CPU time has jumped more than 25% relative to their seven-day average.
Such spikes can be entirely expected—for example, after a deployment that intentionally adds more compute-intensive logic. But they can also point to a bug or an unexpectedly expensive code path. This notification is meant to surface those changes immediately so you can diagnose and fix them before they affect your application or your bill.
Enabling Notifications
To opt in, navigate to the Notifications section of your Cloudflare zone dashboard and click Add.
Under the Workers product, you will find two new entries below the standard “Create Notifications” options.
Clicking Select next to “Weekly Summary” opens the configuration flow, where you can choose email recipients, webhooks, or PagerDuty integration.
Similarly, selecting “Usage Report” for the CPU threshold notifications leads to a parallel setup experience for configuring the contact methods for these alerts.
Rollout and Feedback
While default-on notifications are currently limited to new free plans, Cloudflare intends to enable them broadly in the future. Feedback is being collected through the Developer Community Discord and via surveys embedded in the notification emails.
These two notification types represent an initial step toward a broader notification framework designed to give developers more visibility and control over their Workers deployments, surfacing relevant data at the moment it matters most.
