1. Home
  2. Guides
  3. How to monitor Cloudflare Workers usage

How to monitor Cloudflare Workers usage

Three ways to see how much of your Cloudflare plan you've used: the dashboard, the GraphQL Analytics API (with queries), and a menu bar meter.

Last updated October 21, 2026

Quick answer
Use the Cloudflare dashboard (Workers & Pages → overview) for a quick look, the GraphQL Analytics API with a read-only Account Analytics · Read token for scripts and alerts, or a menu bar app like FlareMeter to see every product against your plan without opening anything.

1. The Cloudflare dashboard

Workers & Pages shows requests and errors for your Workers, and each Worker’s Metrics tab breaks them down. KV namespaces, D1 databases and Durable Objects each have their own usage pages, and Manage Account → Billing shows billable usage on Workers Paid.

It’s accurate and free, but spread across several pages, and you have to remember to look. That’s how most people find out about a limit: after they hit it.

2. The GraphQL Analytics API

Everything the dashboard shows comes from Cloudflare’s GraphQL Analytics API, which you can query yourself.

Create a read-only token

  1. In the dashboard, go to Manage Account → API Tokens (account token) or My Profile → API Tokens (user token).
  2. Create a custom token with one permission: Account · Account Analytics · Read.
  3. Copy your Account ID from the account home page.

Query today’s Worker requests

curl https://api.cloudflare.com/client/v4/graphql \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"query": "{ viewer { accounts(filter: { accountTag: \"YOUR_ACCOUNT_ID\" }) { workersInvocationsAdaptive(limit: 100, filter: { datetime_geq: \"2026-10-10T00:00:00Z\", datetime_lt: \"2026-10-10T23:59:59Z\" }) { sum { requests errors } dimensions { scriptName } } } } }"}'

sum.requests per scriptName is each Worker’s request count in the time window. Use today’s 00:00 UTC as the start to compare with the Free plan’s daily limit, or the 1st of the month for Workers Paid.

The datasets for each product

WhatDatasetFields
Worker requests, errorsworkersInvocationsAdaptivesum.requests, sum.errors
Durable Object requestsdurableObjectsInvocationsAdaptiveGroupssum.requests
Durable Object rowsdurableObjectsPeriodicGroupssum.rowsRead, sum.rowsWritten
Durable Object storagedurableObjectsStorageGroupsmax.storedBytes
KV operationskvOperationsAdaptiveGroupssum.requests by dimensions.actionType
D1 rowsd1AnalyticsAdaptiveGroupssum.rowsRead, sum.rowsWritten
Workers AI neuronsaiInferenceAdaptiveGroupssum.totalNeurons

Some of these field names aren’t in Cloudflare’s documentation yet and can differ between accounts. An introspection query ({ __type(name: "Account") { fields { name } } }) lists what your account exposes.

From here you can build alerts: a scheduled Worker that runs these queries every 15 minutes and posts to Slack or email when a metric passes 80% of its limit. Compare against the numbers in the Free limits and Paid pricing guides.

3. A menu bar meter: FlareMeter

FlareMeter runs those queries for you every 15 minutes, for Workers, Durable Objects, KV, D1 and Workers AI, and compares each one with your plan. The fullest limit’s percentage sits in your Mac’s menu bar; click it for every metric, the time until the daily reset on Free, or estimated charges on Paid. Desktop widgets show the same reading, and notifications warn you when a limit gets close, estimated charges pass your budget, or a metric spikes to 10× its usual rate.

Which should you use?

DashboardGraphQL APIFlareMeter
CostFreeFreeFree
SetupNoneToken + codeToken, one minute
All products in one viewNoIf you build itYes
Against your plan’s limitsPartlyIf you build itYes
Always visibleNoAlerts onlyMenu bar and widgets
AlertsBudget alerts, next dayIf you build themEvery 15 minutes, with spike detection

Frequently asked questions

Where do I see Cloudflare Workers usage in the dashboard?

Open dash.cloudflare.com, choose your account, then Workers & Pages. The overview shows requests across your Workers; each Worker's Metrics tab shows its own. KV, D1 and Durable Objects each show usage on their own pages.

Which API token permission do I need to read Workers usage?

Account → Account Analytics → Read. It's read-only: it can query analytics through the GraphQL Analytics API but can't change anything on the account.

How current is Cloudflare's analytics data?

Usually a few minutes behind real time. Checking every 5 to 15 minutes is plenty, and stays well inside the API's rate limits.

Can I get notified before I hit a Workers limit?

Yes. FlareMeter sends a macOS notification when a metric reaches 80% of its limit (you can change the level), when it hits the limit, and when usage suddenly spikes. Cloudflare's own budget alerts work on usage it processes once a day, so they arrive the day after. You can also build your own check on the GraphQL Analytics API, with a scheduled Worker that compares usage to your plan.

Sources

Figures as of October 2026, from Cloudflare’s documentation. Cloudflare changes pricing from time to time, so check the current pages before relying on them:

Skip the math. FlareMeter puts these numbers in your Mac’s menu bar: your fullest limit as a percentage, every product against your plan, refreshed every 15 minutes.
Get FlareMeter · Free

More guides