Connect Cloudflare Observability
Agents query Workers logs, errors and metrics to debug what a Worker did; connect by signing in to Cloudflare.
Workers logs, errors and analytics for debugging.
Once Cloudflare Observability is connected, an agent can pull the logs of a Worker for a time window, count errors by status or message, discover which fields your logs contain, and narrow down to the requests that failed.
Before you start
- A Cloudflare account with Workers, and Workers Logs turned on for the Workers you care about (the observability setting in wrangler config or the Worker's dashboard settings). Without it there is nothing to query.
- A Cloudflare role that can read Workers analytics and logs.
- You must be an owner or admin of the woble workspace to save the connection.
Connect it
- Open Marketplace from the sidebar, switch to the Integrations tab, find Cloudflare Observability and press Connect.
- Press Continue with Cloudflare. A new tab opens at the Cloudflare dashboard. Sign in if needed.
- Cloudflare shows an authorisation page with the access woble asks for, focused on reading Workers observability data. Pick the account if you belong to several, then approve.
- The tab closes on its own. Nothing to copy.
- The card shows Connected and the agent panel lists query_worker_observability, observability_keys and observability_values.
Or ask an agent
Type @ruby connect Cloudflare Observability in any chat. The same card appears in the conversation; only owners and admins can complete it.
Try it
- "@atlas how many 5xx responses did the checkout-api Worker return in the last hour, grouped by error message?"
- "@atlas show me the last 20 log lines from the image-resizer Worker where the path contains /thumb"
Agents set the account, narrow to one Worker and a tight time window, and aggregate before pulling raw events. Long windows are slow.
If it does not connect
- You signed in with a Cloudflare login that is not a member of the account that owns the Workers. Remove and reconnect with the right one.
- The Worker has no logs because Workers Logs is disabled for it. Enable it and wait for new requests.
- The authorisation was revoked in the Cloudflare dashboard. Reconnect.
Press Test connection in Marketplace, Connected tab, to see the exact error. Remove followed by a fresh sign-in fixes most token problems.
Disconnect
Marketplace, Connected, Remove next to Cloudflare Observability. The tokens are deleted and agents lose the tools immediately.
More in this category
GitHubRepos, issues, pull requests, Actions and code search.
LinearIssues, projects and cycles for product teams.
Jira and ConfluenceAtlassian issues, boards and pages.
SentrySearch, triage and analyse issues, traces and releases.
SupabaseTables, SQL, migrations, edge functions and logs of your projects.
Neon PostgresProjects, branches and SQL on serverless Postgres.
Appwrite
Agents manage Appwrite users, databases, storage, functions, sites and messaging on Appwrite Cloud; you connect by signing in to your Appwrite account.
Cloudflare Workers
Agents list Workers and create or inspect KV namespaces, R2 buckets, D1 databases and Hyperdrive configs; connect by signing in to Cloudflare.