Telemetry
List keys
Run a query
List values
ModelsExpand Collapse
TelemetryQueryResponse object { run, statistics, agents, 5 more } Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).
Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).
run: object { id, accountId, dry, 8 more } The query run metadata including the query definition, execution status, and timeframe.
The query run metadata including the query definition, execution status, and timeframe.
Number of time-series buckets used for the query. Higher values produce more detailed series data.
query: object { id, adhoc, created, 6 more } A saved query definition with its parameters, metadata, and ownership information.
A saved query definition with its parameters, metadata, and ownership information.
parameters: object { calculations, datasets, filterCombination, 6 more }
calculations: optional array of object { operator, alias, key, keyType } Create Calculations to compute as part of the query.
Create Calculations to compute as part of the query.
Set the Datasets to query. Leave it empty to query all the datasets.
filterCombination: optional "and" or "or" or "AND" or "OR"Set a Flag to describe how to combine the filters on the query.
Set a Flag to describe how to combine the filters on the query.
filters: optional array of object { filterCombination, filters, kind } or object { key, operation, type, 2 more } Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
WorkersObservabilityFilterLeaf object { key, operation, type, 2 more } A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error.
operation: "includes" or "not_includes" or "starts_with" or 25 moreComparison operator. String operators: includes, not_includes, starts_with, regex. Existence: exists, is_null. Set membership: in, not_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte.
Comparison operator. String operators: includes, not_includes, starts_with, regex. Existence: exists, is_null. Set membership: in, not_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte.
type: "string" or "number" or "boolean"Data type of the filter field. Must match the actual type of the key being filtered.
Data type of the filter field. Must match the actual type of the key being filtered.
Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted.
havings: optional array of object { key, operation, value } Configure the Having clauses that filter on calculations in the query result.
Configure the Having clauses that filter on calculations in the query result.
Set a limit on the number of results / records returned by the query
statistics: object { bytes_read, elapsed, rows_read, abr_level } Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency.
Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency.
agents: optional array of object { agentClass, eventTypeCounts, firstEventMs, 5 more } Durable Object agent summaries. Present when the query view is ‘agents’. Each entry represents an agent with its event counts and status.
Durable Object agent summaries. Present when the query view is ‘agents’. Each entry represents an agent with its event counts and status.
calculations: optional array of object { aggregates, calculation, series, alias } Aggregated calculation results. Present when the query view is ‘calculations’. Contains computed metrics (count, avg, p99, etc.) with optional group-by breakdowns and time-series data.
Aggregated calculation results. Present when the query view is ‘calculations’. Contains computed metrics (count, avg, p99, etc.) with optional group-by breakdowns and time-series data.
compare: optional array of object { aggregates, calculation, series, alias } Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.
Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.
events: optional object { count, events, fields, series } Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata.
Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata.
Total number of events matching the query (may exceed the number returned due to limits).
events: optional array of object { "$metadata", dataset, source, 3 more } List of individual telemetry events matching the query.
List of individual telemetry events matching the query.
"$metadata": object { id, account, cloudService, 28 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Whether this was a cold start (1) or warm invocation (0).
Templatized version of the error message used for grouping similar errors.
Templatized version of the log message used for grouping similar messages.
Cloudflare request ID that ties all logs from a single invocation together.
HTTP response status code returned by the Worker.
Total duration of the entire trace in milliseconds.
source: string or unknownRaw log payload. May be a string or a structured object depending on how the log was emitted.
Raw log payload. May be a string or a structured object depending on how the log was emitted.
Cloudflare Containers event information that enriches your logs for identifying and debugging issues.
"$workers": optional object { eventType, requestId, scriptName, 9 more } or object { cpuTimeMs, eventType, outcome, 13 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
object { eventType, requestId, scriptName, 9 more }
fields: optional array of object { key, type } List of fields discovered in the matched events. Useful for building dynamic UIs.
List of fields discovered in the matched events. Useful for building dynamic UIs.
invocations: optional map[array of object { "$metadata", dataset, source, 3 more } ]Events grouped by invocation (request ID). Present when the query view is ‘invocations’. Each key is a request ID mapping to all events from that invocation.
Events grouped by invocation (request ID). Present when the query view is ‘invocations’. Each key is a request ID mapping to all events from that invocation.
"$metadata": object { id, account, cloudService, 28 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Whether this was a cold start (1) or warm invocation (0).
Templatized version of the error message used for grouping similar errors.
Templatized version of the log message used for grouping similar messages.
Cloudflare request ID that ties all logs from a single invocation together.
HTTP response status code returned by the Worker.
Total duration of the entire trace in milliseconds.
source: string or unknownRaw log payload. May be a string or a structured object depending on how the log was emitted.
Raw log payload. May be a string or a structured object depending on how the log was emitted.
Cloudflare Containers event information that enriches your logs for identifying and debugging issues.
"$workers": optional object { eventType, requestId, scriptName, 9 more } or object { cpuTimeMs, eventType, outcome, 13 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
Cloudflare Workers event information that enriches your logs for identifying and debugging issues.