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
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
- In the dashboard, go to Manage Account → API Tokens (account token) or My Profile → API Tokens (user token).
- Create a custom token with one permission: Account · Account Analytics · Read.
- 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
| What | Dataset | Fields |
|---|---|---|
| Worker requests, errors | workersInvocationsAdaptive | sum.requests, sum.errors |
| Durable Object requests | durableObjectsInvocationsAdaptiveGroups | sum.requests |
| Durable Object rows | durableObjectsPeriodicGroups | sum.rowsRead, sum.rowsWritten |
| Durable Object storage | durableObjectsStorageGroups | max.storedBytes |
| KV operations | kvOperationsAdaptiveGroups | sum.requests by dimensions.actionType |
| D1 rows | d1AnalyticsAdaptiveGroups | sum.rowsRead, sum.rowsWritten |
| Workers AI neurons | aiInferenceAdaptiveGroups | sum.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.
- Setup takes a minute: it opens Cloudflare’s token page with the read-only permission already selected.
- The token stays in your Mac’s Keychain and is sent only to Cloudflare. There’s no FlareMeter server.
- Free and open source (GitHub).
Which should you use?
| Dashboard | GraphQL API | FlareMeter | |
|---|---|---|---|
| Cost | Free | Free | Free |
| Setup | None | Token + code | Token, one minute |
| All products in one view | No | If you build it | Yes |
| Against your plan’s limits | Partly | If you build it | Yes |
| Always visible | No | Alerts only | Menu bar and widgets |
| Alerts | Budget alerts, next day | If you build them | Every 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: