Observability
ObservabilityTelemetry
List keys
Run a query
List values
Prepare live tail
Live tail heartbeat
ModelsExpand Collapse
TelemetryQueryResponse object { run, statistics, agents, 6 more } Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).
Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).
run: object { id, accountId, dry, 8 more } Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics.
Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics.
Number of time-series buckets used for the query. Higher values produce more detailed series data.
query: object { id, adhoc, created, 6 more } A saved query definition with its parameters, metadata, and ownership information.
A saved query definition with its parameters, metadata, and ownership information.
parameters: object { calculations, datasets, filterCombination, 6 more }
calculations: optional array of object { operator, alias, key, keyType } or object { key, operator, alias, keyType } Create Calculations to compute as part of the query.
Create Calculations to compute as part of the query.
Set the Datasets to query. Leave it empty to query all the datasets.
filterCombination: optional "and" or "or" or "AND" or "OR"Set a Flag to describe how to combine the filters on the query.
Set a Flag to describe how to combine the filters on the query.
filters: optional array of object { filterCombination, filters, kind } or object { key, operation, type, 2 more } Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
WorkersObservabilityFilterLeaf object { key, operation, type, 2 more } A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error.
operation: "includes" or "not_includes" or "starts_with" or 27 moreComparison 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.
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.
type: "string" or "number" or "boolean"Data type of the filter field. Must match the actual type of the key being filtered.
Data type of the filter field. Must match the actual type of the key being filtered.
Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted.
havings: optional array of object { key, operation, value } Configure the Having clauses that filter on calculations in the query result.
Configure the Having clauses that filter on calculations in the query result.
Set a limit on the number of results / records returned by the query
timeframe: object { from, to } Time range for the query execution. ‘from’ must be earlier than ‘to’. No fractional milliseconds.
Time range for the query execution. ‘from’ must be earlier than ‘to’. No fractional milliseconds.
statistics: object { bytes_read, elapsed, rows_read, abr_level } Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency.
Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency.
agents: optional array of object { id, errors, models, 13 more } Agent run summaries. Present when the query view is ‘agents’. Each entry represents one trace containing at least one agent invocation.
Agent run summaries. Present when the query view is ‘agents’. Each entry represents one trace containing at least one agent invocation.
calculations: optional array of object { aggregates, calculation, series, alias } Aggregated calculation results. Present when the query view is ‘calculations’. Contains computed metrics (count, avg, p99, etc.) with optional group-by breakdowns and time-series data.
Aggregated calculation results. Present when the query view is ‘calculations’. Contains computed metrics (count, avg, p99, etc.) with optional group-by breakdowns and time-series data.
aggregates: array of object { count, interval, sampleInterval, 2 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
series: array of object { data, time }
data: array of object { count, interval, sampleInterval, 4 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval
compare: optional array of object { aggregates, calculation, series, alias } Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.
Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.
aggregates: array of object { count, interval, sampleInterval, 2 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
series: array of object { data, time }
data: array of object { count, interval, sampleInterval, 4 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval
distribution: optional object { bins, bucketBoundaries, bucketMode, 2 more } Bucketed 2D histogram of a numeric field over time. Present when chartType is ‘distribution’.
Bucketed 2D histogram of a numeric field over time. Present when chartType is ‘distribution’.
events: optional object { count, events, fields, series } Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata.
Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata.
Total number of events matching the query (may exceed the number returned due to limits).
events: optional array of object { "$metadata", dataset, source, 3 more } List of individual telemetry events matching the query.
List of individual telemetry events matching the query.
"$metadata": object { id, account, cloudService, 35 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Templatized version of the error message used for grouping similar errors.
Templatized version of the log message used for grouping similar messages.
Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation.
Cloudflare request ID that ties all logs from a single invocation together.
spanStatus: optional "unset" or "ok" or "error"OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status message. Present only on spans when the status is error and a message was set.
HTTP response status code returned by the Worker.
Total duration of the entire trace in milliseconds.
source: string or map[unknown]Raw log payload. May be a string or a structured object depending on how the log was emitted.
Raw log payload. May be a string or a structured object depending on how the log was emitted.
Cloudflare Containers event information that enriches your logs for identifying and debugging issues.
"$workers": optional object { eventType, scriptName, durableObjectId, 11 more } or object { cpuTimeMs, eventType, outcome, 15 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
object { eventType, scriptName, durableObjectId, 11 more }
object { cpuTimeMs, eventType, outcome, 15 more }
fields: optional array of object { key, type } List of fields discovered in the matched events. Useful for building dynamic UIs.
List of fields discovered in the matched events. Useful for building dynamic UIs.
series: optional array of object { data, time } Time-series data for the matched events, bucketed by the query granularity.
Time-series data for the matched events, bucketed by the query granularity.
data: array of object { aggregates, count, interval, 3 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
invocations: optional map[array of object { "$metadata", dataset, source, 3 more } ]Events grouped by invocation (request ID). Present when the query view is ‘invocations’. Each key is a request ID mapping to all events from that invocation.
Events grouped by invocation (request ID). Present when the query view is ‘invocations’. Each key is a request ID mapping to all events from that invocation.
"$metadata": object { id, account, cloudService, 35 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Templatized version of the error message used for grouping similar errors.
Templatized version of the log message used for grouping similar messages.
Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation.
Cloudflare request ID that ties all logs from a single invocation together.
spanStatus: optional "unset" or "ok" or "error"OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status message. Present only on spans when the status is error and a message was set.
HTTP response status code returned by the Worker.
Total duration of the entire trace in milliseconds.
source: string or map[unknown]Raw log payload. May be a string or a structured object depending on how the log was emitted.
Raw log payload. May be a string or a structured object depending on how the log was emitted.
Cloudflare Containers event information that enriches your logs for identifying and debugging issues.
"$workers": optional object { eventType, scriptName, durableObjectId, 11 more } or object { cpuTimeMs, eventType, outcome, 15 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
object { eventType, scriptName, durableObjectId, 11 more }
object { cpuTimeMs, eventType, outcome, 15 more }
ObservabilityAgents
ObservabilityAgentsTraces
List Agent Traces
Get an Agent Trace
List Agent Trace events
ModelsExpand Collapse
TraceListResponse object { agents, conversationIds, errorCount, 19 more }
Sorted distinct gen_ai.agent.name values of authorized Agent invocations in the Trace within the effective window. Includes every Agent in the Trace, not only those matching the agent filter.
Sorted distinct gen_ai.conversation.id values of authorized Agent invocations in the Trace within the effective window. Empty when none are recorded.
Recorded spans with a nonempty error or ERROR status. Counts spans, not distinct messages or incidents.
Input tokens reported by chat spans in the authorized Trace window; null when none report input usage. Informational, not billing data.
Latest start of an authorized Agent invocation in the Trace within the effective window, as Unix epoch milliseconds. The Trace list is ordered by this value, newest first.
Sorted distinct response models, falling back to request models, from chat spans in the authorized Trace window.
Output tokens reported by chat spans in the authorized Trace window; null when none report output usage. Informational, not billing data.
Sorted distinct GenAI providers from chat spans in the authorized Trace window.
Recorded execute_tool spans in the authorized Trace window. Custom-named approval spans are not counted.
TraceGetResponse object { agents, conversationIds, errorCount, 19 more }
Sorted distinct gen_ai.agent.name values of authorized Agent invocations in the Trace within the effective window. Includes every Agent in the Trace, not only those matching the agent filter.
Sorted distinct gen_ai.conversation.id values of authorized Agent invocations in the Trace within the effective window. Empty when none are recorded.
Recorded spans with a nonempty error or ERROR status. Counts spans, not distinct messages or incidents.
Input tokens reported by chat spans in the authorized Trace window; null when none report input usage. Informational, not billing data.
Latest start of an authorized Agent invocation in the Trace within the effective window, as Unix epoch milliseconds. The Trace list is ordered by this value, newest first.
Sorted distinct response models, falling back to request models, from chat spans in the authorized Trace window.
Output tokens reported by chat spans in the authorized Trace window; null when none report output usage. Informational, not billing data.
Sorted distinct GenAI providers from chat spans in the authorized Trace window.
Recorded execute_tool spans in the authorized Trace window. Custom-named approval spans are not counted.
TraceEventsResponse = array of object { "$metadata", dataset, source, 3 more }
"$metadata": object { id, account, cloudService, 35 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Templatized version of the error message used for grouping similar errors.
Templatized version of the log message used for grouping similar messages.
Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation.
Cloudflare request ID that ties all logs from a single invocation together.
spanStatus: optional "unset" or "ok" or "error"OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status message. Present only on spans when the status is error and a message was set.
HTTP response status code returned by the Worker.
Total duration of the entire trace in milliseconds.
source: string or map[unknown]Raw log payload. May be a string or a structured object depending on how the log was emitted.
Raw log payload. May be a string or a structured object depending on how the log was emitted.
Cloudflare Containers event information that enriches your logs for identifying and debugging issues.
"$workers": optional object { eventType, scriptName, durableObjectId, 11 more } or object { cpuTimeMs, eventType, outcome, 15 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
object { eventType, scriptName, durableObjectId, 11 more }
object { cpuTimeMs, eventType, outcome, 15 more }
ObservabilityIssues
List detected issues
Get an issue
Modify an issue
Summarize detected issues
Create an issue group
Dissolve an issue group
Add issue group members
Remove an issue group member
Notify about an issue
List issue occurrences
ModelsExpand Collapse
IssueOccurrencesResponse = array of object { id, error, invocation, 5 more }
trail: array of object { level, message, timestamp, type } or object { name, ongoing, spanId, 3 more }
ObservabilityIssuesAutomations
List issue automations
Get an issue automation
Create an issue automation
Update an issue automation
Delete an issue automation
ModelsExpand Collapse
ObservabilityDestinations
Get Destinations
Create Destination
Update Destination
Delete Destination
ModelsExpand Collapse
ObservabilityQueries
Save query
List queries
ModelsExpand Collapse
QueryCreateResponse object { id, adhoc, created, 6 more }
parameters: object { calculations, datasets, filterCombination, 6 more }
calculations: optional array of object { operator, alias, key, keyType } or object { key, operator, alias, keyType } Create Calculations to compute as part of the query.
Create Calculations to compute as part of the query.
Set the Datasets to query. Leave it empty to query all the datasets.
filterCombination: optional "and" or "or" or "AND" or "OR"Set a Flag to describe how to combine the filters on the query.
Set a Flag to describe how to combine the filters on the query.
filters: optional array of object { filterCombination, filters, kind } or object { key, operation, type, 2 more } Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
WorkersObservabilityFilterLeaf object { key, operation, type, 2 more } A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error.
operation: "includes" or "not_includes" or "starts_with" or 27 moreComparison 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.
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.
type: "string" or "number" or "boolean"Data type of the filter field. Must match the actual type of the key being filtered.
Data type of the filter field. Must match the actual type of the key being filtered.
Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted.
havings: optional array of object { key, operation, value } Configure the Having clauses that filter on calculations in the query result.
Configure the Having clauses that filter on calculations in the query result.
Set a limit on the number of results / records returned by the query
QueryListResponse object { id, adhoc, created, 6 more }
parameters: object { calculations, datasets, filterCombination, 6 more }
calculations: optional array of object { operator, alias, key, keyType } or object { key, operator, alias, keyType } Create Calculations to compute as part of the query.
Create Calculations to compute as part of the query.
Set the Datasets to query. Leave it empty to query all the datasets.
filterCombination: optional "and" or "or" or "AND" or "OR"Set a Flag to describe how to combine the filters on the query.
Set a Flag to describe how to combine the filters on the query.
filters: optional array of object { filterCombination, filters, kind } or object { key, operation, type, 2 more } Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
WorkersObservabilityFilterLeaf object { key, operation, type, 2 more } A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error.
operation: "includes" or "not_includes" or "starts_with" or 27 moreComparison 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.
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.
type: "string" or "number" or "boolean"Data type of the filter field. Must match the actual type of the key being filtered.
Data type of the filter field. Must match the actual type of the key being filtered.
Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted.
havings: optional array of object { key, operation, value } Configure the Having clauses that filter on calculations in the query result.
Configure the Having clauses that filter on calculations in the query result.
Set a limit on the number of results / records returned by the query
ObservabilityShared Queries
Create a sharable link to a query result
View a query that has been shared
ModelsExpand Collapse
SharedQueryGetResponse object { run, statistics, agents, 6 more } Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).
Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).
run: object { id, accountId, dry, 8 more } Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics.
Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics.
Number of time-series buckets used for the query. Higher values produce more detailed series data.
query: object { id, adhoc, created, 6 more } A saved query definition with its parameters, metadata, and ownership information.
A saved query definition with its parameters, metadata, and ownership information.
parameters: object { calculations, datasets, filterCombination, 6 more }
calculations: optional array of object { operator, alias, key, keyType } or object { key, operator, alias, keyType } Create Calculations to compute as part of the query.
Create Calculations to compute as part of the query.
Set the Datasets to query. Leave it empty to query all the datasets.
filterCombination: optional "and" or "or" or "AND" or "OR"Set a Flag to describe how to combine the filters on the query.
Set a Flag to describe how to combine the filters on the query.
filters: optional array of object { filterCombination, filters, kind } or object { key, operation, type, 2 more } Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.
WorkersObservabilityFilterLeaf object { key, operation, type, 2 more } A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.
Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error.
operation: "includes" or "not_includes" or "starts_with" or 27 moreComparison 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.
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.
type: "string" or "number" or "boolean"Data type of the filter field. Must match the actual type of the key being filtered.
Data type of the filter field. Must match the actual type of the key being filtered.
Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted.
havings: optional array of object { key, operation, value } Configure the Having clauses that filter on calculations in the query result.
Configure the Having clauses that filter on calculations in the query result.
Set a limit on the number of results / records returned by the query
timeframe: object { from, to } Time range for the query execution. ‘from’ must be earlier than ‘to’. No fractional milliseconds.
Time range for the query execution. ‘from’ must be earlier than ‘to’. No fractional milliseconds.
statistics: object { bytes_read, elapsed, rows_read, abr_level } Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency.
Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency.
agents: optional array of object { id, errors, models, 13 more } Agent run summaries. Present when the query view is ‘agents’. Each entry represents one trace containing at least one agent invocation.
Agent run summaries. Present when the query view is ‘agents’. Each entry represents one trace containing at least one agent invocation.
calculations: optional array of object { aggregates, calculation, series, alias } Aggregated calculation results. Present when the query view is ‘calculations’. Contains computed metrics (count, avg, p99, etc.) with optional group-by breakdowns and time-series data.
Aggregated calculation results. Present when the query view is ‘calculations’. Contains computed metrics (count, avg, p99, etc.) with optional group-by breakdowns and time-series data.
aggregates: array of object { count, interval, sampleInterval, 2 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
series: array of object { data, time }
data: array of object { count, interval, sampleInterval, 4 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval
compare: optional array of object { aggregates, calculation, series, alias } Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.
Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.
aggregates: array of object { count, interval, sampleInterval, 2 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
series: array of object { data, time }
data: array of object { count, interval, sampleInterval, 4 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
Result of the calculation. count, sum, avg, median, and percentiles are weighted by each event’s sample interval
distribution: optional object { bins, bucketBoundaries, bucketMode, 2 more } Bucketed 2D histogram of a numeric field over time. Present when chartType is ‘distribution’.
Bucketed 2D histogram of a numeric field over time. Present when chartType is ‘distribution’.
events: optional object { count, events, fields, series } Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata.
Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata.
Total number of events matching the query (may exceed the number returned due to limits).
events: optional array of object { "$metadata", dataset, source, 3 more } List of individual telemetry events matching the query.
List of individual telemetry events matching the query.
"$metadata": object { id, account, cloudService, 35 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Templatized version of the error message used for grouping similar errors.
Templatized version of the log message used for grouping similar messages.
Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation.
Cloudflare request ID that ties all logs from a single invocation together.
spanStatus: optional "unset" or "ok" or "error"OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status message. Present only on spans when the status is error and a message was set.
HTTP response status code returned by the Worker.
Total duration of the entire trace in milliseconds.
source: string or map[unknown]Raw log payload. May be a string or a structured object depending on how the log was emitted.
Raw log payload. May be a string or a structured object depending on how the log was emitted.
Cloudflare Containers event information that enriches your logs for identifying and debugging issues.
"$workers": optional object { eventType, scriptName, durableObjectId, 11 more } or object { cpuTimeMs, eventType, outcome, 15 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
object { eventType, scriptName, durableObjectId, 11 more }
object { cpuTimeMs, eventType, outcome, 15 more }
fields: optional array of object { key, type } List of fields discovered in the matched events. Useful for building dynamic UIs.
List of fields discovered in the matched events. Useful for building dynamic UIs.
series: optional array of object { data, time } Time-series data for the matched events, bucketed by the query granularity.
Time-series data for the matched events, bucketed by the query granularity.
data: array of object { aggregates, count, interval, 3 more }
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.
Deprecated alias of sampleInterval. Always has the same value; use sampleInterval instead.
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.
invocations: optional map[array of object { "$metadata", dataset, source, 3 more } ]Events grouped by invocation (request ID). Present when the query view is ‘invocations’. Each key is a request ID mapping to all events from that invocation.
Events grouped by invocation (request ID). Present when the query view is ‘invocations’. Each key is a request ID mapping to all events from that invocation.
"$metadata": object { id, account, cloudService, 35 more } Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.
Templatized version of the error message used for grouping similar errors.
Templatized version of the log message used for grouping similar messages.
Cloudflare Ray ID from the cf-ray header of the request that triggered the invocation.
Cloudflare request ID that ties all logs from a single invocation together.
spanStatus: optional "unset" or "ok" or "error"OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status. Present only on spans. unset when the span did not set a status, including spans recorded before status was captured.
OpenTelemetry span status message. Present only on spans when the status is error and a message was set.
HTTP response status code returned by the Worker.
Total duration of the entire trace in milliseconds.
source: string or map[unknown]Raw log payload. May be a string or a structured object depending on how the log was emitted.
Raw log payload. May be a string or a structured object depending on how the log was emitted.
Cloudflare Containers event information that enriches your logs for identifying and debugging issues.
"$workers": optional object { eventType, scriptName, durableObjectId, 11 more } or object { cpuTimeMs, eventType, outcome, 15 more } Cloudflare Workers event information that enriches your logs for identifying and debugging issues.
Cloudflare Workers event information that enriches your logs for identifying and debugging issues.