--- title: Observability --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Workers](https://developers.cloudflare.com/api/resources/workers) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Observability #### ObservabilityTelemetry ##### [List keys](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/telemetry/methods/keys) POST/accounts/{account\_id}/workers/observability/telemetry/keys ##### [Run a query](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/telemetry/methods/query) POST/accounts/{account\_id}/workers/observability/telemetry/query ##### [List values](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/telemetry/methods/values) POST/accounts/{account\_id}/workers/observability/telemetry/values ##### [Prepare live tail](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/telemetry/methods/live_tail) POST/accounts/{account\_id}/workers/observability/telemetry/live-tail ##### [Live tail heartbeat](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/telemetry/methods/live_tail_heartbeat) POST/accounts/{account\_id}/workers/observability/telemetry/live-tail/heartbeat ##### ModelsExpand Collapse
TelemetryKeysResponse object {key, lastSeenAt, type } key: string Link to this property lastSeenAt: number Link to this property
type: "string"or "boolean"or "number" One of the following: "string" Link to this property "boolean" Link to this property "number" Link to this property
Link to this property
[Link to this property](<#(resource)%20workers.observability.telemetry%20%3E%20(model)%20telemetry_keys_response%20%3E%20(schema)>)
TelemetryQueryResponse object {run, statistics, agents, 6 more } 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 } Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics. id: string Unique identifier for this query run. Link to this property accountId: string Cloudflare account ID that owns this query run. Link to this property dry: boolean Whether this was a dry run (results not persisted). Link to this property granularity: number Number of time-series buckets used for the query. Higher values produce more detailed series data. Link to this property
query: object {id, adhoc, created, 6 more } A saved query definition with its parameters, metadata, and ownership information. id: string Link to this property adhoc: boolean If the query wasn’t explcitly saved Link to this property
created: stringor string formatdate-time One of the following: string Link to this property string Link to this property
Link to this property createdBy: string Link to this property description: string maxLength1000 Link to this property name: string Query name maxLength250 minLength1 Link to this property
parameters: object {calculations, datasets, filterCombination, 6 more }
calculations: optional array of object {operator, alias, key, keyType } or object {key, operator, alias, keyType } Create Calculations to compute as part of the query. One of the following:
object {operator, alias, key, keyType }
operator: "count"or "COUNT" One of the following: "count" Link to this property "COUNT" Link to this property
Link to this property alias: optional string Link to this property key: optional string Link to this property
keyType: optional "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property
Link to this property
object {key, operator, alias, keyType } key: string Link to this property
operator: "uniq"or "max"or "min"or 33 more One of the following: "uniq" Link to this property "max" Link to this property "min" Link to this property "sum" Link to this property "avg" Link to this property "median" Link to this property "p001" Link to this property "p01" Link to this property "p05" Link to this property "p10" Link to this property "p25" Link to this property "p75" Link to this property "p90" Link to this property "p95" Link to this property "p99" Link to this property "p999" Link to this property "stddev" Link to this property "variance" Link to this property "COUNT\_DISTINCT" Link to this property "MAX" Link to this property "MIN" Link to this property "SUM" Link to this property "AVG" Link to this property "MEDIAN" Link to this property "P001" Link to this property "P01" Link to this property "P05" Link to this property "P10" Link to this property "P25" Link to this property "P75" Link to this property "P90" Link to this property "P95" Link to this property "P99" Link to this property "P999" Link to this property "STDDEV" Link to this property "VARIANCE" Link to this property
Link to this property alias: optional string Link to this property
keyType: optional "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property
Link to this property
Link to this property datasets: optional array of string Set the Datasets to query. Leave it empty to query all the datasets. Link to this property
filterCombination: optional "and"or "or"or "AND"or "OR" Set a Flag to describe how to combine the filters on the query. One of the following: "and" Link to this property "or" Link to this property "AND" Link to this property "OR" Link to this property
Link to this property
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’. One of the following:
object {filterCombination, filters, kind }
filterCombination: "and"or "or"or "AND"or "OR" One of the following: "and" Link to this property "or" Link to this property "AND" Link to this property "OR" Link to this property
Link to this property filters: array of unknown Link to this property kind: "group" Link to this property
Link to this property
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. key: string 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. Link to this property
operation: "includes"or "not\_includes"or "starts\_with"or 27 more Comparison operator. String operators: includes, not\_includes, starts\_with, ends\_with, regex. Existence: exists, is\_null. Set membership: in, not\_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte. One of the following: "includes" Link to this property "not\_includes" Link to this property "starts\_with" Link to this property "ends\_with" Link to this property "regex" Link to this property "exists" Link to this property "is\_null" Link to this property "in" Link to this property "not\_in" Link to this property "eq" Link to this property "neq" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property "=" Link to this property "!=" Link to this property ">" Link to this property ">=" Link to this property "<" Link to this property "<=" Link to this property "INCLUDES" Link to this property "DOES\_NOT\_INCLUDE" Link to this property "MATCH\_REGEX" Link to this property "EXISTS" Link to this property "DOES\_NOT\_EXIST" Link to this property "IN" Link to this property "NOT\_IN" Link to this property "STARTS\_WITH" Link to this property "ENDS\_WITH" Link to this property
Link to this property
type: "string"or "number"or "boolean" Data type of the filter field. Must match the actual type of the key being filtered. One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property kind: optional "filter" Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
value: optional stringor numberor boolean Comparison value. Must match actual values in your data — verify with the values endpoint. Ensure the value type (string/number/boolean) matches the field type. String comparisons are case-sensitive. Regex uses RE2 syntax (no lookaheads/lookbehinds). One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property
Link to this property
groupBys: optional array of object {type, value } Define how to group the results of the query.
type: "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property value: string Link to this property
Link to this property
havings: optional array of object {key, operation, value } Configure the Having clauses that filter on calculations in the query result. key: string Link to this property
operation: "eq"or "neq"or "gt"or 3 more One of the following: "eq" Link to this property "neq" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property
Link to this property value: number Link to this property
Link to this property limit: optional number Set a limit on the number of results / records returned by the query maximum100 minimum0 Link to this property
needle: optional object {value, isRegex, matchCase } Define an expression to search using full-text search. value: Link to this property isRegex: optional boolean Link to this property matchCase: optional boolean Link to this property
Link to this property
orderBy: optional object {value, order } Configure the order of the results returned by the query. value: string Configure which Calculation to order the results by. Link to this property
order: optional "asc"or "desc" Set the order of the results One of the following: "asc" Link to this property "desc" Link to this property
Link to this property
Link to this property
Link to this property
updated: stringor string formatdate-time One of the following: string Link to this property string Link to this property
Link to this property updatedBy: string Link to this property
Link to this property
status: "STARTED"or "COMPLETED" Current execution status of the query run. One of the following: "STARTED" Link to this property "COMPLETED" Link to this property
Link to this property
timeframe: object {from, to } Time range for the query execution. ‘from’ must be earlier than ‘to’. No fractional milliseconds. from: number Start timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property to: number End timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property
Link to this property userId: string ID of the user who initiated the query run. Link to this property created: optional string ISO-8601 timestamp when the query run was created. Link to this property
statistics: optional object {bytes\_read, elapsed, rows\_read, abr\_level } Query performance statistics from the database (does not include network latency). bytes\_read: number Number of uncompressed bytes read from the table. Link to this property elapsed: number Time in seconds for the query to run. Link to this property rows\_read: number Number of rows scanned from the table. Link to this property abr\_level: optional number The level of Adaptive Bit Rate (ABR) sampling used for the query. If empty the ABR level is 1 Link to this property
Link to this property updated: optional string ISO-8601 timestamp when the query run was last updated. Link to this property
Link to this property
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. bytes\_read: number Number of uncompressed bytes read from the table. Link to this property elapsed: number Time in seconds for the query to run. Link to this property rows\_read: number Number of rows scanned from the table. Link to this property abr\_level: optional number The level of Adaptive Bit Rate (ABR) sampling used for the query. If empty the ABR level is 1 Link to this property
Link to this property
agents: optional array of object {id, errors, models, 13 more } Agent run summaries. Present when the query view is ‘agents’. Each entry represents one trace containing at least one agent invocation. id: string Stable pagination cursor for this agent run. Link to this property errors: array of string Distinct errors reported by spans in the run. Link to this property models: array of string Distinct models reported by chat spans across the run’s trace. Link to this property providers: array of string Distinct GenAI providers reported by chat spans in the run. Link to this property services: array of string Worker services represented in the run’s trace. Link to this property spans: number Number of spans in the run’s trace. Link to this property
status: "completed"or "error" Observed run status. One of the following: "completed" Link to this property "error" Link to this property
Link to this property traceDurationMs: number Total trace duration in milliseconds. Link to this property traceEndMs: number End of the run’s trace as a Unix epoch in milliseconds. Link to this property traceId: string Trace identifier for this agent run. Link to this property traceStartMs: number Start of the run’s trace as a Unix epoch in milliseconds. Link to this property agentId: optional string ID from the earliest agent invocation that provides one. Link to this property agentName: optional string Name from the earliest agent invocation that provides one. Link to this property conversationId: optional string Conversation ID from the earliest invocation that provides one. Link to this property inputTokens: optional number Input tokens summed across chat spans in the run’s trace; informational, not billing data. Link to this property outputTokens: optional number Output tokens summed across chat spans in the run’s trace; informational, not billing data. Link to this property
Link to this property
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.
aggregates: array of object {count, interval, sampleInterval, 2 more } count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property value: number Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property
groups: optional array of object {key, value } key: string Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property
Link to this property calculation: string Link to this property
series: array of object {data, time }
data: array of object {count, interval, sampleInterval, 4 more } count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property value: number Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property firstSeen: optional string Link to this property
groups: optional array of object {key, value } key: string Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property lastSeen: optional string Link to this property
Link to this property time: string Link to this property
Link to this property alias: optional string Link to this property
Link to this property
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.
aggregates: array of object {count, interval, sampleInterval, 2 more } count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property value: number Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property
groups: optional array of object {key, value } key: string Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property
Link to this property calculation: string Link to this property
series: array of object {data, time }
data: array of object {count, interval, sampleInterval, 4 more } count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property value: number Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property firstSeen: optional string Link to this property
groups: optional array of object {key, value } key: string Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property lastSeen: optional string Link to this property
Link to this property time: string Link to this property
Link to this property alias: optional string Link to this property
Link to this property
distribution: optional object {bins, bucketBoundaries, bucketMode, 2 more } Bucketed 2D histogram of a numeric field over time. Present when chartType is ‘distribution’. bins: array of string Time-bucket labels (ISO-8601 strings), one per matrix column. Link to this property bucketBoundaries: array of number Raw bucket edges in the value’s native unit, length buckets.length + 1. Used for the colour scale and percentile mapping. Link to this property
bucketMode: "log"or "linear" Bucketing scheme used to derive the boundaries. ‘log’ produces geometric edges; ‘linear’ produces fixed-width edges. One of the following: "log" Link to this property "linear" Link to this property
Link to this property buckets: array of string Value-range labels, one per matrix row (e.g. ‘50–100ms’). Link to this property matrix: array of array of number Sampling-corrected counts. matrix\[bucketIdx]\[binIdx] is the estimated number of events in value-bucket ‘bucketIdx’ during time-bin ‘binIdx’. Link to this property
Link to this property
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. count: optional number Total number of events matching the query (may exceed the number returned due to limits). Link to this property
events: optional array of object {"$metadata", dataset, source, 3 more } List of individual telemetry events matching the query.
"$metadata": object {id, account, cloudService, 32 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation. id: string Unique event ID. Use as the cursor value for offset-based pagination. Link to this property account: optional string Cloudflare account identifier. Link to this property cloudService: optional string Cloudflare product that generated this event (e.g. workers, pages). Link to this property coldStart: optional number exclusiveMinimum minimum0 Link to this property cost: optional number Estimated cost units for this invocation. exclusiveMinimum minimum0 Link to this property duration: optional number Span duration in milliseconds. exclusiveMinimum minimum0 Link to this property endTime: optional number Span end time as a Unix epoch in milliseconds. minimum0 Link to this property endTimeNs: optional string Span end time as a Unix epoch in nanoseconds. Link to this property error: optional string Error message, present when the log represents an error. Link to this property errorTemplate: optional string Templatized version of the error message used for grouping similar errors. Link to this property fingerprint: optional string Content-based fingerprint used to group similar events. Link to this property level: optional string Log level (e.g. log, debug, info, warn, error). Link to this property message: optional string Log message text. Link to this property messageTemplate: optional string Templatized version of the log message used for grouping similar messages. Link to this property metricName: optional string Metric name when the event represents a metric data point. Link to this property origin: optional string Origin of the event (e.g. fetch, scheduled, queue). Link to this property parentSpanId: optional string Span ID of the parent span in the trace hierarchy. Link to this property provider: optional string Infrastructure provider identifier. Link to this property rayId: optional string Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation. Link to this property region: optional string Cloudflare data center / region that handled the request. Link to this property requestId: optional string Cloudflare request ID that ties all logs from a single invocation together. Link to this property service: optional string Worker script name that produced this event. Link to this property spanId: optional string Span ID for this individual unit of work within a trace. Link to this property spanName: optional string Human-readable name for this span. Link to this property stackId: optional string Stack / deployment identifier. Link to this property startTime: optional number Span start time as a Unix epoch in milliseconds. minimum0 Link to this property startTimeNs: optional string Span start time as a Unix epoch in nanoseconds. Link to this property statusCode: optional number HTTP response status code returned by the Worker. exclusiveMinimum minimum0 Link to this property timestampNs: optional string Event time as a Unix epoch in nanoseconds. Link to this property traceDuration: optional number Total duration of the entire trace in milliseconds. exclusiveMinimum minimum0 Link to this property traceId: optional string Distributed trace ID linking spans across services. Link to this property transactionName: optional string Logical transaction name for this request. Link to this property trigger: optional string What triggered the invocation (e.g. GET /users, POST /orders, queue message). Link to this property type: optional string Event type classifier (e.g. cf-worker-event, cf-worker-log). Link to this property url: optional string Request URL that triggered the Worker invocation. Link to this property
Link to this property dataset: string The dataset this event belongs to (e.g. cloudflare-workers). Link to this property
source: stringor map\[unknown] Raw log payload. May be a string or a structured object depending on how the log was emitted. One of the following: string Link to this property map\[unknown] Link to this property
Link to this property timestamp: number Event timestamp as a Unix epoch in milliseconds. minimum0 Link to this property "$containers": optional map\[unknown] Cloudflare Containers event information that enriches your logs for identifying and debugging issues. Link to this property
"$workers": optional object {eventType, scriptName, durableObjectId, 10 more } or object {cpuTimeMs, eventType, outcome, 14 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues. One of the following:
object {eventType, scriptName, durableObjectId, 10 more }
eventType: "fetch"or "scheduled"or "alarm"or 9 more One of the following: "fetch" Link to this property "scheduled" Link to this property "alarm" Link to this property "cron" Link to this property "queue" Link to this property "email" Link to this property "tail" Link to this property "rpc" Link to this property "jsrpc" Link to this property "websocket" Link to this property "workflow" Link to this property "unknown" Link to this property
Link to this property scriptName: string Link to this property durableObjectId: optional string Link to this property entrypoint: optional string Link to this property event: optional map\[unknown] Link to this property
executionModel: optional "durableObject"or "stateless" One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property outcome: optional string Link to this property
preview: optional object {id, name, slug } id: optional string Link to this property name: optional string Link to this property slug: optional string Link to this property
Link to this property requestId: optional string Link to this property
scriptVersion: optional object {id, message, tag } id: optional string Link to this property message: optional string Link to this property tag: optional string Link to this property
Link to this property spanId: optional string Link to this property traceId: optional string Link to this property truncated: optional boolean Link to this property
Link to this property
object {cpuTimeMs, eventType, outcome, 14 more } cpuTimeMs: number Link to this property
eventType: "fetch"or "scheduled"or "alarm"or 9 more One of the following: "fetch" Link to this property "scheduled" Link to this property "alarm" Link to this property "cron" Link to this property "queue" Link to this property "email" Link to this property "tail" Link to this property "rpc" Link to this property "jsrpc" Link to this property "websocket" Link to this property "workflow" Link to this property "unknown" Link to this property
Link to this property outcome: string Link to this property scriptName: string Link to this property wallTimeMs: number Link to this property
diagnosticsChannelEvents: optional array of object {channel, message, timestamp } channel: string Link to this property message: string Link to this property timestamp: number Link to this property
Link to this property dispatchNamespace: optional string Link to this property durableObjectId: optional string Link to this property entrypoint: optional string Link to this property event: optional map\[unknown] Link to this property
executionModel: optional "durableObject"or "stateless" One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property
preview: optional object {id, name, slug } id: optional string Link to this property name: optional string Link to this property slug: optional string Link to this property
Link to this property requestId: optional string Link to this property
scriptVersion: optional object {id, message, tag } id: optional string Link to this property message: optional string Link to this property tag: optional string Link to this property
Link to this property spanId: optional string Link to this property traceId: optional string Link to this property truncated: optional boolean Link to this property
Link to this property
Link to this property
Link to this property
fields: optional array of object {key, type } List of fields discovered in the matched events. Useful for building dynamic UIs. key: string Field name present in the matched events. Link to this property type: string Data type of the field (string, number, or boolean). Link to this property
Link to this property
series: optional array of object {data, time } Time-series data for the matched events, bucketed by the query granularity.
data: array of object {aggregates, count, interval, 3 more }
aggregates: object {\_count, \_interval, \_firstSeen, 2 more } Deprecated\_count: number exclusiveMinimum minimum0 Link to this property Deprecated\_interval: number exclusiveMinimum minimum0 Link to this property Deprecated\_firstSeen: optional string Link to this property Deprecated\_lastSeen: optional string Link to this property Deprecatedbin: optional unknown Link to this property
Link to this property count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property errors: optional number Link to this property
groups: optional map\[stringor numberor boolean] Groups in the query results. One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property time: string Link to this property
Link to this property
Link to this property
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.
"$metadata": object {id, account, cloudService, 32 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation. id: string Unique event ID. Use as the cursor value for offset-based pagination. Link to this property account: optional string Cloudflare account identifier. Link to this property cloudService: optional string Cloudflare product that generated this event (e.g. workers, pages). Link to this property coldStart: optional number exclusiveMinimum minimum0 Link to this property cost: optional number Estimated cost units for this invocation. exclusiveMinimum minimum0 Link to this property duration: optional number Span duration in milliseconds. exclusiveMinimum minimum0 Link to this property endTime: optional number Span end time as a Unix epoch in milliseconds. minimum0 Link to this property endTimeNs: optional string Span end time as a Unix epoch in nanoseconds. Link to this property error: optional string Error message, present when the log represents an error. Link to this property errorTemplate: optional string Templatized version of the error message used for grouping similar errors. Link to this property fingerprint: optional string Content-based fingerprint used to group similar events. Link to this property level: optional string Log level (e.g. log, debug, info, warn, error). Link to this property message: optional string Log message text. Link to this property messageTemplate: optional string Templatized version of the log message used for grouping similar messages. Link to this property metricName: optional string Metric name when the event represents a metric data point. Link to this property origin: optional string Origin of the event (e.g. fetch, scheduled, queue). Link to this property parentSpanId: optional string Span ID of the parent span in the trace hierarchy. Link to this property provider: optional string Infrastructure provider identifier. Link to this property rayId: optional string Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation. Link to this property region: optional string Cloudflare data center / region that handled the request. Link to this property requestId: optional string Cloudflare request ID that ties all logs from a single invocation together. Link to this property service: optional string Worker script name that produced this event. Link to this property spanId: optional string Span ID for this individual unit of work within a trace. Link to this property spanName: optional string Human-readable name for this span. Link to this property stackId: optional string Stack / deployment identifier. Link to this property startTime: optional number Span start time as a Unix epoch in milliseconds. minimum0 Link to this property startTimeNs: optional string Span start time as a Unix epoch in nanoseconds. Link to this property statusCode: optional number HTTP response status code returned by the Worker. exclusiveMinimum minimum0 Link to this property timestampNs: optional string Event time as a Unix epoch in nanoseconds. Link to this property traceDuration: optional number Total duration of the entire trace in milliseconds. exclusiveMinimum minimum0 Link to this property traceId: optional string Distributed trace ID linking spans across services. Link to this property transactionName: optional string Logical transaction name for this request. Link to this property trigger: optional string What triggered the invocation (e.g. GET /users, POST /orders, queue message). Link to this property type: optional string Event type classifier (e.g. cf-worker-event, cf-worker-log). Link to this property url: optional string Request URL that triggered the Worker invocation. Link to this property
Link to this property dataset: string The dataset this event belongs to (e.g. cloudflare-workers). Link to this property
source: stringor map\[unknown] Raw log payload. May be a string or a structured object depending on how the log was emitted. One of the following: string Link to this property map\[unknown] Link to this property
Link to this property timestamp: number Event timestamp as a Unix epoch in milliseconds. minimum0 Link to this property "$containers": optional map\[unknown] Cloudflare Containers event information that enriches your logs for identifying and debugging issues. Link to this property
"$workers": optional object {eventType, scriptName, durableObjectId, 10 more } or object {cpuTimeMs, eventType, outcome, 14 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues. One of the following:
object {eventType, scriptName, durableObjectId, 10 more }
eventType: "fetch"or "scheduled"or "alarm"or 9 more One of the following: "fetch" Link to this property "scheduled" Link to this property "alarm" Link to this property "cron" Link to this property "queue" Link to this property "email" Link to this property "tail" Link to this property "rpc" Link to this property "jsrpc" Link to this property "websocket" Link to this property "workflow" Link to this property "unknown" Link to this property
Link to this property scriptName: string Link to this property durableObjectId: optional string Link to this property entrypoint: optional string Link to this property event: optional map\[unknown] Link to this property
executionModel: optional "durableObject"or "stateless" One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property outcome: optional string Link to this property
preview: optional object {id, name, slug } id: optional string Link to this property name: optional string Link to this property slug: optional string Link to this property
Link to this property requestId: optional string Link to this property
scriptVersion: optional object {id, message, tag } id: optional string Link to this property message: optional string Link to this property tag: optional string Link to this property
Link to this property spanId: optional string Link to this property traceId: optional string Link to this property truncated: optional boolean Link to this property
Link to this property
object {cpuTimeMs, eventType, outcome, 14 more } cpuTimeMs: number Link to this property
eventType: "fetch"or "scheduled"or "alarm"or 9 more One of the following: "fetch" Link to this property "scheduled" Link to this property "alarm" Link to this property "cron" Link to this property "queue" Link to this property "email" Link to this property "tail" Link to this property "rpc" Link to this property "jsrpc" Link to this property "websocket" Link to this property "workflow" Link to this property "unknown" Link to this property
Link to this property outcome: string Link to this property scriptName: string Link to this property wallTimeMs: number Link to this property
diagnosticsChannelEvents: optional array of object {channel, message, timestamp } channel: string Link to this property message: string Link to this property timestamp: number Link to this property
Link to this property dispatchNamespace: optional string Link to this property durableObjectId: optional string Link to this property entrypoint: optional string Link to this property event: optional map\[unknown] Link to this property
executionModel: optional "durableObject"or "stateless" One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property
preview: optional object {id, name, slug } id: optional string Link to this property name: optional string Link to this property slug: optional string Link to this property
Link to this property requestId: optional string Link to this property
scriptVersion: optional object {id, message, tag } id: optional string Link to this property message: optional string Link to this property tag: optional string Link to this property
Link to this property spanId: optional string Link to this property traceId: optional string Link to this property truncated: optional boolean Link to this property
Link to this property
Link to this property
Link to this property
traces: optional array of object {rootSpanName, rootTransactionName, service, 6 more } Trace summaries matching the query. Present when the query view is ‘traces’. Each entry represents a distributed trace with its spans, duration, and services involved. rootSpanName: string Name of the root span that initiated the trace. Link to this property rootTransactionName: string Logical transaction name for the root span. Link to this property service: array of string List of Worker services involved in the trace. Link to this property spans: number Total number of spans in the trace. Link to this property traceDurationMs: number Total duration of the trace in milliseconds. Link to this property traceEndMs: number Trace end time as a Unix epoch in milliseconds. Link to this property traceId: string Unique identifier for the distributed trace. Link to this property traceStartMs: number Trace start time as a Unix epoch in milliseconds. Link to this property errors: optional array of string Error messages encountered during the trace, if any. Link to this property
Link to this property
[Link to this property](<#(resource)%20workers.observability.telemetry%20%3E%20(model)%20telemetry_query_response%20%3E%20(schema)>)
TelemetryValuesResponse object {dataset, key, type, value } dataset: string Link to this property key: string Link to this property
type: "string"or "boolean"or "number" One of the following: "string" Link to this property "boolean" Link to this property "number" Link to this property
Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
[Link to this property](<#(resource)%20workers.observability.telemetry%20%3E%20(model)%20telemetry_values_response%20%3E%20(schema)>)
TelemetryLiveTailResponse object {wsUrl } wsUrl: string WebSocket URL clients connect to in order to stream live tail events. formaturi Link to this property
[Link to this property](<#(resource)%20workers.observability.telemetry%20%3E%20(model)%20telemetry_live_tail_response%20%3E%20(schema)>) TelemetryLiveTailHeartbeatResponse = unknown [Link to this property](<#(resource)%20workers.observability.telemetry%20%3E%20(model)%20telemetry_live_tail_heartbeat_response%20%3E%20(schema)>) #### ObservabilityDestinations ##### [Get Destinations](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/destinations/methods/list) GET/accounts/{account\_id}/workers/observability/destinations ##### [Create Destination](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/destinations/methods/create) POST/accounts/{account\_id}/workers/observability/destinations ##### [Update Destination](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/destinations/methods/update) PATCH/accounts/{account\_id}/workers/observability/destinations/{slug} ##### [Delete Destination](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/destinations/methods/delete) DELETE/accounts/{account\_id}/workers/observability/destinations/{slug} ##### ModelsExpand Collapse
DestinationListResponse object {configuration, enabled, name, 2 more }
configuration: object {destination\_conf, headers, jobStatus, 3 more } destination\_conf: string Link to this property headers: map\[string] Link to this property
jobStatus: object {error\_message, last\_complete, last\_error } error\_message: string Link to this property last\_complete: string Link to this property last\_error: string Link to this property
Link to this property
logpushDataset: "opentelemetry-traces"or "opentelemetry-logs"or "opentelemetry-metrics" One of the following: "opentelemetry-traces" Link to this property "opentelemetry-logs" Link to this property "opentelemetry-metrics" Link to this property
Link to this property type: "logpush" Link to this property url: string Link to this property
Link to this property enabled: boolean Link to this property name: string Link to this property scripts: array of string Link to this property slug: string Link to this property
[Link to this property](<#(resource)%20workers.observability.destinations%20%3E%20(model)%20destination_list_response%20%3E%20(schema)>)
DestinationCreateResponse object {configuration, enabled, name, 2 more }
configuration: object {destination\_conf, logpushDataset, logpushJob, 2 more } destination\_conf: string Link to this property
logpushDataset: "opentelemetry-traces"or "opentelemetry-logs"or "opentelemetry-metrics" One of the following: "opentelemetry-traces" Link to this property "opentelemetry-logs" Link to this property "opentelemetry-metrics" Link to this property
Link to this property logpushJob: number Link to this property type: "logpush" Link to this property url: string Link to this property
Link to this property enabled: boolean Link to this property name: string Link to this property scripts: array of string Link to this property slug: string Link to this property
[Link to this property](<#(resource)%20workers.observability.destinations%20%3E%20(model)%20destination_create_response%20%3E%20(schema)>)
DestinationUpdateResponse object {configuration, enabled, name, 2 more }
configuration: object {destination\_conf, logpushDataset, logpushJob, 2 more } destination\_conf: string Link to this property
logpushDataset: "opentelemetry-traces"or "opentelemetry-logs"or "opentelemetry-metrics" One of the following: "opentelemetry-traces" Link to this property "opentelemetry-logs" Link to this property "opentelemetry-metrics" Link to this property
Link to this property logpushJob: number Link to this property type: "logpush" Link to this property url: string Link to this property
Link to this property enabled: boolean Link to this property name: string Link to this property scripts: array of string Link to this property slug: string Link to this property
[Link to this property](<#(resource)%20workers.observability.destinations%20%3E%20(model)%20destination_update_response%20%3E%20(schema)>)
DestinationDeleteResponse object {configuration, enabled, name, 2 more }
configuration: object {destination\_conf, logpushDataset, logpushJob, 2 more } destination\_conf: string Link to this property
logpushDataset: "opentelemetry-traces"or "opentelemetry-logs"or "opentelemetry-metrics" One of the following: "opentelemetry-traces" Link to this property "opentelemetry-logs" Link to this property "opentelemetry-metrics" Link to this property
Link to this property logpushJob: number Link to this property type: "logpush" Link to this property url: string Link to this property
Link to this property enabled: boolean Link to this property name: string Link to this property scripts: array of string Link to this property slug: string Link to this property
[Link to this property](<#(resource)%20workers.observability.destinations%20%3E%20(model)%20destination_delete_response%20%3E%20(schema)>) #### ObservabilityQueries ##### [Save query](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/queries/methods/create) POST/accounts/{account\_id}/workers/observability/queries ##### [List queries](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/queries/methods/list) GET/accounts/{account\_id}/workers/observability/queries ##### ModelsExpand Collapse
QueryCreateResponse object {id, adhoc, created, 6 more } id: string Link to this property adhoc: boolean If the query wasn’t explcitly saved Link to this property created: string formatdate-time Link to this property createdBy: string Link to this property description: string maxLength1000 Link to this property name: string Query name maxLength250 minLength1 Link to this property
parameters: object {calculations, datasets, filterCombination, 6 more }
calculations: optional array of object {operator, alias, key, keyType } or object {key, operator, alias, keyType } Create Calculations to compute as part of the query. One of the following:
object {operator, alias, key, keyType }
operator: "count"or "COUNT" One of the following: "count" Link to this property "COUNT" Link to this property
Link to this property alias: optional string Link to this property key: optional string Link to this property
keyType: optional "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property
Link to this property
object {key, operator, alias, keyType } key: string Link to this property
operator: "uniq"or "max"or "min"or 33 more One of the following: "uniq" Link to this property "max" Link to this property "min" Link to this property "sum" Link to this property "avg" Link to this property "median" Link to this property "p001" Link to this property "p01" Link to this property "p05" Link to this property "p10" Link to this property "p25" Link to this property "p75" Link to this property "p90" Link to this property "p95" Link to this property "p99" Link to this property "p999" Link to this property "stddev" Link to this property "variance" Link to this property "COUNT\_DISTINCT" Link to this property "MAX" Link to this property "MIN" Link to this property "SUM" Link to this property "AVG" Link to this property "MEDIAN" Link to this property "P001" Link to this property "P01" Link to this property "P05" Link to this property "P10" Link to this property "P25" Link to this property "P75" Link to this property "P90" Link to this property "P95" Link to this property "P99" Link to this property "P999" Link to this property "STDDEV" Link to this property "VARIANCE" Link to this property
Link to this property alias: optional string Link to this property
keyType: optional "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property
Link to this property
Link to this property datasets: optional array of string Set the Datasets to query. Leave it empty to query all the datasets. Link to this property
filterCombination: optional "and"or "or"or "AND"or "OR" Set a Flag to describe how to combine the filters on the query. One of the following: "and" Link to this property "or" Link to this property "AND" Link to this property "OR" Link to this property
Link to this property
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’. One of the following:
object {filterCombination, filters, kind }
filterCombination: "and"or "or"or "AND"or "OR" One of the following: "and" Link to this property "or" Link to this property "AND" Link to this property "OR" Link to this property
Link to this property filters: array of unknown Link to this property kind: "group" Link to this property
Link to this property
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. key: string 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. Link to this property
operation: "includes"or "not\_includes"or "starts\_with"or 27 more Comparison operator. String operators: includes, not\_includes, starts\_with, ends\_with, regex. Existence: exists, is\_null. Set membership: in, not\_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte. One of the following: "includes" Link to this property "not\_includes" Link to this property "starts\_with" Link to this property "ends\_with" Link to this property "regex" Link to this property "exists" Link to this property "is\_null" Link to this property "in" Link to this property "not\_in" Link to this property "eq" Link to this property "neq" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property "=" Link to this property "!=" Link to this property ">" Link to this property ">=" Link to this property "<" Link to this property "<=" Link to this property "INCLUDES" Link to this property "DOES\_NOT\_INCLUDE" Link to this property "MATCH\_REGEX" Link to this property "EXISTS" Link to this property "DOES\_NOT\_EXIST" Link to this property "IN" Link to this property "NOT\_IN" Link to this property "STARTS\_WITH" Link to this property "ENDS\_WITH" Link to this property
Link to this property
type: "string"or "number"or "boolean" Data type of the filter field. Must match the actual type of the key being filtered. One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property kind: optional "filter" Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
value: optional stringor numberor boolean Comparison value. Must match actual values in your data — verify with the values endpoint. Ensure the value type (string/number/boolean) matches the field type. String comparisons are case-sensitive. Regex uses RE2 syntax (no lookaheads/lookbehinds). One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property
Link to this property
groupBys: optional array of object {type, value } Define how to group the results of the query.
type: "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property value: string Link to this property
Link to this property
havings: optional array of object {key, operation, value } Configure the Having clauses that filter on calculations in the query result. key: string Link to this property
operation: "eq"or "neq"or "gt"or 3 more One of the following: "eq" Link to this property "neq" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property
Link to this property value: number Link to this property
Link to this property limit: optional number Set a limit on the number of results / records returned by the query maximum100 minimum0 Link to this property
needle: optional object {value, isRegex, matchCase } Define an expression to search using full-text search.
value: stringor numberor boolean maxLength1000 One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property isRegex: optional boolean Link to this property matchCase: optional boolean Link to this property
Link to this property
orderBy: optional object {value, order } Configure the order of the results returned by the query. value: string Configure which Calculation to order the results by. Link to this property
order: optional "asc"or "desc" Set the order of the results One of the following: "asc" Link to this property "desc" Link to this property
Link to this property
Link to this property
Link to this property updated: string formatdate-time Link to this property updatedBy: string Link to this property
[Link to this property](<#(resource)%20workers.observability.queries%20%3E%20(model)%20query_create_response%20%3E%20(schema)>)
QueryListResponse object {id, adhoc, created, 6 more } id: string Link to this property adhoc: boolean If the query wasn’t explcitly saved Link to this property created: string formatdate-time Link to this property createdBy: string Link to this property description: string maxLength1000 Link to this property name: string Query name maxLength250 minLength1 Link to this property
parameters: object {calculations, datasets, filterCombination, 6 more }
calculations: optional array of object {operator, alias, key, keyType } or object {key, operator, alias, keyType } Create Calculations to compute as part of the query. One of the following:
object {operator, alias, key, keyType }
operator: "count"or "COUNT" One of the following: "count" Link to this property "COUNT" Link to this property
Link to this property alias: optional string Link to this property key: optional string Link to this property
keyType: optional "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property
Link to this property
object {key, operator, alias, keyType } key: string Link to this property
operator: "uniq"or "max"or "min"or 33 more One of the following: "uniq" Link to this property "max" Link to this property "min" Link to this property "sum" Link to this property "avg" Link to this property "median" Link to this property "p001" Link to this property "p01" Link to this property "p05" Link to this property "p10" Link to this property "p25" Link to this property "p75" Link to this property "p90" Link to this property "p95" Link to this property "p99" Link to this property "p999" Link to this property "stddev" Link to this property "variance" Link to this property "COUNT\_DISTINCT" Link to this property "MAX" Link to this property "MIN" Link to this property "SUM" Link to this property "AVG" Link to this property "MEDIAN" Link to this property "P001" Link to this property "P01" Link to this property "P05" Link to this property "P10" Link to this property "P25" Link to this property "P75" Link to this property "P90" Link to this property "P95" Link to this property "P99" Link to this property "P999" Link to this property "STDDEV" Link to this property "VARIANCE" Link to this property
Link to this property alias: optional string Link to this property
keyType: optional "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property
Link to this property
Link to this property datasets: optional array of string Set the Datasets to query. Leave it empty to query all the datasets. Link to this property
filterCombination: optional "and"or "or"or "AND"or "OR" Set a Flag to describe how to combine the filters on the query. One of the following: "and" Link to this property "or" Link to this property "AND" Link to this property "OR" Link to this property
Link to this property
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’. One of the following:
object {filterCombination, filters, kind }
filterCombination: "and"or "or"or "AND"or "OR" One of the following: "and" Link to this property "or" Link to this property "AND" Link to this property "OR" Link to this property
Link to this property filters: array of unknown Link to this property kind: "group" Link to this property
Link to this property
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. key: string 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. Link to this property
operation: "includes"or "not\_includes"or "starts\_with"or 27 more Comparison operator. String operators: includes, not\_includes, starts\_with, ends\_with, regex. Existence: exists, is\_null. Set membership: in, not\_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte. One of the following: "includes" Link to this property "not\_includes" Link to this property "starts\_with" Link to this property "ends\_with" Link to this property "regex" Link to this property "exists" Link to this property "is\_null" Link to this property "in" Link to this property "not\_in" Link to this property "eq" Link to this property "neq" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property "=" Link to this property "!=" Link to this property ">" Link to this property ">=" Link to this property "<" Link to this property "<=" Link to this property "INCLUDES" Link to this property "DOES\_NOT\_INCLUDE" Link to this property "MATCH\_REGEX" Link to this property "EXISTS" Link to this property "DOES\_NOT\_EXIST" Link to this property "IN" Link to this property "NOT\_IN" Link to this property "STARTS\_WITH" Link to this property "ENDS\_WITH" Link to this property
Link to this property
type: "string"or "number"or "boolean" Data type of the filter field. Must match the actual type of the key being filtered. One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property kind: optional "filter" Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
value: optional stringor numberor boolean Comparison value. Must match actual values in your data — verify with the values endpoint. Ensure the value type (string/number/boolean) matches the field type. String comparisons are case-sensitive. Regex uses RE2 syntax (no lookaheads/lookbehinds). One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property
Link to this property
groupBys: optional array of object {type, value } Define how to group the results of the query.
type: "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property value: string Link to this property
Link to this property
havings: optional array of object {key, operation, value } Configure the Having clauses that filter on calculations in the query result. key: string Link to this property
operation: "eq"or "neq"or "gt"or 3 more One of the following: "eq" Link to this property "neq" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property
Link to this property value: number Link to this property
Link to this property limit: optional number Set a limit on the number of results / records returned by the query maximum100 minimum0 Link to this property
needle: optional object {value, isRegex, matchCase } Define an expression to search using full-text search.
value: stringor numberor boolean maxLength1000 One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property isRegex: optional boolean Link to this property matchCase: optional boolean Link to this property
Link to this property
orderBy: optional object {value, order } Configure the order of the results returned by the query. value: string Configure which Calculation to order the results by. Link to this property
order: optional "asc"or "desc" Set the order of the results One of the following: "asc" Link to this property "desc" Link to this property
Link to this property
Link to this property
Link to this property updated: string formatdate-time Link to this property updatedBy: string Link to this property
[Link to this property](<#(resource)%20workers.observability.queries%20%3E%20(model)%20query_list_response%20%3E%20(schema)>) #### ObservabilityShared Queries ##### [Create a sharable link to a query result](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/shared_queries/methods/create) POST/accounts/{account\_id}/workers/observability/shared/query ##### [View a query that has been shared](https://developers.cloudflare.com/api/resources/workers/subresources/observability/subresources/shared_queries/methods/get) GET/accounts/{account\_id}/workers/observability/shared/query/{id} ##### ModelsExpand Collapse
SharedQueryCreateResponse object {id } id: string Specify the ID of the shared query. Link to this property
[Link to this property](<#(resource)%20workers.observability.shared_queries%20%3E%20(model)%20shared_query_create_response%20%3E%20(schema)>)
SharedQueryGetResponse object {run, statistics, agents, 6 more } 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 } Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics. id: string Unique identifier for this query run. Link to this property accountId: string Cloudflare account ID that owns this query run. Link to this property dry: boolean Whether this was a dry run (results not persisted). Link to this property granularity: number Number of time-series buckets used for the query. Higher values produce more detailed series data. Link to this property
query: object {id, adhoc, created, 6 more } A saved query definition with its parameters, metadata, and ownership information. id: string Link to this property adhoc: boolean If the query wasn’t explcitly saved Link to this property
created: stringor string formatdate-time One of the following: string Link to this property string Link to this property
Link to this property createdBy: string Link to this property description: string maxLength1000 Link to this property name: string Query name maxLength250 minLength1 Link to this property
parameters: object {calculations, datasets, filterCombination, 6 more }
calculations: optional array of object {operator, alias, key, keyType } or object {key, operator, alias, keyType } Create Calculations to compute as part of the query. One of the following:
object {operator, alias, key, keyType }
operator: "count"or "COUNT" One of the following: "count" Link to this property "COUNT" Link to this property
Link to this property alias: optional string Link to this property key: optional string Link to this property
keyType: optional "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property
Link to this property
object {key, operator, alias, keyType } key: string Link to this property
operator: "uniq"or "max"or "min"or 33 more One of the following: "uniq" Link to this property "max" Link to this property "min" Link to this property "sum" Link to this property "avg" Link to this property "median" Link to this property "p001" Link to this property "p01" Link to this property "p05" Link to this property "p10" Link to this property "p25" Link to this property "p75" Link to this property "p90" Link to this property "p95" Link to this property "p99" Link to this property "p999" Link to this property "stddev" Link to this property "variance" Link to this property "COUNT\_DISTINCT" Link to this property "MAX" Link to this property "MIN" Link to this property "SUM" Link to this property "AVG" Link to this property "MEDIAN" Link to this property "P001" Link to this property "P01" Link to this property "P05" Link to this property "P10" Link to this property "P25" Link to this property "P75" Link to this property "P90" Link to this property "P95" Link to this property "P99" Link to this property "P999" Link to this property "STDDEV" Link to this property "VARIANCE" Link to this property
Link to this property alias: optional string Link to this property
keyType: optional "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property
Link to this property
Link to this property datasets: optional array of string Set the Datasets to query. Leave it empty to query all the datasets. Link to this property
filterCombination: optional "and"or "or"or "AND"or "OR" Set a Flag to describe how to combine the filters on the query. One of the following: "and" Link to this property "or" Link to this property "AND" Link to this property "OR" Link to this property
Link to this property
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’. One of the following:
object {filterCombination, filters, kind }
filterCombination: "and"or "or"or "AND"or "OR" One of the following: "and" Link to this property "or" Link to this property "AND" Link to this property "OR" Link to this property
Link to this property filters: array of unknown Link to this property kind: "group" Link to this property
Link to this property
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. key: string 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. Link to this property
operation: "includes"or "not\_includes"or "starts\_with"or 27 more Comparison operator. String operators: includes, not\_includes, starts\_with, ends\_with, regex. Existence: exists, is\_null. Set membership: in, not\_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte. One of the following: "includes" Link to this property "not\_includes" Link to this property "starts\_with" Link to this property "ends\_with" Link to this property "regex" Link to this property "exists" Link to this property "is\_null" Link to this property "in" Link to this property "not\_in" Link to this property "eq" Link to this property "neq" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property "=" Link to this property "!=" Link to this property ">" Link to this property ">=" Link to this property "<" Link to this property "<=" Link to this property "INCLUDES" Link to this property "DOES\_NOT\_INCLUDE" Link to this property "MATCH\_REGEX" Link to this property "EXISTS" Link to this property "DOES\_NOT\_EXIST" Link to this property "IN" Link to this property "NOT\_IN" Link to this property "STARTS\_WITH" Link to this property "ENDS\_WITH" Link to this property
Link to this property
type: "string"or "number"or "boolean" Data type of the filter field. Must match the actual type of the key being filtered. One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property kind: optional "filter" Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
value: optional stringor numberor boolean Comparison value. Must match actual values in your data — verify with the values endpoint. Ensure the value type (string/number/boolean) matches the field type. String comparisons are case-sensitive. Regex uses RE2 syntax (no lookaheads/lookbehinds). One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property
Link to this property
groupBys: optional array of object {type, value } Define how to group the results of the query.
type: "string"or "number"or "boolean" One of the following: "string" Link to this property "number" Link to this property "boolean" Link to this property
Link to this property value: string Link to this property
Link to this property
havings: optional array of object {key, operation, value } Configure the Having clauses that filter on calculations in the query result. key: string Link to this property
operation: "eq"or "neq"or "gt"or 3 more One of the following: "eq" Link to this property "neq" Link to this property "gt" Link to this property "gte" Link to this property "lt" Link to this property "lte" Link to this property
Link to this property value: number Link to this property
Link to this property limit: optional number Set a limit on the number of results / records returned by the query maximum100 minimum0 Link to this property
needle: optional object {value, isRegex, matchCase } Define an expression to search using full-text search. value: Link to this property isRegex: optional boolean Link to this property matchCase: optional boolean Link to this property
Link to this property
orderBy: optional object {value, order } Configure the order of the results returned by the query. value: string Configure which Calculation to order the results by. Link to this property
order: optional "asc"or "desc" Set the order of the results One of the following: "asc" Link to this property "desc" Link to this property
Link to this property
Link to this property
Link to this property
updated: stringor string formatdate-time One of the following: string Link to this property string Link to this property
Link to this property updatedBy: string Link to this property
Link to this property
status: "STARTED"or "COMPLETED" Current execution status of the query run. One of the following: "STARTED" Link to this property "COMPLETED" Link to this property
Link to this property
timeframe: object {from, to } Time range for the query execution. ‘from’ must be earlier than ‘to’. No fractional milliseconds. from: number Start timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property to: number End timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property
Link to this property userId: string ID of the user who initiated the query run. Link to this property created: optional string ISO-8601 timestamp when the query run was created. Link to this property
statistics: optional object {bytes\_read, elapsed, rows\_read, abr\_level } Query performance statistics from the database (does not include network latency). bytes\_read: number Number of uncompressed bytes read from the table. Link to this property elapsed: number Time in seconds for the query to run. Link to this property rows\_read: number Number of rows scanned from the table. Link to this property abr\_level: optional number The level of Adaptive Bit Rate (ABR) sampling used for the query. If empty the ABR level is 1 Link to this property
Link to this property updated: optional string ISO-8601 timestamp when the query run was last updated. Link to this property
Link to this property
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. bytes\_read: number Number of uncompressed bytes read from the table. Link to this property elapsed: number Time in seconds for the query to run. Link to this property rows\_read: number Number of rows scanned from the table. Link to this property abr\_level: optional number The level of Adaptive Bit Rate (ABR) sampling used for the query. If empty the ABR level is 1 Link to this property
Link to this property
agents: optional array of object {id, errors, models, 13 more } Agent run summaries. Present when the query view is ‘agents’. Each entry represents one trace containing at least one agent invocation. id: string Stable pagination cursor for this agent run. Link to this property errors: array of string Distinct errors reported by spans in the run. Link to this property models: array of string Distinct models reported by chat spans across the run’s trace. Link to this property providers: array of string Distinct GenAI providers reported by chat spans in the run. Link to this property services: array of string Worker services represented in the run’s trace. Link to this property spans: number Number of spans in the run’s trace. Link to this property
status: "completed"or "error" Observed run status. One of the following: "completed" Link to this property "error" Link to this property
Link to this property traceDurationMs: number Total trace duration in milliseconds. Link to this property traceEndMs: number End of the run’s trace as a Unix epoch in milliseconds. Link to this property traceId: string Trace identifier for this agent run. Link to this property traceStartMs: number Start of the run’s trace as a Unix epoch in milliseconds. Link to this property agentId: optional string ID from the earliest agent invocation that provides one. Link to this property agentName: optional string Name from the earliest agent invocation that provides one. Link to this property conversationId: optional string Conversation ID from the earliest invocation that provides one. Link to this property inputTokens: optional number Input tokens summed across chat spans in the run’s trace; informational, not billing data. Link to this property outputTokens: optional number Output tokens summed across chat spans in the run’s trace; informational, not billing data. Link to this property
Link to this property
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.
aggregates: array of object {count, interval, sampleInterval, 2 more } count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property value: number Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property
groups: optional array of object {key, value } key: string Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property
Link to this property calculation: string Link to this property
series: array of object {data, time }
data: array of object {count, interval, sampleInterval, 4 more } count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property value: number Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property firstSeen: optional string Link to this property
groups: optional array of object {key, value } key: string Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property lastSeen: optional string Link to this property
Link to this property time: string Link to this property
Link to this property alias: optional string Link to this property
Link to this property
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.
aggregates: array of object {count, interval, sampleInterval, 2 more } count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property value: number Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property
groups: optional array of object {key, value } key: string Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property
Link to this property calculation: string Link to this property
series: array of object {data, time }
data: array of object {count, interval, sampleInterval, 4 more } count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property value: number Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property firstSeen: optional string Link to this property
groups: optional array of object {key, value } key: string Link to this property
value: stringor numberor boolean One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property lastSeen: optional string Link to this property
Link to this property time: string Link to this property
Link to this property alias: optional string Link to this property
Link to this property
distribution: optional object {bins, bucketBoundaries, bucketMode, 2 more } Bucketed 2D histogram of a numeric field over time. Present when chartType is ‘distribution’. bins: array of string Time-bucket labels (ISO-8601 strings), one per matrix column. Link to this property bucketBoundaries: array of number Raw bucket edges in the value’s native unit, length buckets.length + 1. Used for the colour scale and percentile mapping. Link to this property
bucketMode: "log"or "linear" Bucketing scheme used to derive the boundaries. ‘log’ produces geometric edges; ‘linear’ produces fixed-width edges. One of the following: "log" Link to this property "linear" Link to this property
Link to this property buckets: array of string Value-range labels, one per matrix row (e.g. ‘50–100ms’). Link to this property matrix: array of array of number Sampling-corrected counts. matrix\[bucketIdx]\[binIdx] is the estimated number of events in value-bucket ‘bucketIdx’ during time-bin ‘binIdx’. Link to this property
Link to this property
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. count: optional number Total number of events matching the query (may exceed the number returned due to limits). Link to this property
events: optional array of object {"$metadata", dataset, source, 3 more } List of individual telemetry events matching the query.
"$metadata": object {id, account, cloudService, 32 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation. id: string Unique event ID. Use as the cursor value for offset-based pagination. Link to this property account: optional string Cloudflare account identifier. Link to this property cloudService: optional string Cloudflare product that generated this event (e.g. workers, pages). Link to this property coldStart: optional number exclusiveMinimum minimum0 Link to this property cost: optional number Estimated cost units for this invocation. exclusiveMinimum minimum0 Link to this property duration: optional number Span duration in milliseconds. exclusiveMinimum minimum0 Link to this property endTime: optional number Span end time as a Unix epoch in milliseconds. minimum0 Link to this property endTimeNs: optional string Span end time as a Unix epoch in nanoseconds. Link to this property error: optional string Error message, present when the log represents an error. Link to this property errorTemplate: optional string Templatized version of the error message used for grouping similar errors. Link to this property fingerprint: optional string Content-based fingerprint used to group similar events. Link to this property level: optional string Log level (e.g. log, debug, info, warn, error). Link to this property message: optional string Log message text. Link to this property messageTemplate: optional string Templatized version of the log message used for grouping similar messages. Link to this property metricName: optional string Metric name when the event represents a metric data point. Link to this property origin: optional string Origin of the event (e.g. fetch, scheduled, queue). Link to this property parentSpanId: optional string Span ID of the parent span in the trace hierarchy. Link to this property provider: optional string Infrastructure provider identifier. Link to this property rayId: optional string Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation. Link to this property region: optional string Cloudflare data center / region that handled the request. Link to this property requestId: optional string Cloudflare request ID that ties all logs from a single invocation together. Link to this property service: optional string Worker script name that produced this event. Link to this property spanId: optional string Span ID for this individual unit of work within a trace. Link to this property spanName: optional string Human-readable name for this span. Link to this property stackId: optional string Stack / deployment identifier. Link to this property startTime: optional number Span start time as a Unix epoch in milliseconds. minimum0 Link to this property startTimeNs: optional string Span start time as a Unix epoch in nanoseconds. Link to this property statusCode: optional number HTTP response status code returned by the Worker. exclusiveMinimum minimum0 Link to this property timestampNs: optional string Event time as a Unix epoch in nanoseconds. Link to this property traceDuration: optional number Total duration of the entire trace in milliseconds. exclusiveMinimum minimum0 Link to this property traceId: optional string Distributed trace ID linking spans across services. Link to this property transactionName: optional string Logical transaction name for this request. Link to this property trigger: optional string What triggered the invocation (e.g. GET /users, POST /orders, queue message). Link to this property type: optional string Event type classifier (e.g. cf-worker-event, cf-worker-log). Link to this property url: optional string Request URL that triggered the Worker invocation. Link to this property
Link to this property dataset: string The dataset this event belongs to (e.g. cloudflare-workers). Link to this property
source: stringor map\[unknown] Raw log payload. May be a string or a structured object depending on how the log was emitted. One of the following: string Link to this property map\[unknown] Link to this property
Link to this property timestamp: number Event timestamp as a Unix epoch in milliseconds. minimum0 Link to this property "$containers": optional map\[unknown] Cloudflare Containers event information that enriches your logs for identifying and debugging issues. Link to this property
"$workers": optional object {eventType, scriptName, durableObjectId, 10 more } or object {cpuTimeMs, eventType, outcome, 14 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues. One of the following:
object {eventType, scriptName, durableObjectId, 10 more }
eventType: "fetch"or "scheduled"or "alarm"or 9 more One of the following: "fetch" Link to this property "scheduled" Link to this property "alarm" Link to this property "cron" Link to this property "queue" Link to this property "email" Link to this property "tail" Link to this property "rpc" Link to this property "jsrpc" Link to this property "websocket" Link to this property "workflow" Link to this property "unknown" Link to this property
Link to this property scriptName: string Link to this property durableObjectId: optional string Link to this property entrypoint: optional string Link to this property event: optional map\[unknown] Link to this property
executionModel: optional "durableObject"or "stateless" One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property outcome: optional string Link to this property
preview: optional object {id, name, slug } id: optional string Link to this property name: optional string Link to this property slug: optional string Link to this property
Link to this property requestId: optional string Link to this property
scriptVersion: optional object {id, message, tag } id: optional string Link to this property message: optional string Link to this property tag: optional string Link to this property
Link to this property spanId: optional string Link to this property traceId: optional string Link to this property truncated: optional boolean Link to this property
Link to this property
object {cpuTimeMs, eventType, outcome, 14 more } cpuTimeMs: number Link to this property
eventType: "fetch"or "scheduled"or "alarm"or 9 more One of the following: "fetch" Link to this property "scheduled" Link to this property "alarm" Link to this property "cron" Link to this property "queue" Link to this property "email" Link to this property "tail" Link to this property "rpc" Link to this property "jsrpc" Link to this property "websocket" Link to this property "workflow" Link to this property "unknown" Link to this property
Link to this property outcome: string Link to this property scriptName: string Link to this property wallTimeMs: number Link to this property
diagnosticsChannelEvents: optional array of object {channel, message, timestamp } channel: string Link to this property message: string Link to this property timestamp: number Link to this property
Link to this property dispatchNamespace: optional string Link to this property durableObjectId: optional string Link to this property entrypoint: optional string Link to this property event: optional map\[unknown] Link to this property
executionModel: optional "durableObject"or "stateless" One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property
preview: optional object {id, name, slug } id: optional string Link to this property name: optional string Link to this property slug: optional string Link to this property
Link to this property requestId: optional string Link to this property
scriptVersion: optional object {id, message, tag } id: optional string Link to this property message: optional string Link to this property tag: optional string Link to this property
Link to this property spanId: optional string Link to this property traceId: optional string Link to this property truncated: optional boolean Link to this property
Link to this property
Link to this property
Link to this property
fields: optional array of object {key, type } List of fields discovered in the matched events. Useful for building dynamic UIs. key: string Field name present in the matched events. Link to this property type: string Data type of the field (string, number, or boolean). Link to this property
Link to this property
series: optional array of object {data, time } Time-series data for the matched events, bucketed by the query granularity.
data: array of object {aggregates, count, interval, 3 more }
aggregates: object {\_count, \_interval, \_firstSeen, 2 more } Deprecated\_count: number exclusiveMinimum minimum0 Link to this property Deprecated\_interval: number exclusiveMinimum minimum0 Link to this property Deprecated\_firstSeen: optional string Link to this property Deprecated\_lastSeen: optional string Link to this property Deprecatedbin: optional unknown Link to this property
Link to this property count: number Estimated number of matching events: the sum of the sample intervals of the stored events. It equals the number of stored events when sampleInterval is 1. Link to this property Deprecatedinterval: number Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sampleInterval: number Average sample interval of the matched events. Each stored event has a sample interval of 1 / (the sampling rate applied when it was ingested): the Worker’s head\_sampling\_rate multiplied by any platform sampling applied to the account or script. A value of 1 means none of the matched events were sampled. A value above 1 means count and value are estimated from sampled data, not exact. This is independent of statistics.abr\_level. Link to this property errors: optional number Link to this property
groups: optional map\[stringor numberor boolean] Groups in the query results. One of the following: string Link to this property number Link to this property boolean Link to this property
Link to this property
Link to this property time: string Link to this property
Link to this property
Link to this property
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.
"$metadata": object {id, account, cloudService, 32 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation. id: string Unique event ID. Use as the cursor value for offset-based pagination. Link to this property account: optional string Cloudflare account identifier. Link to this property cloudService: optional string Cloudflare product that generated this event (e.g. workers, pages). Link to this property coldStart: optional number exclusiveMinimum minimum0 Link to this property cost: optional number Estimated cost units for this invocation. exclusiveMinimum minimum0 Link to this property duration: optional number Span duration in milliseconds. exclusiveMinimum minimum0 Link to this property endTime: optional number Span end time as a Unix epoch in milliseconds. minimum0 Link to this property endTimeNs: optional string Span end time as a Unix epoch in nanoseconds. Link to this property error: optional string Error message, present when the log represents an error. Link to this property errorTemplate: optional string Templatized version of the error message used for grouping similar errors. Link to this property fingerprint: optional string Content-based fingerprint used to group similar events. Link to this property level: optional string Log level (e.g. log, debug, info, warn, error). Link to this property message: optional string Log message text. Link to this property messageTemplate: optional string Templatized version of the log message used for grouping similar messages. Link to this property metricName: optional string Metric name when the event represents a metric data point. Link to this property origin: optional string Origin of the event (e.g. fetch, scheduled, queue). Link to this property parentSpanId: optional string Span ID of the parent span in the trace hierarchy. Link to this property provider: optional string Infrastructure provider identifier. Link to this property rayId: optional string Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation. Link to this property region: optional string Cloudflare data center / region that handled the request. Link to this property requestId: optional string Cloudflare request ID that ties all logs from a single invocation together. Link to this property service: optional string Worker script name that produced this event. Link to this property spanId: optional string Span ID for this individual unit of work within a trace. Link to this property spanName: optional string Human-readable name for this span. Link to this property stackId: optional string Stack / deployment identifier. Link to this property startTime: optional number Span start time as a Unix epoch in milliseconds. minimum0 Link to this property startTimeNs: optional string Span start time as a Unix epoch in nanoseconds. Link to this property statusCode: optional number HTTP response status code returned by the Worker. exclusiveMinimum minimum0 Link to this property timestampNs: optional string Event time as a Unix epoch in nanoseconds. Link to this property traceDuration: optional number Total duration of the entire trace in milliseconds. exclusiveMinimum minimum0 Link to this property traceId: optional string Distributed trace ID linking spans across services. Link to this property transactionName: optional string Logical transaction name for this request. Link to this property trigger: optional string What triggered the invocation (e.g. GET /users, POST /orders, queue message). Link to this property type: optional string Event type classifier (e.g. cf-worker-event, cf-worker-log). Link to this property url: optional string Request URL that triggered the Worker invocation. Link to this property
Link to this property dataset: string The dataset this event belongs to (e.g. cloudflare-workers). Link to this property
source: stringor map\[unknown] Raw log payload. May be a string or a structured object depending on how the log was emitted. One of the following: string Link to this property map\[unknown] Link to this property
Link to this property timestamp: number Event timestamp as a Unix epoch in milliseconds. minimum0 Link to this property "$containers": optional map\[unknown] Cloudflare Containers event information that enriches your logs for identifying and debugging issues. Link to this property
"$workers": optional object {eventType, scriptName, durableObjectId, 10 more } or object {cpuTimeMs, eventType, outcome, 14 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues. One of the following:
object {eventType, scriptName, durableObjectId, 10 more }
eventType: "fetch"or "scheduled"or "alarm"or 9 more One of the following: "fetch" Link to this property "scheduled" Link to this property "alarm" Link to this property "cron" Link to this property "queue" Link to this property "email" Link to this property "tail" Link to this property "rpc" Link to this property "jsrpc" Link to this property "websocket" Link to this property "workflow" Link to this property "unknown" Link to this property
Link to this property scriptName: string Link to this property durableObjectId: optional string Link to this property entrypoint: optional string Link to this property event: optional map\[unknown] Link to this property
executionModel: optional "durableObject"or "stateless" One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property outcome: optional string Link to this property
preview: optional object {id, name, slug } id: optional string Link to this property name: optional string Link to this property slug: optional string Link to this property
Link to this property requestId: optional string Link to this property
scriptVersion: optional object {id, message, tag } id: optional string Link to this property message: optional string Link to this property tag: optional string Link to this property
Link to this property spanId: optional string Link to this property traceId: optional string Link to this property truncated: optional boolean Link to this property
Link to this property
object {cpuTimeMs, eventType, outcome, 14 more } cpuTimeMs: number Link to this property
eventType: "fetch"or "scheduled"or "alarm"or 9 more One of the following: "fetch" Link to this property "scheduled" Link to this property "alarm" Link to this property "cron" Link to this property "queue" Link to this property "email" Link to this property "tail" Link to this property "rpc" Link to this property "jsrpc" Link to this property "websocket" Link to this property "workflow" Link to this property "unknown" Link to this property
Link to this property outcome: string Link to this property scriptName: string Link to this property wallTimeMs: number Link to this property
diagnosticsChannelEvents: optional array of object {channel, message, timestamp } channel: string Link to this property message: string Link to this property timestamp: number Link to this property
Link to this property dispatchNamespace: optional string Link to this property durableObjectId: optional string Link to this property entrypoint: optional string Link to this property event: optional map\[unknown] Link to this property
executionModel: optional "durableObject"or "stateless" One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property
preview: optional object {id, name, slug } id: optional string Link to this property name: optional string Link to this property slug: optional string Link to this property
Link to this property requestId: optional string Link to this property
scriptVersion: optional object {id, message, tag } id: optional string Link to this property message: optional string Link to this property tag: optional string Link to this property
Link to this property spanId: optional string Link to this property traceId: optional string Link to this property truncated: optional boolean Link to this property
Link to this property
Link to this property
Link to this property
traces: optional array of object {rootSpanName, rootTransactionName, service, 6 more } Trace summaries matching the query. Present when the query view is ‘traces’. Each entry represents a distributed trace with its spans, duration, and services involved. rootSpanName: string Name of the root span that initiated the trace. Link to this property rootTransactionName: string Logical transaction name for the root span. Link to this property service: array of string List of Worker services involved in the trace. Link to this property spans: number Total number of spans in the trace. Link to this property traceDurationMs: number Total duration of the trace in milliseconds. Link to this property traceEndMs: number Trace end time as a Unix epoch in milliseconds. Link to this property traceId: string Unique identifier for the distributed trace. Link to this property traceStartMs: number Trace start time as a Unix epoch in milliseconds. Link to this property errors: optional array of string Error messages encountered during the trace, if any. Link to this property
Link to this property
[Link to this property](<#(resource)%20workers.observability.shared_queries%20%3E%20(model)%20shared_query_get_response%20%3E%20(schema)>)