Run a query

client.Workers.Observability.Telemetry.Query(ctx, params) (*ObservabilityTelemetryQueryResponse, error)

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

Run a temporary or saved query.

Security

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

User Service Key

Used when interacting with the Origin CA certificates API. View/change your key.

Example:

X-Auth-User-Service-Key: v1.0-144c9defac04969c7bfad8ef-631a41d003a32d25fe878081ef365c49503f7fada600da935e2851a1c7326084b85cbf6429c4b859de8475731dc92a9c329631e6d59e6c73da7b198497172b4cefe071d90d0f5d2719

Accepted Permissions (at least one required)

Workers Observability Write

ParametersExpand Collapse

params ObservabilityTelemetryQueryParams

AccountID param.Field[string]

Path param: Your Cloudflare account ID.

QueryID param.Field[string]

Body param: Identifier for the query. When parameters are omitted, this ID is used to load a previously saved query’s parameters. When providing parameters inline, pass any identifier (e.g. an ad-hoc ID).

Timeframe param.Field[ObservabilityTelemetryQueryParamsTimeframe]

Body param: Timeframe for the query using Unix timestamps in milliseconds. Narrower timeframes produce faster responses and more specific results.

From float64

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

To float64

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

Chart param.Field[bool]Optional

Body param: When true, includes time-series data in the response.

Compare param.Field[bool]Optional

Body param: When true, includes a comparison dataset from the previous time period of equal length.

Dry param.Field[bool]Optional

Body param: When true, executes the query without persisting the results. Useful for validation or previewing.

Granularity param.Field[float64]Optional

Body param: Number of time-series buckets. Only used when view is ‘calculations’. Omit to let the system auto-detect an appropriate granularity.

IgnoreSeries param.Field[bool]Optional

Body param: When true, omits time-series data from the response and returns only aggregated values. Reduces response size when series are not needed.

Limit param.Field[float64]Optional

Body param: Maximum number of events to return when view is ‘events’. Also controls the number of group-by rows when view is ‘calculations’.

maximum2000

Offset param.Field[string]Optional

Body param: Cursor for pagination in event, trace, and invocation views. Pass the $metadata.id of the last returned item to fetch the next page.

OffsetBy param.Field[float64]Optional

Body param: Numeric offset for paginating grouped/pattern results (top-N lists). Use together with limit. Not used by cursor-based pagination.

OffsetDirection param.Field[string]Optional

Body param: Pagination direction: ‘next’ for forward, ‘prev’ for backward.

Parameters param.Field[ObservabilityTelemetryQueryParamsParameters]Optional

Body param: Query parameters defining what data to retrieve — filters, calculations, group-bys, and ordering. In practice this should always be provided for ad-hoc queries. Only omit when executing a previously saved query by queryId. Use the keys and values endpoints to discover available fields before building filters.

Calculations []ObservabilityTelemetryQueryParamsParametersCalculationOptional

Aggregation calculations to compute (e.g. count, avg, p99). Each calculation produces aggregate values and optional time-series data.

Operator ObservabilityTelemetryQueryParamsParametersCalculationsOperator

Aggregation operator to apply. Examples: count, avg, sum, min, max, median, p90, p95, p99, uniq, stddev, variance.

One of the following:

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorUniq ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "uniq"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorCount ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "count"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorMax ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "max"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorMin ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "min"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorSum ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "sum"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorAvg ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "avg"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorMedian ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "median"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP001 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p001"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP01 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p01"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP05 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p05"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP10 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p10"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP25 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p25"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP75 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p75"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP90 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p90"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP95 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p95"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP99 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p99"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP999 ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "p999"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorStddev ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "stddev"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorVariance ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "variance"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorCountDistinct ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "COUNT_DISTINCT"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorCountUppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "COUNT"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorMaxUppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "MAX"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorMinUppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "MIN"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorSumUppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "SUM"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorAvgUppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "AVG"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorMedianUppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "MEDIAN"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP001Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P001"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP01Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P01"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP05Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P05"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP10Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P10"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP25Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P25"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP75Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P75"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP90Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P90"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP95Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P95"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP99Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P99"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorP999Uppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "P999"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorStddevUppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "STDDEV"

const ObservabilityTelemetryQueryParamsParametersCalculationsOperatorVarianceUppercase ObservabilityTelemetryQueryParamsParametersCalculationsOperator = "VARIANCE"

Alias stringOptional

Custom label for this calculation in the results. Useful for distinguishing multiple calculations.

Key stringOptional

Field name to calculate over. Must exist in the data — verify with the keys endpoint. Omit for operators that don’t require a key (e.g. count).

KeyType ObservabilityTelemetryQueryParamsParametersCalculationsKeyTypeOptional

Data type of the key. Required when key is provided to ensure correct aggregation.

One of the following:

const ObservabilityTelemetryQueryParamsParametersCalculationsKeyTypeString ObservabilityTelemetryQueryParamsParametersCalculationsKeyType = "string"

const ObservabilityTelemetryQueryParamsParametersCalculationsKeyTypeNumber ObservabilityTelemetryQueryParamsParametersCalculationsKeyType = "number"

const ObservabilityTelemetryQueryParamsParametersCalculationsKeyTypeBoolean ObservabilityTelemetryQueryParamsParametersCalculationsKeyType = "boolean"

Datasets []stringOptional

Datasets to query. Leave empty to query all available datasets.

FilterCombination ObservabilityTelemetryQueryParamsParametersFilterCombinationOptional

Logical operator for combining top-level filters: ‘and’ (all must match) or ‘or’ (any must match). Defaults to ‘and’.

One of the following:

const ObservabilityTelemetryQueryParamsParametersFilterCombinationAnd ObservabilityTelemetryQueryParamsParametersFilterCombination = "and"

const ObservabilityTelemetryQueryParamsParametersFilterCombinationOr ObservabilityTelemetryQueryParamsParametersFilterCombination = "or"

const ObservabilityTelemetryQueryParamsParametersFilterCombinationAndUppercase ObservabilityTelemetryQueryParamsParametersFilterCombination = "AND"

const ObservabilityTelemetryQueryParamsParametersFilterCombinationOrUppercase ObservabilityTelemetryQueryParamsParametersFilterCombination = "OR"

Filters []ObservabilityTelemetryQueryParamsParametersFilterOptional

Filters to narrow query results. Use the keys and values endpoints to discover available fields before building filters. Supports nested groups via kind: ‘group’. Maximum nesting depth is 4.

One of the following:

type ObservabilityTelemetryQueryParamsParametersFiltersObject struct{…}

FilterCombination ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombination

One of the following:

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombinationAnd ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombination = "and"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombinationOr ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombination = "or"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombinationAndUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombination = "AND"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombinationOrUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFilterCombination = "OR"

Filters []ObservabilityTelemetryQueryParamsParametersFiltersObjectFilter

One of the following:

type ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObject struct{…}

FilterCombination ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombination

One of the following:

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombinationAnd ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombination = "and"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombinationOr ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombination = "or"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombinationAndUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombination = "AND"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombinationOrUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectFilterCombination = "OR"

Filters []unknown

Kind ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersObjectKind

type ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeaf struct{…}

A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.

Key string

Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error.

Operation ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation

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:

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationIncludes ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "includes"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNotIncludes ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "not_includes"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationStartsWith ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "starts_with"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationEndsWith ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "ends_with"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationRegex ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "regex"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationExists ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "exists"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationIsNull ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "is_null"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationIn ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "in"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNotIn ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "not_in"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationEq ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "eq"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNeq ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "neq"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationGt ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "gt"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationGte ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "gte"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationLt ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "lt"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationLte ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "lte"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationEquals ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "="

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNotEquals ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "!="

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationGreater ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = ">"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationGreaterOrEquals ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = ">="

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationLess ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "<"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationLessOrEquals ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "<="

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationIncludesUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "INCLUDES"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationDoesNotInclude ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_INCLUDE"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationMatchRegex ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "MATCH_REGEX"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationExistsUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "EXISTS"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationDoesNotExist ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_EXIST"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationInUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "IN"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNotInUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "NOT_IN"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationStartsWithUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "STARTS_WITH"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationEndsWithUppercase ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "ENDS_WITH"

Type ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafType

Data type of the filter field. Must match the actual type of the key being filtered.

One of the following:

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafTypeString ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafType = "string"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafTypeNumber ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafType = "number"

const ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafTypeBoolean ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafType = "boolean"

Kind ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafKindOptional

Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted.

Value ObservabilityTelemetryQueryParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafValueUnionOptional

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:

UnionString

UnionFloat

UnionBool

Kind ObservabilityTelemetryQueryParamsParametersFiltersObjectKind

type ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeaf struct{…}

A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.

Key string

Operation ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation

One of the following:

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationIncludes ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "includes"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotIncludes ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "not_includes"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationStartsWith ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "starts_with"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationEndsWith ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "ends_with"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationRegex ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "regex"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationExists ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "exists"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationIsNull ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "is_null"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationIn ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "in"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotIn ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "not_in"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationEq ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "eq"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationNeq ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "neq"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationGt ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "gt"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationGte ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "gte"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationLt ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "lt"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationLte ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "lte"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationEquals ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "="

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotEquals ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "!="

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationGreater ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = ">"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationGreaterOrEquals ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = ">="

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationLess ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "<"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationLessOrEquals ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "<="

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationIncludesUppercase ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "INCLUDES"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotInclude ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_INCLUDE"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationMatchRegex ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "MATCH_REGEX"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationExistsUppercase ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "EXISTS"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotExist ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_EXIST"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationInUppercase ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "IN"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotInUppercase ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "NOT_IN"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationStartsWithUppercase ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "STARTS_WITH"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperationEndsWithUppercase ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "ENDS_WITH"

Type ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafType

Data type of the filter field. Must match the actual type of the key being filtered.

One of the following:

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafTypeString ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafType = "string"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafTypeNumber ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafType = "number"

const ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafTypeBoolean ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafType = "boolean"

Kind ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafKindOptional

Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted.

Value ObservabilityTelemetryQueryParamsParametersFiltersWorkersObservabilityFilterLeafValueUnionOptional

One of the following:

UnionString

UnionFloat

UnionBool

GroupBys []ObservabilityTelemetryQueryParamsParametersGroupByOptional

Fields to group calculation results by. Only applicable when the query view is ‘calculations’. Produces per-group aggregate values.

Type ObservabilityTelemetryQueryParamsParametersGroupBysType

Data type of the group-by field.

One of the following:

const ObservabilityTelemetryQueryParamsParametersGroupBysTypeString ObservabilityTelemetryQueryParamsParametersGroupBysType = "string"

const ObservabilityTelemetryQueryParamsParametersGroupBysTypeNumber ObservabilityTelemetryQueryParamsParametersGroupBysType = "number"

const ObservabilityTelemetryQueryParamsParametersGroupBysTypeBoolean ObservabilityTelemetryQueryParamsParametersGroupBysType = "boolean"

Value string

Field name to group results by (e.g. $metadata.service, $metadata.statusCode).

Havings []ObservabilityTelemetryQueryParamsParametersHavingOptional

Post-aggregation filters applied to calculation results. Use to filter groups after aggregation (e.g. only groups where count > 100).

Key string

Calculation alias or operator to filter on after aggregation.

Operation ObservabilityTelemetryQueryParamsParametersHavingsOperation

Numeric comparison operator: eq, neq, gt, gte, lt, lte.

One of the following:

const ObservabilityTelemetryQueryParamsParametersHavingsOperationEq ObservabilityTelemetryQueryParamsParametersHavingsOperation = "eq"

const ObservabilityTelemetryQueryParamsParametersHavingsOperationNeq ObservabilityTelemetryQueryParamsParametersHavingsOperation = "neq"

const ObservabilityTelemetryQueryParamsParametersHavingsOperationGt ObservabilityTelemetryQueryParamsParametersHavingsOperation = "gt"

const ObservabilityTelemetryQueryParamsParametersHavingsOperationGte ObservabilityTelemetryQueryParamsParametersHavingsOperation = "gte"

const ObservabilityTelemetryQueryParamsParametersHavingsOperationLt ObservabilityTelemetryQueryParamsParametersHavingsOperation = "lt"

const ObservabilityTelemetryQueryParamsParametersHavingsOperationLte ObservabilityTelemetryQueryParamsParametersHavingsOperation = "lte"

Value float64

Threshold value to compare the calculation result against.

Limit int64Optional

Maximum number of group-by rows to return in calculation results. A value of 10 is a sensible default for most use cases.

maximum2000

minimum0

Needle ObservabilityTelemetryQueryParamsParametersNeedleOptional

Full-text search expression applied across all event fields. Matches events containing the specified text.

Value ObservabilityTelemetryQueryParamsParametersNeedleValueUnion

The text or pattern to search for.

maxLength1000

One of the following:

UnionString

UnionFloat

UnionBool

IsRegex boolOptional

When true, treats the value as a regular expression (RE2 syntax).

MatchCase boolOptional

When true, performs a case-sensitive search. Defaults to case-insensitive.

OrderBy ObservabilityTelemetryQueryParamsParametersOrderByOptional

Ordering for grouped calculation results. Only effective when a group-by is present.

Value string

Alias of the calculation to order results by. Must match the alias (or operator) of a calculation in the query.

Order ObservabilityTelemetryQueryParamsParametersOrderByOrderOptional

Sort direction: ‘asc’ for ascending, ‘desc’ for descending.

One of the following:

const ObservabilityTelemetryQueryParamsParametersOrderByOrderAsc ObservabilityTelemetryQueryParamsParametersOrderByOrder = "asc"

const ObservabilityTelemetryQueryParamsParametersOrderByOrderDesc ObservabilityTelemetryQueryParamsParametersOrderByOrder = "desc"

View param.Field[ObservabilityTelemetryQueryParamsView]Optional

Body param: Controls the shape of the response. ‘events’: individual log lines matching the query. ‘calculations’: aggregated metrics (count, avg, p99, etc.) with optional group-by breakdowns and time-series. ‘invocations’: events grouped by request ID. ‘traces’: distributed trace summaries. ‘agents’: Durable Object agent summaries.

const ObservabilityTelemetryQueryParamsViewTraces ObservabilityTelemetryQueryParamsView = "traces"

const ObservabilityTelemetryQueryParamsViewEvents ObservabilityTelemetryQueryParamsView = "events"

const ObservabilityTelemetryQueryParamsViewCalculations ObservabilityTelemetryQueryParamsView = "calculations"

const ObservabilityTelemetryQueryParamsViewInvocations ObservabilityTelemetryQueryParamsView = "invocations"

const ObservabilityTelemetryQueryParamsViewRequests ObservabilityTelemetryQueryParamsView = "requests"

const ObservabilityTelemetryQueryParamsViewAgents ObservabilityTelemetryQueryParamsView = "agents"

ReturnsExpand Collapse

type ObservabilityTelemetryQueryResponse struct{…}

Complete results of a query run. The populated fields depend on the requested view type (events, calculations, invocations, traces, or agents).

Run ObservabilityTelemetryQueryResponseRun

Represents a single execution of a query against Workers Observability data, including the query definition, execution status, and performance statistics.

ID string

Unique identifier for this query run.

AccountID string

Cloudflare account ID that owns this query run.

Dry bool

Whether this was a dry run (results not persisted).

Granularity float64

Number of time-series buckets used for the query. Higher values produce more detailed series data.

Query ObservabilityTelemetryQueryResponseRunQuery

A saved query definition with its parameters, metadata, and ownership information.

ID string

Adhoc bool

If the query wasn’t explcitly saved

Created string

CreatedBy string

Description string

maxLength1000

Name string

Query name

maxLength250

minLength1

Parameters ObservabilityTelemetryQueryResponseRunQueryParameters

Calculations []ObservabilityTelemetryQueryResponseRunQueryParametersCalculationOptional

Create Calculations to compute as part of the query.

Operator ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorUniq ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "uniq"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorCount ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "count"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorMax ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "max"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorMin ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "min"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorSum ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "sum"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorAvg ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "avg"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorMedian ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "median"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP001 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p001"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP01 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p01"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP05 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p05"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP10 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p10"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP25 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p25"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP75 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p75"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP90 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p90"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP95 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p95"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP99 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p99"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP999 ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "p999"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorStddev ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "stddev"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorVariance ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "variance"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorCountDistinct ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "COUNT_DISTINCT"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorCountUppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "COUNT"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorMaxUppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "MAX"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorMinUppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "MIN"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorSumUppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "SUM"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorAvgUppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "AVG"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorMedianUppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "MEDIAN"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP001Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P001"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP01Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P01"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP05Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P05"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP10Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P10"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP25Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P25"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP75Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P75"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP90Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P90"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP95Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P95"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP99Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P99"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorP999Uppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "P999"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorStddevUppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "STDDEV"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperatorVarianceUppercase ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsOperator = "VARIANCE"

Alias stringOptional

Key stringOptional

KeyType ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsKeyTypeOptional

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsKeyTypeString ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsKeyType = "string"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsKeyTypeNumber ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsKeyType = "number"

const ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsKeyTypeBoolean ObservabilityTelemetryQueryResponseRunQueryParametersCalculationsKeyType = "boolean"

Datasets []stringOptional

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

FilterCombination ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombinationOptional

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

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombinationAnd ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombination = "and"

const ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombinationOr ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombination = "or"

const ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombinationAndUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombination = "AND"

const ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombinationOrUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFilterCombination = "OR"

Filters []ObservabilityTelemetryQueryResponseRunQueryParametersFilterOptional

Configure the Filters to apply to the query. Supports nested groups via kind: ‘group’.

One of the following:

type ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObject struct{…}

FilterCombination ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombination

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombinationAnd ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombination = "and"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombinationOr ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombination = "or"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombinationAndUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombination = "AND"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombinationOrUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectFilterCombination = "OR"

Filters []unknown

Kind ObservabilityTelemetryQueryResponseRunQueryParametersFiltersObjectKind

type ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeaf struct{…}

A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters.

Key string

Operation ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationIncludes ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "includes"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationNotIncludes ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "not_includes"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationStartsWith ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "starts_with"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationEndsWith ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "ends_with"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationRegex ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "regex"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationExists ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "exists"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationIsNull ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "is_null"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationIn ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "in"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationNotIn ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "not_in"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationEq ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "eq"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationNeq ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "neq"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationGt ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "gt"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationGte ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "gte"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationLt ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "lt"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationLte ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "lte"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationEquals ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "="

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationNotEquals ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "!="

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationGreater ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = ">"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationGreaterOrEquals ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = ">="

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationLess ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "<"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationLessOrEquals ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "<="

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationIncludesUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "INCLUDES"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotInclude ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_INCLUDE"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationMatchRegex ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "MATCH_REGEX"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationExistsUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "EXISTS"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotExist ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_EXIST"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationInUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "IN"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationNotInUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "NOT_IN"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationStartsWithUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "STARTS_WITH"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperationEndsWithUppercase ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafOperation = "ENDS_WITH"

Type ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafType

Data type of the filter field. Must match the actual type of the key being filtered.

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafTypeString ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafType = "string"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafTypeNumber ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafType = "number"

const ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafTypeBoolean ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafType = "boolean"

Kind ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafKindOptional

Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted.

Value ObservabilityTelemetryQueryResponseRunQueryParametersFiltersWorkersObservabilityFilterLeafValueUnionOptional

One of the following:

UnionString

UnionFloat

UnionBool

GroupBys []ObservabilityTelemetryQueryResponseRunQueryParametersGroupByOptional

Define how to group the results of the query.

Type ObservabilityTelemetryQueryResponseRunQueryParametersGroupBysType

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersGroupBysTypeString ObservabilityTelemetryQueryResponseRunQueryParametersGroupBysType = "string"

const ObservabilityTelemetryQueryResponseRunQueryParametersGroupBysTypeNumber ObservabilityTelemetryQueryResponseRunQueryParametersGroupBysType = "number"

const ObservabilityTelemetryQueryResponseRunQueryParametersGroupBysTypeBoolean ObservabilityTelemetryQueryResponseRunQueryParametersGroupBysType = "boolean"

Value string

Havings []ObservabilityTelemetryQueryResponseRunQueryParametersHavingOptional

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

Key string

Operation ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperation

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperationEq ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperation = "eq"

const ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperationNeq ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperation = "neq"

const ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperationGt ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperation = "gt"

const ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperationGte ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperation = "gte"

const ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperationLt ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperation = "lt"

const ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperationLte ObservabilityTelemetryQueryResponseRunQueryParametersHavingsOperation = "lte"

Value float64

Limit int64Optional

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

maximum100

minimum0

Needle ObservabilityTelemetryQueryResponseRunQueryParametersNeedleOptional

Define an expression to search using full-text search.

Value ObservabilityTelemetryQueryResponseRunQueryParametersNeedleValue

IsRegex boolOptional

MatchCase boolOptional

OrderBy ObservabilityTelemetryQueryResponseRunQueryParametersOrderByOptional

Configure the order of the results returned by the query.

Value string

Configure which Calculation to order the results by.

Order ObservabilityTelemetryQueryResponseRunQueryParametersOrderByOrderOptional

Set the order of the results

One of the following:

const ObservabilityTelemetryQueryResponseRunQueryParametersOrderByOrderAsc ObservabilityTelemetryQueryResponseRunQueryParametersOrderByOrder = "asc"

const ObservabilityTelemetryQueryResponseRunQueryParametersOrderByOrderDesc ObservabilityTelemetryQueryResponseRunQueryParametersOrderByOrder = "desc"

Updated string

UpdatedBy string

Status ObservabilityTelemetryQueryResponseRunStatus

Current execution status of the query run.

One of the following:

const ObservabilityTelemetryQueryResponseRunStatusStarted ObservabilityTelemetryQueryResponseRunStatus = "STARTED"

const ObservabilityTelemetryQueryResponseRunStatusCompleted ObservabilityTelemetryQueryResponseRunStatus = "COMPLETED"

Timeframe ObservabilityTelemetryQueryResponseRunTimeframe

Time range for the query execution

From float64

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

To float64

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

UserID string

ID of the user who initiated the query run.

Created stringOptional

ISO-8601 timestamp when the query run was created.

Statistics ObservabilityTelemetryQueryResponseRunStatisticsOptional

Query performance statistics from the database (does not include network latency).

BytesRead float64

Number of uncompressed bytes read from the table.

Elapsed float64

Time in seconds for the query to run.

RowsRead float64

Number of rows scanned from the table.

AbrLevel float64Optional

The level of Adaptive Bit Rate (ABR) sampling used for the query. If empty the ABR level is 1

Updated stringOptional

ISO-8601 timestamp when the query run was last updated.

Statistics ObservabilityTelemetryQueryResponseStatistics

Query performance statistics from the database. Includes execution time, rows scanned, and bytes read. Does not include network latency.

BytesRead float64

Number of uncompressed bytes read from the table.

Elapsed float64

Time in seconds for the query to run.

RowsRead float64

Number of rows scanned from the table.

AbrLevel float64Optional

The level of Adaptive Bit Rate (ABR) sampling used for the query. If empty the ABR level is 1

Agents []ObservabilityTelemetryQueryResponseAgentOptional

Durable Object agent summaries. Present when the query view is ‘agents’. Each entry represents an agent with its event counts and status.

AgentClass string

Class name of the Durable Object agent.

EventTypeCounts map[string, float64]

Breakdown of event counts by event type.

FirstEventMs float64

Timestamp of the earliest event from this agent in the queried window (Unix epoch ms).

HasErrors bool

Whether the agent emitted any error events in the queried window.

LastEventMs float64

Timestamp of the most recent event from this agent (Unix epoch ms).

Namespace string

Durable Object namespace the agent belongs to.

Service string

Worker service name that hosts this agent.

TotalEvents float64

Total number of events emitted by this agent in the queried window.

Calculations []ObservabilityTelemetryQueryResponseCalculationOptional

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 []ObservabilityTelemetryQueryResponseCalculationsAggregate

Count float64

Interval float64

SampleInterval float64

Value float64

Groups []ObservabilityTelemetryQueryResponseCalculationsAggregatesGroupOptional

Key string

Value ObservabilityTelemetryQueryResponseCalculationsAggregatesGroupsValueUnion

One of the following:

UnionString

UnionFloat

UnionBool

Calculation string

Series []ObservabilityTelemetryQueryResponseCalculationsSeries

Data []ObservabilityTelemetryQueryResponseCalculationsSeriesData

Count float64

Interval float64

SampleInterval float64

Value float64

FirstSeen stringOptional

Groups []ObservabilityTelemetryQueryResponseCalculationsSeriesDataGroupOptional

Key string

Value ObservabilityTelemetryQueryResponseCalculationsSeriesDataGroupsValueUnion

One of the following:

UnionString

UnionFloat

UnionBool

LastSeen stringOptional

Time string

Alias stringOptional

Compare []ObservabilityTelemetryQueryResponseCompareOptional

Comparison calculation results from the previous time period. Present when the compare option is enabled. Same structure as calculations.

Aggregates []ObservabilityTelemetryQueryResponseCompareAggregate

Count float64

Interval float64

SampleInterval float64

Value float64

Groups []ObservabilityTelemetryQueryResponseCompareAggregatesGroupOptional

Key string

Value ObservabilityTelemetryQueryResponseCompareAggregatesGroupsValueUnion

One of the following:

UnionString

UnionFloat

UnionBool

Calculation string

Series []ObservabilityTelemetryQueryResponseCompareSeries

Data []ObservabilityTelemetryQueryResponseCompareSeriesData

Count float64

Interval float64

SampleInterval float64

Value float64

FirstSeen stringOptional

Groups []ObservabilityTelemetryQueryResponseCompareSeriesDataGroupOptional

Key string

Value ObservabilityTelemetryQueryResponseCompareSeriesDataGroupsValueUnion

One of the following:

UnionString

UnionFloat

UnionBool

LastSeen stringOptional

Time string

Alias stringOptional

Events ObservabilityTelemetryQueryResponseEventsOptional

Individual event results. Present when the query view is ‘events’. Contains the matching log lines and their metadata.

Count float64Optional

Total number of events matching the query (may exceed the number returned due to limits).

Events []ObservabilityTelemetryQueryResponseEventsEventOptional

List of individual telemetry events matching the query.

Metadata ObservabilityTelemetryQueryResponseEventsEventsMetadata

Structured metadata extracted from the event. These fields are indexed and available for filtering and aggregation.

ID string

Unique event ID. Use as the cursor value for offset-based pagination.

Account stringOptional

Cloudflare account identifier.

CloudService stringOptional

Cloudflare product that generated this event (e.g. workers, pages).

ColdStart int64Optional

exclusiveMinimum

minimum0

Cost int64Optional

Estimated cost units for this invocation.

exclusiveMinimum

minimum0

Duration int64Optional

Span duration in milliseconds.

exclusiveMinimum

minimum0

EndTime int64Optional

Span end time as a Unix epoch in milliseconds.

minimum0

Error stringOptional

Error message, present when the log represents an error.

ErrorTemplate stringOptional

Templatized version of the error message used for grouping similar errors.

Fingerprint stringOptional

Content-based fingerprint used to group similar events.

Level stringOptional

Log level (e.g. log, debug, info, warn, error).

Message stringOptional

Log message text.

MessageTemplate stringOptional

Templatized version of the log message used for grouping similar messages.

MetricName stringOptional

Metric name when the event represents a metric data point.

Origin stringOptional

Origin of the event (e.g. fetch, scheduled, queue).

ParentSpanID stringOptional

Span ID of the parent span in the trace hierarchy.

Provider stringOptional

Infrastructure provider identifier.

Region stringOptional

Cloudflare data center / region that handled the request.

RequestID stringOptional

Cloudflare request ID that ties all logs from a single invocation together.

Service stringOptional

Worker script name that produced this event.

SpanID stringOptional

Span ID for this individual unit of work within a trace.

SpanName stringOptional

Human-readable name for this span.

StackID stringOptional

Stack / deployment identifier.

StartTime int64Optional

Span start time as a Unix epoch in milliseconds.

minimum0

StatusCode int64Optional

HTTP response status code returned by the Worker.

exclusiveMinimum

minimum0

TraceDuration int64Optional

Total duration of the entire trace in milliseconds.

exclusiveMinimum

minimum0

TraceID stringOptional

Distributed trace ID linking spans across services.

TransactionName stringOptional

Logical transaction name for this request.

Trigger stringOptional

What triggered the invocation (e.g. GET /users, POST /orders, queue message).

Type stringOptional

Event type classifier (e.g. cf-worker-event, cf-worker-log).

URL stringOptional

Request URL that triggered the Worker invocation.

Dataset string

The dataset this event belongs to (e.g. cloudflare-workers).

Source ObservabilityTelemetryQueryResponseEventsEventsSourceUnion

Raw log payload. May be a string or a structured object depending on how the log was emitted.

One of the following:

UnionString

type ObservabilityTelemetryQueryResponseEventsEventsSourceMap map[string, unknown]

Timestamp int64

Event timestamp as a Unix epoch in milliseconds.

minimum0

Containers map[string, unknown]Optional

Cloudflare Containers event information that enriches your logs for identifying and debugging issues.

Workers ObservabilityTelemetryQueryResponseEventsEventsWorkersOptional

Cloudflare Workers event information that enriches your logs for identifying and debugging issues.

One of the following:

type ObservabilityTelemetryQueryResponseEventsEventsWorkersObject struct{…}

EventType ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType

One of the following:

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeFetch ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "fetch"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeScheduled ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "scheduled"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeAlarm ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "alarm"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeCron ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "cron"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeQueue ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "queue"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeEmail ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "email"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeTail ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "tail"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeRpc ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "rpc"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeWebsocket ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "websocket"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeWorkflow ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "workflow"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventTypeUnknown ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectEventType = "unknown"

RequestID string

ScriptName string

DurableObjectID stringOptional

Entrypoint stringOptional

Event map[string, unknown]Optional

ExecutionModel ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectExecutionModelOptional

One of the following:

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectExecutionModelDurableObject ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectExecutionModel = "durableObject"

const ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectExecutionModelStateless ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectExecutionModel = "stateless"

Outcome stringOptional

Preview ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectPreviewOptional

ID stringOptional

Name stringOptional

Slug stringOptional

ScriptVersion ObservabilityTelemetryQueryResponseEventsEventsWorkersObjectScriptVersionOptional

ID stringOptional

Message stringOptional

Tag stringOptional

SpanID stringOptional

TraceID stringOptional

Truncated boolOptional

type ObservabilityTelemetryQueryResponseEventsEventsWorkersObject struct{…}

CPUTimeMs float64