Query Cloudflare Workers Observability Logs

Query the CF Workers Observability API to retrieve structured logs from any Workers, Durable Objects, Workflows, Queues, and Cron Triggers in your Cloudflare account.

Prerequisites

Set these environment variables (e.g. in your project's .env or shell profile):

• - CF_OBSERVABILITY_ACCOUNT_ID — your Cloudflare account ID
• INLINECODE2 — API token with Workers Observability read permission

API Endpoint

CODEBLOCK0

Request Body Format

CODEBLOCK1

Filter Operations

• - String: eq, neq, includes, doesNotInclude, startsWith, regex, exists, INLINECODE10
• Number: eq, neq, gt, gte, lt, lte, exists, INLINECODE18

Standard Fields

Any custom fields logged via console.log({ key: value }) are also queryable as top-level fields.

Full-text Search

Use needle.value for free-text search across all fields. Useful when you don't know which field contains the value.

How to Execute

Use Bash with curl to call the API. Do NOT use WebFetch (it processes through an AI model and loses structure).

Step 1: Read credentials

Read CF_OBSERVABILITY_ACCOUNT_ID and CF_OBSERVABILITY_API_TOKEN from environment variables. If not set in the shell, search for them in project .env files:

CODEBLOCK2

Step 2: Build and execute query

Construct the curl command based on the user's request. Default time range: last 1 hour. Default limit: 30.

Step 3: Format output

Parse the JSON response and format as a timeline:

CODEBLOCK3

Events are in result.events.events[]. Each event has:

• - source: structured log fields (msg, level, plus any custom fields)
• INLINECODE46: Worker metadata (scriptName, outcome, eventType, entrypoint)
• INLINECODE47: system metadata (timestamp, requestId)
• INLINECODE48: event timestamp in unix ms

Sort events by timestamp ascending for chronological view.

Common Query Patterns

By Worker name

Errors only

By entrypoint (Durable Object / Workflow class)

By event type (alarm, queue, scheduled, etc.)

Exceptions (Worker crashed)

Custom field filter

Free-text search

Combine filters

Argument Parsing

When invoked as /cf-workers-logs, parse $ARGUMENTS for:

• - worker=my-worker → filter by INLINECODE52
• INLINECODE53 → filter by level
• INLINECODE54 → filter by INLINECODE55
• INLINECODE56 → filter by INLINECODE57
• INLINECODE58 → needle search
• INLINECODE59 → filter by custom field
• INLINECODE60 / last=30m / last=24h → time range (default: 1h)
• INLINECODE63 → result limit (default: 30)
• No arguments → show recent errors across all Workers (last 1h, level=error)

Multiple arguments can be combined: INLINECODE64