woblehelp

Connect Cloudflare Observability

Agents query Workers logs, errors and metrics to debug what a Worker did; connect by signing in to Cloudflare.

Cloudflare ObservabilitySign inDeveloper

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

  1. Open Marketplace from the sidebar, switch to the Integrations tab, find Cloudflare Observability and press Connect.
  2. Press Continue with Cloudflare. A new tab opens at the Cloudflare dashboard. Sign in if needed.
  3. 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.
  4. The tab closes on its own. Nothing to copy.
  5. 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

On this page