POST /accounts/{account_id}/workers/observability/telemetry/query

Your Cloudflare account ID.

Default value: "application/json"

Whether to perform a dry run without saving the results of the query. Useful for validation

Default value: false

Whether to ignore time-series data in the results and return only aggregated values

Default value: false

Timeframe for your query using Unix timestamps in milliseconds. Provide from/to epoch ms; narrower timeframes provide faster responses and more specific results.

End timestamp for the query timeframe (Unix timestamp in milliseconds)

Start timestamp for the query timeframe (Unix timestamp in milliseconds)

Optional parameters to pass to the query execution

Set the Datasets to query. Leave it empty to query all the datasets.

Configure the Filters to apply to the query. Supports nested groups via kind: 'group'. Maximum nesting depth is 4.

Set a limit on the number of results / records returned by the query

Set a Flag to describe how to combine the filters on the query.

Valid values:

• "AND"
• "and"
• "or"
• "OR"

Configure the order of the results returned by the query.

Set the order of the results

Valid values:

• "desc"
• "asc"

Configure which Calculation to order the results by.

Define an expression to search using full-text search.

Define how to group the results of the query.

Valid values:

• "string"
• "boolean"
• "number"

Configure the Having clauses that filter on calculations in the query result.

Valid values:

• "gt"
• "gte"
• "eq"
• "lte"
• "neq"
• "lt"

Create Calculations to compute as part of the query.

Valid values:

• "count"
• "MAX"
• "p10"
• "COUNT_DISTINCT"
• "P05"
• "sum"
• "median"
• "p90"
• "P99"
• "MIN"
• "P999"
• "P75"
• "P25"
• "P01"
• "stddev"
• "p001"
• "COUNT"
• "P95"
• "VARIANCE"
• "min"
• "p01"
• "p25"
• "p75"
• "p99"
• "p95"
• "STDDEV"
• "AVG"
• "MEDIAN"
• "P10"
• "max"
• "variance"
• "uniq"
• "P90"
• "p05"
• "P001"
• "avg"
• "p999"
• "SUM"

The key to use for the calculation. This key must exist in the logs. Use the observability_keys response to confirm. Do not guess keys.

Valid values:

• "string"
• "boolean"
• "number"

Examples by view type. Events: show errors for a worker in the last 30 minutes. Calculations: p99 of wall time or count by status code. Invocations: find a specific request that resulted in a 500.

Valid values:

• "requests"
• "calculations"
• "agents"
• "traces"
• "events"
• "invocations"

Default value: "calculations"

Numeric offset for pattern results (top-N list). Use with limit to page pattern groups; not used by cursor pagination.

Whether to include timeseties data in the response

Use this limit to cap the number of events returned when the view is events.

Default value: 50

Unique identifier for the query to execute

Direction for offset-based pagination (e.g., 'next', 'prev')

This is only used when the view is calculations. Leaving it empty lets Workers Observability detect the correct granularity.

Whether to include comparison data with previous time periods

Cursor pagination for event/trace/invocation views. Pass the last item's $metadata.id as the next offset.