--- title: Observability --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Workers](https://developers.cloudflare.com/api/python/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/python/resources/workers/subresources/observability/subresources/telemetry/methods/keys) workers.observability.telemetry.keys(TelemetryKeysParams\*\*kwargs) -> SyncSinglePage\[[TelemetryKeysResponse]()] POST/accounts/{account\_id}/workers/observability/telemetry/keys ##### [Run a query](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/telemetry/methods/query) workers.observability.telemetry.query(TelemetryQueryParams\*\*kwargs) -> [TelemetryQueryResponse]() POST/accounts/{account\_id}/workers/observability/telemetry/query ##### [List values](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/telemetry/methods/values) workers.observability.telemetry.values(TelemetryValuesParams\*\*kwargs) -> SyncSinglePage\[[TelemetryValuesResponse]()] POST/accounts/{account\_id}/workers/observability/telemetry/values ##### [Prepare live tail](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/telemetry/methods/live_tail) workers.observability.telemetry.live\_tail(TelemetryLiveTailParams\*\*kwargs) -> [TelemetryLiveTailResponse]() POST/accounts/{account\_id}/workers/observability/telemetry/live-tail ##### [Live tail heartbeat](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/telemetry/methods/live_tail_heartbeat) workers.observability.telemetry.live\_tail\_heartbeat(TelemetryLiveTailHeartbeatParams\*\*kwargs) -> object POST/accounts/{account\_id}/workers/observability/telemetry/live-tail/heartbeat ##### ModelsExpand Collapse
class TelemetryKeysResponse: … key: str Link to this property last\_seen\_at: float Link to this property
type: Literal\["string", "boolean", "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)>)
class TelemetryQueryResponse: … Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).
run: Run Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics. id: str Unique identifier for this query run. Link to this property account\_id: str Cloudflare account ID that owns this query run. Link to this property dry: bool Whether this was a dry run (results not persisted). Link to this property granularity: float Number of time-series buckets used for the query. Higher values produce more detailed series data. Link to this property
query: RunQuery A saved query definition with its parameters, metadata, and ownership information. id: str Link to this property adhoc: bool If the query wasn’t explcitly saved Link to this property
created: Union\[str, datetime] formatdate-time One of the following: str Link to this property datetime Link to this property
Link to this property created\_by: str Link to this property description: Optional\[str] maxLength1000 Link to this property name: str Query name maxLength250 minLength1 Link to this property
parameters: RunQueryParameters
calculations: Optional\[List\[RunQueryParametersCalculation]] Create Calculations to compute as part of the query. One of the following:
class RunQueryParametersCalculationUnionMember0: …
operator: Literal\["count", "COUNT"] One of the following: "count" Link to this property "COUNT" Link to this property
Link to this property alias: Optional\[str] Link to this property key: Optional\[str] Link to this property
key\_type: Optional\[Literal\["string", "number", "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
class RunQueryParametersCalculationUnionMember1: … key: str Link to this property
operator: Literal\["uniq", "max", "min", 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\[str] Link to this property
key\_type: Optional\[Literal\["string", "number", "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\[List\[str]] Set the Datasets to query. Leave it empty to query all the datasets. Link to this property
filter\_combination: Optional\[Literal\["and", "or", "AND", "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\[List\[RunQueryParametersFilter]] Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’. One of the following:
class RunQueryParametersFilterUnionMember0: …
filter\_combination: Literal\["and", "or", "AND", "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: List\[object] Link to this property kind: Literal\["group"] Link to this property
Link to this property
class RunQueryParametersFilterWorkersObservabilityFilterLeaf: … A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters. key: str 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: Literal\["includes", "not\_includes", "starts\_with", 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: Literal\["string", "number", "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\[Literal\["filter"]] Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
value: Optional\[Union\[str, float, bool, null]] 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: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property
Link to this property
group\_bys: Optional\[List\[RunQueryParametersGroupBy]] Define how to group the results of the query.
type: Literal\["string", "number", "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: str Link to this property
Link to this property
havings: Optional\[List\[RunQueryParametersHaving]] Configure the Having clauses that filter on calculations in the query result. key: str Link to this property
operation: Literal\["eq", "neq", "gt", 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: float Link to this property
Link to this property limit: Optional\[int] Set a limit on the number of results / records returned by the query maximum100 minimum0 Link to this property
needle: Optional\[RunQueryParametersNeedle] Define an expression to search using full-text search. value: RunQueryParametersNeedleValue Link to this property is\_regex: Optional\[bool] Link to this property match\_case: Optional\[bool] Link to this property
Link to this property
order\_by: Optional\[RunQueryParametersOrderBy] Configure the order of the results returned by the query. value: str Configure which Calculation to order the results by. Link to this property
order: Optional\[Literal\["asc", "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: Union\[str, datetime] formatdate-time One of the following: str Link to this property datetime Link to this property
Link to this property updated\_by: str Link to this property
Link to this property
status: Literal\["STARTED", "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: RunTimeframe Time range for the query execution. ‘from’ must be earlier than ‘to’. No fractional milliseconds. from\_: int Start timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property to: int End timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property
Link to this property user\_id: str ID of the user who initiated the query run. Link to this property created: Optional\[str] ISO-8601 timestamp when the query run was created. Link to this property
statistics: Optional\[RunStatistics] Query performance statistics from the database (does not include network latency). bytes\_read: float Number of uncompressed bytes read from the table. Link to this property elapsed: float Time in seconds for the query to run. Link to this property rows\_read: float Number of rows scanned from the table. Link to this property abr\_level: Optional\[float] 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\[str] ISO-8601 timestamp when the query run was last updated. Link to this property
Link to this property
statistics: Statistics Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency. bytes\_read: float Number of uncompressed bytes read from the table. Link to this property elapsed: float Time in seconds for the query to run. Link to this property rows\_read: float Number of rows scanned from the table. Link to this property abr\_level: Optional\[float] 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\[List\[Agent]] Agent run summaries. Present when the query view is ‘agents’. Each entry represents one trace containing at least one agent invocation. id: str Stable pagination cursor for this agent run. Link to this property errors: List\[str] Distinct errors reported by spans in the run. Link to this property models: List\[str] Distinct models reported by chat spans across the run’s trace. Link to this property providers: List\[str] Distinct GenAI providers reported by chat spans in the run. Link to this property services: List\[str] Worker services represented in the run’s trace. Link to this property spans: float Number of spans in the run’s trace. Link to this property
status: Literal\["completed", "error"] Observed run status. One of the following: "completed" Link to this property "error" Link to this property
Link to this property trace\_duration\_ms: float Total trace duration in milliseconds. Link to this property trace\_end\_ms: float End of the run’s trace as a Unix epoch in milliseconds. Link to this property trace\_id: str Trace identifier for this agent run. Link to this property trace\_start\_ms: float Start of the run’s trace as a Unix epoch in milliseconds. Link to this property agent\_id: Optional\[str] ID from the earliest agent invocation that provides one. Link to this property agent\_name: Optional\[str] Name from the earliest agent invocation that provides one. Link to this property conversation\_id: Optional\[str] Conversation ID from the earliest invocation that provides one. Link to this property input\_tokens: Optional\[float] Input tokens summed across chat spans in the run’s trace; informational, not billing data. Link to this property output\_tokens: Optional\[float] 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\[List\[Calculation]] 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: List\[CalculationAggregate] count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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: float Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property
groups: Optional\[List\[CalculationAggregateGroup]] key: str Link to this property
value: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property
Link to this property calculation: str Link to this property
series: List\[CalculationSeries]
data: List\[CalculationSeriesData] count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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: float Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property first\_seen: Optional\[str] Link to this property
groups: Optional\[List\[CalculationSeriesDataGroup]] key: str Link to this property
value: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property last\_seen: Optional\[str] Link to this property
Link to this property time: str Link to this property
Link to this property alias: Optional\[str] Link to this property
Link to this property
compare: Optional\[List\[Compare]] Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.
aggregates: List\[CompareAggregate] count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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: float Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property
groups: Optional\[List\[CompareAggregateGroup]] key: str Link to this property
value: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property
Link to this property calculation: str Link to this property
series: List\[CompareSeries]
data: List\[CompareSeriesData] count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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: float Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property first\_seen: Optional\[str] Link to this property
groups: Optional\[List\[CompareSeriesDataGroup]] key: str Link to this property
value: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property last\_seen: Optional\[str] Link to this property
Link to this property time: str Link to this property
Link to this property alias: Optional\[str] Link to this property
Link to this property
distribution: Optional\[Distribution] Bucketed 2D histogram of a numeric field over time. Present when chartType is ‘distribution’. bins: List\[str] Time-bucket labels (ISO-8601 strings), one per matrix column. Link to this property bucket\_boundaries: List\[float] 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
bucket\_mode: Literal\["log", "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: List\[str] Value-range labels, one per matrix row (e.g. ‘50–100ms’). Link to this property matrix: List\[List\[float]] 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\[Events] Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata. count: Optional\[float] Total number of events matching the query (may exceed the number returned due to limits). Link to this property
events: Optional\[List\[EventsEvent]] List of individual telemetry events matching the query.
metadata: EventsEventMetadata Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation. id: str Unique event ID. Use as the cursor value for offset-based pagination. Link to this property account: Optional\[str] Cloudflare account identifier. Link to this property cloud\_service: Optional\[str] Cloudflare product that generated this event (e.g. workers, pages). Link to this property cold\_start: Optional\[int] exclusiveMinimum minimum0 Link to this property cost: Optional\[int] Estimated cost units for this invocation. exclusiveMinimum minimum0 Link to this property duration: Optional\[int] Span duration in milliseconds. exclusiveMinimum minimum0 Link to this property end\_time: Optional\[int] Span end time as a Unix epoch in milliseconds. minimum0 Link to this property end\_time\_ns: Optional\[str] Span end time as a Unix epoch in nanoseconds. Link to this property error: Optional\[str] Error message, present when the log represents an error. Link to this property error\_template: Optional\[str] Templatized version of the error message used for grouping similar errors. Link to this property fingerprint: Optional\[str] Content-based fingerprint used to group similar events. Link to this property level: Optional\[str] Log level (e.g. log, debug, info, warn, error). Link to this property message: Optional\[str] Log message text. Link to this property message\_template: Optional\[str] Templatized version of the log message used for grouping similar messages. Link to this property metric\_name: Optional\[str] Metric name when the event represents a metric data point. Link to this property origin: Optional\[str] Origin of the event (e.g. fetch, scheduled, queue). Link to this property parent\_span\_id: Optional\[str] Span ID of the parent span in the trace hierarchy. Link to this property provider: Optional\[str] Infrastructure provider identifier. Link to this property rayid: Optional\[str] Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation. Link to this property region: Optional\[str] Cloudflare data center / region that handled the request. Link to this property request\_id: Optional\[str] Cloudflare request ID that ties all logs from a single invocation together. Link to this property service: Optional\[str] Worker script name that produced this event. Link to this property span\_id: Optional\[str] Span ID for this individual unit of work within a trace. Link to this property span\_name: Optional\[str] Human-readable name for this span. Link to this property stack\_id: Optional\[str] Stack / deployment identifier. Link to this property start\_time: Optional\[int] Span start time as a Unix epoch in milliseconds. minimum0 Link to this property start\_time\_ns: Optional\[str] Span start time as a Unix epoch in nanoseconds. Link to this property status\_code: Optional\[int] HTTP response status code returned by the Worker. exclusiveMinimum minimum0 Link to this property timestamp\_ns: Optional\[str] Event time as a Unix epoch in nanoseconds. Link to this property trace\_duration: Optional\[int] Total duration of the entire trace in milliseconds. exclusiveMinimum minimum0 Link to this property trace\_id: Optional\[str] Distributed trace ID linking spans across services. Link to this property transaction\_name: Optional\[str] Logical transaction name for this request. Link to this property trigger: Optional\[str] What triggered the invocation (e.g. GET /users, POST /orders, queue message). Link to this property type: Optional\[str] Event type classifier (e.g. cf-worker-event, cf-worker-log). Link to this property url: Optional\[str] Request URL that triggered the Worker invocation. Link to this property
Link to this property dataset: str The dataset this event belongs to (e.g. cloudflare-workers). Link to this property
source: Union\[str, Dict\[str, object]] Raw log payload. May be a string or a structured object depending on how the log was emitted. One of the following: str Link to this property Dict\[str, object] Link to this property
Link to this property timestamp: int Event timestamp as a Unix epoch in milliseconds. minimum0 Link to this property containers: Optional\[Dict\[str, object]] Cloudflare Containers event information that enriches your logs for identifying and debugging issues. Link to this property
workers: Optional\[EventsEventWorkers] Cloudflare Workers event information that enriches your logs for identifying and debugging issues. One of the following:
class EventsEventWorkersUnionMember0: …
event\_type: Literal\["fetch", "scheduled", "alarm", 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 script\_name: str Link to this property durable\_object\_id: Optional\[str] Link to this property entrypoint: Optional\[str] Link to this property event: Optional\[Dict\[str, object]] Link to this property
execution\_model: Optional\[Literal\["durableObject", "stateless"]] One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property outcome: Optional\[str] Link to this property
preview: Optional\[EventsEventWorkersUnionMember0Preview] id: Optional\[str] Link to this property name: Optional\[str] Link to this property slug: Optional\[str] Link to this property
Link to this property request\_id: Optional\[str] Link to this property
script\_version: Optional\[EventsEventWorkersUnionMember0ScriptVersion] id: Optional\[str] Link to this property message: Optional\[str] Link to this property tag: Optional\[str] Link to this property
Link to this property span\_id: Optional\[str] Link to this property trace\_id: Optional\[str] Link to this property truncated: Optional\[bool] Link to this property
Link to this property
class EventsEventWorkersUnionMember1: … cpu\_time\_ms: float Link to this property
event\_type: Literal\["fetch", "scheduled", "alarm", 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: str Link to this property script\_name: str Link to this property wall\_time\_ms: float Link to this property
diagnostics\_channel\_events: Optional\[List\[EventsEventWorkersUnionMember1DiagnosticsChannelEvent]] channel: str Link to this property message: str Link to this property timestamp: float Link to this property
Link to this property dispatch\_namespace: Optional\[str] Link to this property durable\_object\_id: Optional\[str] Link to this property entrypoint: Optional\[str] Link to this property event: Optional\[Dict\[str, object]] Link to this property
execution\_model: Optional\[Literal\["durableObject", "stateless"]] One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property
preview: Optional\[EventsEventWorkersUnionMember1Preview] id: Optional\[str] Link to this property name: Optional\[str] Link to this property slug: Optional\[str] Link to this property
Link to this property request\_id: Optional\[str] Link to this property
script\_version: Optional\[EventsEventWorkersUnionMember1ScriptVersion] id: Optional\[str] Link to this property message: Optional\[str] Link to this property tag: Optional\[str] Link to this property
Link to this property span\_id: Optional\[str] Link to this property trace\_id: Optional\[str] Link to this property truncated: Optional\[bool] Link to this property
Link to this property
Link to this property
Link to this property
fields: Optional\[List\[EventsField]] List of fields discovered in the matched events. Useful for building dynamic UIs. key: str Field name present in the matched events. Link to this property type: str Data type of the field (string, number, or boolean). Link to this property
Link to this property
series: Optional\[List\[EventsSeries]] Time-series data for the matched events, bucketed by the query granularity.
data: List\[EventsSeriesData]
aggregates: EventsSeriesDataAggregates Deprecated\_count: int exclusiveMinimum minimum0 Link to this property Deprecated\_interval: float exclusiveMinimum minimum0 Link to this property Deprecated\_first\_seen: Optional\[str] Link to this property Deprecated\_last\_seen: Optional\[str] Link to this property Deprecatedbin: Optional\[object] Link to this property
Link to this property count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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\[float] Link to this property
groups: Optional\[Dict\[str, Union\[str, float, bool]]] Groups in the query results. One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property time: str Link to this property
Link to this property
Link to this property
invocations: Optional\[Dict\[str, List\[Invocation]]] Events grouped by invocation (request ID). Present when the query view is ‘invocations’. Each key is a request ID mapping to all events from that invocation.
metadata: InvocationMetadata Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation. id: str Unique event ID. Use as the cursor value for offset-based pagination. Link to this property account: Optional\[str] Cloudflare account identifier. Link to this property cloud\_service: Optional\[str] Cloudflare product that generated this event (e.g. workers, pages). Link to this property cold\_start: Optional\[int] exclusiveMinimum minimum0 Link to this property cost: Optional\[int] Estimated cost units for this invocation. exclusiveMinimum minimum0 Link to this property duration: Optional\[int] Span duration in milliseconds. exclusiveMinimum minimum0 Link to this property end\_time: Optional\[int] Span end time as a Unix epoch in milliseconds. minimum0 Link to this property end\_time\_ns: Optional\[str] Span end time as a Unix epoch in nanoseconds. Link to this property error: Optional\[str] Error message, present when the log represents an error. Link to this property error\_template: Optional\[str] Templatized version of the error message used for grouping similar errors. Link to this property fingerprint: Optional\[str] Content-based fingerprint used to group similar events. Link to this property level: Optional\[str] Log level (e.g. log, debug, info, warn, error). Link to this property message: Optional\[str] Log message text. Link to this property message\_template: Optional\[str] Templatized version of the log message used for grouping similar messages. Link to this property metric\_name: Optional\[str] Metric name when the event represents a metric data point. Link to this property origin: Optional\[str] Origin of the event (e.g. fetch, scheduled, queue). Link to this property parent\_span\_id: Optional\[str] Span ID of the parent span in the trace hierarchy. Link to this property provider: Optional\[str] Infrastructure provider identifier. Link to this property rayid: Optional\[str] Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation. Link to this property region: Optional\[str] Cloudflare data center / region that handled the request. Link to this property request\_id: Optional\[str] Cloudflare request ID that ties all logs from a single invocation together. Link to this property service: Optional\[str] Worker script name that produced this event. Link to this property span\_id: Optional\[str] Span ID for this individual unit of work within a trace. Link to this property span\_name: Optional\[str] Human-readable name for this span. Link to this property stack\_id: Optional\[str] Stack / deployment identifier. Link to this property start\_time: Optional\[int] Span start time as a Unix epoch in milliseconds. minimum0 Link to this property start\_time\_ns: Optional\[str] Span start time as a Unix epoch in nanoseconds. Link to this property status\_code: Optional\[int] HTTP response status code returned by the Worker. exclusiveMinimum minimum0 Link to this property timestamp\_ns: Optional\[str] Event time as a Unix epoch in nanoseconds. Link to this property trace\_duration: Optional\[int] Total duration of the entire trace in milliseconds. exclusiveMinimum minimum0 Link to this property trace\_id: Optional\[str] Distributed trace ID linking spans across services. Link to this property transaction\_name: Optional\[str] Logical transaction name for this request. Link to this property trigger: Optional\[str] What triggered the invocation (e.g. GET /users, POST /orders, queue message). Link to this property type: Optional\[str] Event type classifier (e.g. cf-worker-event, cf-worker-log). Link to this property url: Optional\[str] Request URL that triggered the Worker invocation. Link to this property
Link to this property dataset: str The dataset this event belongs to (e.g. cloudflare-workers). Link to this property
source: Union\[str, Dict\[str, object]] Raw log payload. May be a string or a structured object depending on how the log was emitted. One of the following: str Link to this property Dict\[str, object] Link to this property
Link to this property timestamp: int Event timestamp as a Unix epoch in milliseconds. minimum0 Link to this property containers: Optional\[Dict\[str, object]] Cloudflare Containers event information that enriches your logs for identifying and debugging issues. Link to this property
workers: Optional\[InvocationWorkers] Cloudflare Workers event information that enriches your logs for identifying and debugging issues. One of the following:
class InvocationWorkersUnionMember0: …
event\_type: Literal\["fetch", "scheduled", "alarm", 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 script\_name: str Link to this property durable\_object\_id: Optional\[str] Link to this property entrypoint: Optional\[str] Link to this property event: Optional\[Dict\[str, object]] Link to this property
execution\_model: Optional\[Literal\["durableObject", "stateless"]] One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property outcome: Optional\[str] Link to this property
preview: Optional\[InvocationWorkersUnionMember0Preview] id: Optional\[str] Link to this property name: Optional\[str] Link to this property slug: Optional\[str] Link to this property
Link to this property request\_id: Optional\[str] Link to this property
script\_version: Optional\[InvocationWorkersUnionMember0ScriptVersion] id: Optional\[str] Link to this property message: Optional\[str] Link to this property tag: Optional\[str] Link to this property
Link to this property span\_id: Optional\[str] Link to this property trace\_id: Optional\[str] Link to this property truncated: Optional\[bool] Link to this property
Link to this property
class InvocationWorkersUnionMember1: … cpu\_time\_ms: float Link to this property
event\_type: Literal\["fetch", "scheduled", "alarm", 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: str Link to this property script\_name: str Link to this property wall\_time\_ms: float Link to this property
diagnostics\_channel\_events: Optional\[List\[InvocationWorkersUnionMember1DiagnosticsChannelEvent]] channel: str Link to this property message: str Link to this property timestamp: float Link to this property
Link to this property dispatch\_namespace: Optional\[str] Link to this property durable\_object\_id: Optional\[str] Link to this property entrypoint: Optional\[str] Link to this property event: Optional\[Dict\[str, object]] Link to this property
execution\_model: Optional\[Literal\["durableObject", "stateless"]] One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property
preview: Optional\[InvocationWorkersUnionMember1Preview] id: Optional\[str] Link to this property name: Optional\[str] Link to this property slug: Optional\[str] Link to this property
Link to this property request\_id: Optional\[str] Link to this property
script\_version: Optional\[InvocationWorkersUnionMember1ScriptVersion] id: Optional\[str] Link to this property message: Optional\[str] Link to this property tag: Optional\[str] Link to this property
Link to this property span\_id: Optional\[str] Link to this property trace\_id: Optional\[str] Link to this property truncated: Optional\[bool] Link to this property
Link to this property
Link to this property
Link to this property
traces: Optional\[List\[Trace]] 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. root\_span\_name: str Name of the root span that initiated the trace. Link to this property root\_transaction\_name: str Logical transaction name for the root span. Link to this property service: List\[str] List of Worker services involved in the trace. Link to this property spans: float Total number of spans in the trace. Link to this property trace\_duration\_ms: float Total duration of the trace in milliseconds. Link to this property trace\_end\_ms: float Trace end time as a Unix epoch in milliseconds. Link to this property trace\_id: str Unique identifier for the distributed trace. Link to this property trace\_start\_ms: float Trace start time as a Unix epoch in milliseconds. Link to this property errors: Optional\[List\[str]] 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)>)
class TelemetryValuesResponse: … dataset: str Link to this property key: str Link to this property
type: Literal\["string", "boolean", "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: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool 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)>)
class TelemetryLiveTailResponse: … ws\_url: str 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)>) #### ObservabilityDestinations ##### [Get Destinations](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/destinations/methods/list) workers.observability.destinations.list(DestinationListParams\*\*kwargs) -> SyncSinglePage\[[DestinationListResponse]()] GET/accounts/{account\_id}/workers/observability/destinations ##### [Create Destination](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/destinations/methods/create) workers.observability.destinations.create(DestinationCreateParams\*\*kwargs) -> [DestinationCreateResponse]() POST/accounts/{account\_id}/workers/observability/destinations ##### [Update Destination](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/destinations/methods/update) workers.observability.destinations.update(strslug, DestinationUpdateParams\*\*kwargs) -> [DestinationUpdateResponse]() PATCH/accounts/{account\_id}/workers/observability/destinations/{slug} ##### [Delete Destination](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/destinations/methods/delete) workers.observability.destinations.delete(strslug, DestinationDeleteParams\*\*kwargs) -> [DestinationDeleteResponse]() DELETE/accounts/{account\_id}/workers/observability/destinations/{slug} ##### ModelsExpand Collapse
class DestinationListResponse: …
configuration: Configuration destination\_conf: str Link to this property headers: Dict\[str, str] Link to this property
job\_status: ConfigurationJobStatus error\_message: str Link to this property last\_complete: str Link to this property last\_error: str Link to this property
Link to this property
logpush\_dataset: Literal\["opentelemetry-traces", "opentelemetry-logs", "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: Literal\["logpush"] Link to this property url: str Link to this property
Link to this property enabled: bool Link to this property name: str Link to this property scripts: List\[str] Link to this property slug: str Link to this property
[Link to this property](<#(resource)%20workers.observability.destinations%20%3E%20(model)%20destination_list_response%20%3E%20(schema)>)
class DestinationCreateResponse: …
configuration: Configuration destination\_conf: str Link to this property
logpush\_dataset: Literal\["opentelemetry-traces", "opentelemetry-logs", "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 logpush\_job: float Link to this property type: Literal\["logpush"] Link to this property url: str Link to this property
Link to this property enabled: bool Link to this property name: str Link to this property scripts: List\[str] Link to this property slug: str Link to this property
[Link to this property](<#(resource)%20workers.observability.destinations%20%3E%20(model)%20destination_create_response%20%3E%20(schema)>)
class DestinationUpdateResponse: …
configuration: Configuration destination\_conf: str Link to this property
logpush\_dataset: Literal\["opentelemetry-traces", "opentelemetry-logs", "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 logpush\_job: float Link to this property type: Literal\["logpush"] Link to this property url: str Link to this property
Link to this property enabled: bool Link to this property name: str Link to this property scripts: List\[str] Link to this property slug: str Link to this property
[Link to this property](<#(resource)%20workers.observability.destinations%20%3E%20(model)%20destination_update_response%20%3E%20(schema)>)
class DestinationDeleteResponse: …
configuration: Configuration destination\_conf: str Link to this property
logpush\_dataset: Literal\["opentelemetry-traces", "opentelemetry-logs", "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 logpush\_job: float Link to this property type: Literal\["logpush"] Link to this property url: str Link to this property
Link to this property enabled: bool Link to this property name: str Link to this property scripts: List\[str] Link to this property slug: str 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/python/resources/workers/subresources/observability/subresources/queries/methods/create) workers.observability.queries.create(QueryCreateParams\*\*kwargs) -> [QueryCreateResponse]() POST/accounts/{account\_id}/workers/observability/queries ##### [List queries](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/queries/methods/list) workers.observability.queries.list(QueryListParams\*\*kwargs) -> SyncSinglePage\[[QueryListResponse]()] GET/accounts/{account\_id}/workers/observability/queries ##### ModelsExpand Collapse
class QueryCreateResponse: … id: str Link to this property adhoc: bool If the query wasn’t explcitly saved Link to this property created: datetime formatdate-time Link to this property created\_by: str Link to this property description: Optional\[str] maxLength1000 Link to this property name: str Query name maxLength250 minLength1 Link to this property
parameters: Parameters
calculations: Optional\[List\[ParametersCalculation]] Create Calculations to compute as part of the query. One of the following:
class ParametersCalculationUnionMember0: …
operator: Literal\["count", "COUNT"] One of the following: "count" Link to this property "COUNT" Link to this property
Link to this property alias: Optional\[str] Link to this property key: Optional\[str] Link to this property
key\_type: Optional\[Literal\["string", "number", "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
class ParametersCalculationUnionMember1: … key: str Link to this property
operator: Literal\["uniq", "max", "min", 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\[str] Link to this property
key\_type: Optional\[Literal\["string", "number", "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\[List\[str]] Set the Datasets to query. Leave it empty to query all the datasets. Link to this property
filter\_combination: Optional\[Literal\["and", "or", "AND", "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\[List\[ParametersFilter]] Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’. One of the following:
class ParametersFilterUnionMember0: …
filter\_combination: Literal\["and", "or", "AND", "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: List\[object] Link to this property kind: Literal\["group"] Link to this property
Link to this property
class ParametersFilterWorkersObservabilityFilterLeaf: … A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters. key: str 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: Literal\["includes", "not\_includes", "starts\_with", 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: Literal\["string", "number", "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\[Literal\["filter"]] Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
value: Optional\[Union\[str, float, bool, null]] 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: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property
Link to this property
group\_bys: Optional\[List\[ParametersGroupBy]] Define how to group the results of the query.
type: Literal\["string", "number", "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: str Link to this property
Link to this property
havings: Optional\[List\[ParametersHaving]] Configure the Having clauses that filter on calculations in the query result. key: str Link to this property
operation: Literal\["eq", "neq", "gt", 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: float Link to this property
Link to this property limit: Optional\[int] Set a limit on the number of results / records returned by the query maximum100 minimum0 Link to this property
needle: Optional\[ParametersNeedle] Define an expression to search using full-text search.
value: Union\[str, float, bool] maxLength1000 One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property is\_regex: Optional\[bool] Link to this property match\_case: Optional\[bool] Link to this property
Link to this property
order\_by: Optional\[ParametersOrderBy] Configure the order of the results returned by the query. value: str Configure which Calculation to order the results by. Link to this property
order: Optional\[Literal\["asc", "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: datetime formatdate-time Link to this property updated\_by: str Link to this property
[Link to this property](<#(resource)%20workers.observability.queries%20%3E%20(model)%20query_create_response%20%3E%20(schema)>)
class QueryListResponse: … id: str Link to this property adhoc: bool If the query wasn’t explcitly saved Link to this property created: datetime formatdate-time Link to this property created\_by: str Link to this property description: Optional\[str] maxLength1000 Link to this property name: str Query name maxLength250 minLength1 Link to this property
parameters: Parameters
calculations: Optional\[List\[ParametersCalculation]] Create Calculations to compute as part of the query. One of the following:
class ParametersCalculationUnionMember0: …
operator: Literal\["count", "COUNT"] One of the following: "count" Link to this property "COUNT" Link to this property
Link to this property alias: Optional\[str] Link to this property key: Optional\[str] Link to this property
key\_type: Optional\[Literal\["string", "number", "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
class ParametersCalculationUnionMember1: … key: str Link to this property
operator: Literal\["uniq", "max", "min", 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\[str] Link to this property
key\_type: Optional\[Literal\["string", "number", "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\[List\[str]] Set the Datasets to query. Leave it empty to query all the datasets. Link to this property
filter\_combination: Optional\[Literal\["and", "or", "AND", "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\[List\[ParametersFilter]] Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’. One of the following:
class ParametersFilterUnionMember0: …
filter\_combination: Literal\["and", "or", "AND", "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: List\[object] Link to this property kind: Literal\["group"] Link to this property
Link to this property
class ParametersFilterWorkersObservabilityFilterLeaf: … A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters. key: str 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: Literal\["includes", "not\_includes", "starts\_with", 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: Literal\["string", "number", "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\[Literal\["filter"]] Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
value: Optional\[Union\[str, float, bool, null]] 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: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property
Link to this property
group\_bys: Optional\[List\[ParametersGroupBy]] Define how to group the results of the query.
type: Literal\["string", "number", "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: str Link to this property
Link to this property
havings: Optional\[List\[ParametersHaving]] Configure the Having clauses that filter on calculations in the query result. key: str Link to this property
operation: Literal\["eq", "neq", "gt", 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: float Link to this property
Link to this property limit: Optional\[int] Set a limit on the number of results / records returned by the query maximum100 minimum0 Link to this property
needle: Optional\[ParametersNeedle] Define an expression to search using full-text search.
value: Union\[str, float, bool] maxLength1000 One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property is\_regex: Optional\[bool] Link to this property match\_case: Optional\[bool] Link to this property
Link to this property
order\_by: Optional\[ParametersOrderBy] Configure the order of the results returned by the query. value: str Configure which Calculation to order the results by. Link to this property
order: Optional\[Literal\["asc", "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: datetime formatdate-time Link to this property updated\_by: str 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/python/resources/workers/subresources/observability/subresources/shared_queries/methods/create) workers.observability.shared\_queries.create(SharedQueryCreateParams\*\*kwargs) -> [SharedQueryCreateResponse]() POST/accounts/{account\_id}/workers/observability/shared/query ##### [View a query that has been shared](https://developers.cloudflare.com/api/python/resources/workers/subresources/observability/subresources/shared_queries/methods/get) workers.observability.shared\_queries.get(strid, SharedQueryGetParams\*\*kwargs) -> [SharedQueryGetResponse]() GET/accounts/{account\_id}/workers/observability/shared/query/{id} ##### ModelsExpand Collapse
class SharedQueryCreateResponse: … id: str 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)>)
class SharedQueryGetResponse: … Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).
run: Run Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics. id: str Unique identifier for this query run. Link to this property account\_id: str Cloudflare account ID that owns this query run. Link to this property dry: bool Whether this was a dry run (results not persisted). Link to this property granularity: float Number of time-series buckets used for the query. Higher values produce more detailed series data. Link to this property
query: RunQuery A saved query definition with its parameters, metadata, and ownership information. id: str Link to this property adhoc: bool If the query wasn’t explcitly saved Link to this property
created: Union\[str, datetime] formatdate-time One of the following: str Link to this property datetime Link to this property
Link to this property created\_by: str Link to this property description: Optional\[str] maxLength1000 Link to this property name: str Query name maxLength250 minLength1 Link to this property
parameters: RunQueryParameters
calculations: Optional\[List\[RunQueryParametersCalculation]] Create Calculations to compute as part of the query. One of the following:
class RunQueryParametersCalculationUnionMember0: …
operator: Literal\["count", "COUNT"] One of the following: "count" Link to this property "COUNT" Link to this property
Link to this property alias: Optional\[str] Link to this property key: Optional\[str] Link to this property
key\_type: Optional\[Literal\["string", "number", "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
class RunQueryParametersCalculationUnionMember1: … key: str Link to this property
operator: Literal\["uniq", "max", "min", 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\[str] Link to this property
key\_type: Optional\[Literal\["string", "number", "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\[List\[str]] Set the Datasets to query. Leave it empty to query all the datasets. Link to this property
filter\_combination: Optional\[Literal\["and", "or", "AND", "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\[List\[RunQueryParametersFilter]] Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’. One of the following:
class RunQueryParametersFilterUnionMember0: …
filter\_combination: Literal\["and", "or", "AND", "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: List\[object] Link to this property kind: Literal\["group"] Link to this property
Link to this property
class RunQueryParametersFilterWorkersObservabilityFilterLeaf: … A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters. key: str 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: Literal\["includes", "not\_includes", "starts\_with", 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: Literal\["string", "number", "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\[Literal\["filter"]] Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
value: Optional\[Union\[str, float, bool, null]] 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: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property
Link to this property
group\_bys: Optional\[List\[RunQueryParametersGroupBy]] Define how to group the results of the query.
type: Literal\["string", "number", "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: str Link to this property
Link to this property
havings: Optional\[List\[RunQueryParametersHaving]] Configure the Having clauses that filter on calculations in the query result. key: str Link to this property
operation: Literal\["eq", "neq", "gt", 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: float Link to this property
Link to this property limit: Optional\[int] Set a limit on the number of results / records returned by the query maximum100 minimum0 Link to this property
needle: Optional\[RunQueryParametersNeedle] Define an expression to search using full-text search. value: RunQueryParametersNeedleValue Link to this property is\_regex: Optional\[bool] Link to this property match\_case: Optional\[bool] Link to this property
Link to this property
order\_by: Optional\[RunQueryParametersOrderBy] Configure the order of the results returned by the query. value: str Configure which Calculation to order the results by. Link to this property
order: Optional\[Literal\["asc", "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: Union\[str, datetime] formatdate-time One of the following: str Link to this property datetime Link to this property
Link to this property updated\_by: str Link to this property
Link to this property
status: Literal\["STARTED", "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: RunTimeframe Time range for the query execution. ‘from’ must be earlier than ‘to’. No fractional milliseconds. from\_: int Start timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property to: int End timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property
Link to this property user\_id: str ID of the user who initiated the query run. Link to this property created: Optional\[str] ISO-8601 timestamp when the query run was created. Link to this property
statistics: Optional\[RunStatistics] Query performance statistics from the database (does not include network latency). bytes\_read: float Number of uncompressed bytes read from the table. Link to this property elapsed: float Time in seconds for the query to run. Link to this property rows\_read: float Number of rows scanned from the table. Link to this property abr\_level: Optional\[float] 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\[str] ISO-8601 timestamp when the query run was last updated. Link to this property
Link to this property
statistics: Statistics Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency. bytes\_read: float Number of uncompressed bytes read from the table. Link to this property elapsed: float Time in seconds for the query to run. Link to this property rows\_read: float Number of rows scanned from the table. Link to this property abr\_level: Optional\[float] 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\[List\[Agent]] Agent run summaries. Present when the query view is ‘agents’. Each entry represents one trace containing at least one agent invocation. id: str Stable pagination cursor for this agent run. Link to this property errors: List\[str] Distinct errors reported by spans in the run. Link to this property models: List\[str] Distinct models reported by chat spans across the run’s trace. Link to this property providers: List\[str] Distinct GenAI providers reported by chat spans in the run. Link to this property services: List\[str] Worker services represented in the run’s trace. Link to this property spans: float Number of spans in the run’s trace. Link to this property
status: Literal\["completed", "error"] Observed run status. One of the following: "completed" Link to this property "error" Link to this property
Link to this property trace\_duration\_ms: float Total trace duration in milliseconds. Link to this property trace\_end\_ms: float End of the run’s trace as a Unix epoch in milliseconds. Link to this property trace\_id: str Trace identifier for this agent run. Link to this property trace\_start\_ms: float Start of the run’s trace as a Unix epoch in milliseconds. Link to this property agent\_id: Optional\[str] ID from the earliest agent invocation that provides one. Link to this property agent\_name: Optional\[str] Name from the earliest agent invocation that provides one. Link to this property conversation\_id: Optional\[str] Conversation ID from the earliest invocation that provides one. Link to this property input\_tokens: Optional\[float] Input tokens summed across chat spans in the run’s trace; informational, not billing data. Link to this property output\_tokens: Optional\[float] 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\[List\[Calculation]] 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: List\[CalculationAggregate] count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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: float Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property
groups: Optional\[List\[CalculationAggregateGroup]] key: str Link to this property
value: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property
Link to this property calculation: str Link to this property
series: List\[CalculationSeries]
data: List\[CalculationSeriesData] count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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: float Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property first\_seen: Optional\[str] Link to this property
groups: Optional\[List\[CalculationSeriesDataGroup]] key: str Link to this property
value: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property last\_seen: Optional\[str] Link to this property
Link to this property time: str Link to this property
Link to this property alias: Optional\[str] Link to this property
Link to this property
compare: Optional\[List\[Compare]] Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.
aggregates: List\[CompareAggregate] count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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: float Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property
groups: Optional\[List\[CompareAggregateGroup]] key: str Link to this property
value: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property
Link to this property calculation: str Link to this property
series: List\[CompareSeries]
data: List\[CompareSeriesData] count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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: float Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval Link to this property first\_seen: Optional\[str] Link to this property
groups: Optional\[List\[CompareSeriesDataGroup]] key: str Link to this property
value: Union\[str, float, bool] One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property last\_seen: Optional\[str] Link to this property
Link to this property time: str Link to this property
Link to this property alias: Optional\[str] Link to this property
Link to this property
distribution: Optional\[Distribution] Bucketed 2D histogram of a numeric field over time. Present when chartType is ‘distribution’. bins: List\[str] Time-bucket labels (ISO-8601 strings), one per matrix column. Link to this property bucket\_boundaries: List\[float] 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
bucket\_mode: Literal\["log", "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: List\[str] Value-range labels, one per matrix row (e.g. ‘50–100ms’). Link to this property matrix: List\[List\[float]] 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\[Events] Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata. count: Optional\[float] Total number of events matching the query (may exceed the number returned due to limits). Link to this property
events: Optional\[List\[EventsEvent]] List of individual telemetry events matching the query.
metadata: EventsEventMetadata Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation. id: str Unique event ID. Use as the cursor value for offset-based pagination. Link to this property account: Optional\[str] Cloudflare account identifier. Link to this property cloud\_service: Optional\[str] Cloudflare product that generated this event (e.g. workers, pages). Link to this property cold\_start: Optional\[int] exclusiveMinimum minimum0 Link to this property cost: Optional\[int] Estimated cost units for this invocation. exclusiveMinimum minimum0 Link to this property duration: Optional\[int] Span duration in milliseconds. exclusiveMinimum minimum0 Link to this property end\_time: Optional\[int] Span end time as a Unix epoch in milliseconds. minimum0 Link to this property end\_time\_ns: Optional\[str] Span end time as a Unix epoch in nanoseconds. Link to this property error: Optional\[str] Error message, present when the log represents an error. Link to this property error\_template: Optional\[str] Templatized version of the error message used for grouping similar errors. Link to this property fingerprint: Optional\[str] Content-based fingerprint used to group similar events. Link to this property level: Optional\[str] Log level (e.g. log, debug, info, warn, error). Link to this property message: Optional\[str] Log message text. Link to this property message\_template: Optional\[str] Templatized version of the log message used for grouping similar messages. Link to this property metric\_name: Optional\[str] Metric name when the event represents a metric data point. Link to this property origin: Optional\[str] Origin of the event (e.g. fetch, scheduled, queue). Link to this property parent\_span\_id: Optional\[str] Span ID of the parent span in the trace hierarchy. Link to this property provider: Optional\[str] Infrastructure provider identifier. Link to this property rayid: Optional\[str] Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation. Link to this property region: Optional\[str] Cloudflare data center / region that handled the request. Link to this property request\_id: Optional\[str] Cloudflare request ID that ties all logs from a single invocation together. Link to this property service: Optional\[str] Worker script name that produced this event. Link to this property span\_id: Optional\[str] Span ID for this individual unit of work within a trace. Link to this property span\_name: Optional\[str] Human-readable name for this span. Link to this property stack\_id: Optional\[str] Stack / deployment identifier. Link to this property start\_time: Optional\[int] Span start time as a Unix epoch in milliseconds. minimum0 Link to this property start\_time\_ns: Optional\[str] Span start time as a Unix epoch in nanoseconds. Link to this property status\_code: Optional\[int] HTTP response status code returned by the Worker. exclusiveMinimum minimum0 Link to this property timestamp\_ns: Optional\[str] Event time as a Unix epoch in nanoseconds. Link to this property trace\_duration: Optional\[int] Total duration of the entire trace in milliseconds. exclusiveMinimum minimum0 Link to this property trace\_id: Optional\[str] Distributed trace ID linking spans across services. Link to this property transaction\_name: Optional\[str] Logical transaction name for this request. Link to this property trigger: Optional\[str] What triggered the invocation (e.g. GET /users, POST /orders, queue message). Link to this property type: Optional\[str] Event type classifier (e.g. cf-worker-event, cf-worker-log). Link to this property url: Optional\[str] Request URL that triggered the Worker invocation. Link to this property
Link to this property dataset: str The dataset this event belongs to (e.g. cloudflare-workers). Link to this property
source: Union\[str, Dict\[str, object]] Raw log payload. May be a string or a structured object depending on how the log was emitted. One of the following: str Link to this property Dict\[str, object] Link to this property
Link to this property timestamp: int Event timestamp as a Unix epoch in milliseconds. minimum0 Link to this property containers: Optional\[Dict\[str, object]] Cloudflare Containers event information that enriches your logs for identifying and debugging issues. Link to this property
workers: Optional\[EventsEventWorkers] Cloudflare Workers event information that enriches your logs for identifying and debugging issues. One of the following:
class EventsEventWorkersUnionMember0: …
event\_type: Literal\["fetch", "scheduled", "alarm", 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 script\_name: str Link to this property durable\_object\_id: Optional\[str] Link to this property entrypoint: Optional\[str] Link to this property event: Optional\[Dict\[str, object]] Link to this property
execution\_model: Optional\[Literal\["durableObject", "stateless"]] One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property outcome: Optional\[str] Link to this property
preview: Optional\[EventsEventWorkersUnionMember0Preview] id: Optional\[str] Link to this property name: Optional\[str] Link to this property slug: Optional\[str] Link to this property
Link to this property request\_id: Optional\[str] Link to this property
script\_version: Optional\[EventsEventWorkersUnionMember0ScriptVersion] id: Optional\[str] Link to this property message: Optional\[str] Link to this property tag: Optional\[str] Link to this property
Link to this property span\_id: Optional\[str] Link to this property trace\_id: Optional\[str] Link to this property truncated: Optional\[bool] Link to this property
Link to this property
class EventsEventWorkersUnionMember1: … cpu\_time\_ms: float Link to this property
event\_type: Literal\["fetch", "scheduled", "alarm", 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: str Link to this property script\_name: str Link to this property wall\_time\_ms: float Link to this property
diagnostics\_channel\_events: Optional\[List\[EventsEventWorkersUnionMember1DiagnosticsChannelEvent]] channel: str Link to this property message: str Link to this property timestamp: float Link to this property
Link to this property dispatch\_namespace: Optional\[str] Link to this property durable\_object\_id: Optional\[str] Link to this property entrypoint: Optional\[str] Link to this property event: Optional\[Dict\[str, object]] Link to this property
execution\_model: Optional\[Literal\["durableObject", "stateless"]] One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property
preview: Optional\[EventsEventWorkersUnionMember1Preview] id: Optional\[str] Link to this property name: Optional\[str] Link to this property slug: Optional\[str] Link to this property
Link to this property request\_id: Optional\[str] Link to this property
script\_version: Optional\[EventsEventWorkersUnionMember1ScriptVersion] id: Optional\[str] Link to this property message: Optional\[str] Link to this property tag: Optional\[str] Link to this property
Link to this property span\_id: Optional\[str] Link to this property trace\_id: Optional\[str] Link to this property truncated: Optional\[bool] Link to this property
Link to this property
Link to this property
Link to this property
fields: Optional\[List\[EventsField]] List of fields discovered in the matched events. Useful for building dynamic UIs. key: str Field name present in the matched events. Link to this property type: str Data type of the field (string, number, or boolean). Link to this property
Link to this property
series: Optional\[List\[EventsSeries]] Time-series data for the matched events, bucketed by the query granularity.
data: List\[EventsSeriesData]
aggregates: EventsSeriesDataAggregates Deprecated\_count: int exclusiveMinimum minimum0 Link to this property Deprecated\_interval: float exclusiveMinimum minimum0 Link to this property Deprecated\_first\_seen: Optional\[str] Link to this property Deprecated\_last\_seen: Optional\[str] Link to this property Deprecatedbin: Optional\[object] Link to this property
Link to this property count: float 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: float Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead. Link to this property sample\_interval: float 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\[float] Link to this property
groups: Optional\[Dict\[str, Union\[str, float, bool]]] Groups in the query results. One of the following: str Link to this property float Link to this property bool Link to this property
Link to this property
Link to this property time: str Link to this property
Link to this property
Link to this property
invocations: Optional\[Dict\[str, List\[Invocation]]] Events grouped by invocation (request ID). Present when the query view is ‘invocations’. Each key is a request ID mapping to all events from that invocation.
metadata: InvocationMetadata Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation. id: str Unique event ID. Use as the cursor value for offset-based pagination. Link to this property account: Optional\[str] Cloudflare account identifier. Link to this property cloud\_service: Optional\[str] Cloudflare product that generated this event (e.g. workers, pages). Link to this property cold\_start: Optional\[int] exclusiveMinimum minimum0 Link to this property cost: Optional\[int] Estimated cost units for this invocation. exclusiveMinimum minimum0 Link to this property duration: Optional\[int] Span duration in milliseconds. exclusiveMinimum minimum0 Link to this property end\_time: Optional\[int] Span end time as a Unix epoch in milliseconds. minimum0 Link to this property end\_time\_ns: Optional\[str] Span end time as a Unix epoch in nanoseconds. Link to this property error: Optional\[str] Error message, present when the log represents an error. Link to this property error\_template: Optional\[str] Templatized version of the error message used for grouping similar errors. Link to this property fingerprint: Optional\[str] Content-based fingerprint used to group similar events. Link to this property level: Optional\[str] Log level (e.g. log, debug, info, warn, error). Link to this property message: Optional\[str] Log message text. Link to this property message\_template: Optional\[str] Templatized version of the log message used for grouping similar messages. Link to this property metric\_name: Optional\[str] Metric name when the event represents a metric data point. Link to this property origin: Optional\[str] Origin of the event (e.g. fetch, scheduled, queue). Link to this property parent\_span\_id: Optional\[str] Span ID of the parent span in the trace hierarchy. Link to this property provider: Optional\[str] Infrastructure provider identifier. Link to this property rayid: Optional\[str] Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation. Link to this property region: Optional\[str] Cloudflare data center / region that handled the request. Link to this property request\_id: Optional\[str] Cloudflare request ID that ties all logs from a single invocation together. Link to this property service: Optional\[str] Worker script name that produced this event. Link to this property span\_id: Optional\[str] Span ID for this individual unit of work within a trace. Link to this property span\_name: Optional\[str] Human-readable name for this span. Link to this property stack\_id: Optional\[str] Stack / deployment identifier. Link to this property start\_time: Optional\[int] Span start time as a Unix epoch in milliseconds. minimum0 Link to this property start\_time\_ns: Optional\[str] Span start time as a Unix epoch in nanoseconds. Link to this property status\_code: Optional\[int] HTTP response status code returned by the Worker. exclusiveMinimum minimum0 Link to this property timestamp\_ns: Optional\[str] Event time as a Unix epoch in nanoseconds. Link to this property trace\_duration: Optional\[int] Total duration of the entire trace in milliseconds. exclusiveMinimum minimum0 Link to this property trace\_id: Optional\[str] Distributed trace ID linking spans across services. Link to this property transaction\_name: Optional\[str] Logical transaction name for this request. Link to this property trigger: Optional\[str] What triggered the invocation (e.g. GET /users, POST /orders, queue message). Link to this property type: Optional\[str] Event type classifier (e.g. cf-worker-event, cf-worker-log). Link to this property url: Optional\[str] Request URL that triggered the Worker invocation. Link to this property
Link to this property dataset: str The dataset this event belongs to (e.g. cloudflare-workers). Link to this property
source: Union\[str, Dict\[str, object]] Raw log payload. May be a string or a structured object depending on how the log was emitted. One of the following: str Link to this property Dict\[str, object] Link to this property
Link to this property timestamp: int Event timestamp as a Unix epoch in milliseconds. minimum0 Link to this property containers: Optional\[Dict\[str, object]] Cloudflare Containers event information that enriches your logs for identifying and debugging issues. Link to this property
workers: Optional\[InvocationWorkers] Cloudflare Workers event information that enriches your logs for identifying and debugging issues. One of the following:
class InvocationWorkersUnionMember0: …
event\_type: Literal\["fetch", "scheduled", "alarm", 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 script\_name: str Link to this property durable\_object\_id: Optional\[str] Link to this property entrypoint: Optional\[str] Link to this property event: Optional\[Dict\[str, object]] Link to this property
execution\_model: Optional\[Literal\["durableObject", "stateless"]] One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property outcome: Optional\[str] Link to this property
preview: Optional\[InvocationWorkersUnionMember0Preview] id: Optional\[str] Link to this property name: Optional\[str] Link to this property slug: Optional\[str] Link to this property
Link to this property request\_id: Optional\[str] Link to this property
script\_version: Optional\[InvocationWorkersUnionMember0ScriptVersion] id: Optional\[str] Link to this property message: Optional\[str] Link to this property tag: Optional\[str] Link to this property
Link to this property span\_id: Optional\[str] Link to this property trace\_id: Optional\[str] Link to this property truncated: Optional\[bool] Link to this property
Link to this property
class InvocationWorkersUnionMember1: … cpu\_time\_ms: float Link to this property
event\_type: Literal\["fetch", "scheduled", "alarm", 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: str Link to this property script\_name: str Link to this property wall\_time\_ms: float Link to this property
diagnostics\_channel\_events: Optional\[List\[InvocationWorkersUnionMember1DiagnosticsChannelEvent]] channel: str Link to this property message: str Link to this property timestamp: float Link to this property
Link to this property dispatch\_namespace: Optional\[str] Link to this property durable\_object\_id: Optional\[str] Link to this property entrypoint: Optional\[str] Link to this property event: Optional\[Dict\[str, object]] Link to this property
execution\_model: Optional\[Literal\["durableObject", "stateless"]] One of the following: "durableObject" Link to this property "stateless" Link to this property
Link to this property
preview: Optional\[InvocationWorkersUnionMember1Preview] id: Optional\[str] Link to this property name: Optional\[str] Link to this property slug: Optional\[str] Link to this property
Link to this property request\_id: Optional\[str] Link to this property
script\_version: Optional\[InvocationWorkersUnionMember1ScriptVersion] id: Optional\[str] Link to this property message: Optional\[str] Link to this property tag: Optional\[str] Link to this property
Link to this property span\_id: Optional\[str] Link to this property trace\_id: Optional\[str] Link to this property truncated: Optional\[bool] Link to this property
Link to this property
Link to this property
Link to this property
traces: Optional\[List\[Trace]] 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. root\_span\_name: str Name of the root span that initiated the trace. Link to this property root\_transaction\_name: str Logical transaction name for the root span. Link to this property service: List\[str] List of Worker services involved in the trace. Link to this property spans: float Total number of spans in the trace. Link to this property trace\_duration\_ms: float Total duration of the trace in milliseconds. Link to this property trace\_end\_ms: float Trace end time as a Unix epoch in milliseconds. Link to this property trace\_id: str Unique identifier for the distributed trace. Link to this property trace\_start\_ms: float Trace start time as a Unix epoch in milliseconds. Link to this property errors: Optional\[List\[str]] 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)>)