API Reference

Workers

Observability

Queries

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Save query

client.Workers.Observability.Queries.New(ctx, params) (*ObservabilityQueryNewResponse, error)

POST/accounts/{account_id}/workers/observability/queries

Persist query for later use.

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 ObservabilityQueryNewParams

AccountID param.Field[string]

Path param: Your Cloudflare account ID.

Description param.Field[string]

Body param

maxLength1000

Name param.Field[string]

Body param: Query name

maxLength250

minLength1

Parameters param.Field[ObservabilityQueryNewParamsParameters]

Body param

Calculations []ObservabilityQueryNewParamsParametersCalculationOptional

Create Calculations to compute as part of the query.

Operator ObservabilityQueryNewParamsParametersCalculationsOperator

One of the following:

const ObservabilityQueryNewParamsParametersCalculationsOperatorUniq ObservabilityQueryNewParamsParametersCalculationsOperator = "uniq"

const ObservabilityQueryNewParamsParametersCalculationsOperatorCount ObservabilityQueryNewParamsParametersCalculationsOperator = "count"

const ObservabilityQueryNewParamsParametersCalculationsOperatorMax ObservabilityQueryNewParamsParametersCalculationsOperator = "max"

const ObservabilityQueryNewParamsParametersCalculationsOperatorMin ObservabilityQueryNewParamsParametersCalculationsOperator = "min"

const ObservabilityQueryNewParamsParametersCalculationsOperatorSum ObservabilityQueryNewParamsParametersCalculationsOperator = "sum"

const ObservabilityQueryNewParamsParametersCalculationsOperatorAvg ObservabilityQueryNewParamsParametersCalculationsOperator = "avg"

const ObservabilityQueryNewParamsParametersCalculationsOperatorMedian ObservabilityQueryNewParamsParametersCalculationsOperator = "median"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP001 ObservabilityQueryNewParamsParametersCalculationsOperator = "p001"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP01 ObservabilityQueryNewParamsParametersCalculationsOperator = "p01"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP05 ObservabilityQueryNewParamsParametersCalculationsOperator = "p05"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP10 ObservabilityQueryNewParamsParametersCalculationsOperator = "p10"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP25 ObservabilityQueryNewParamsParametersCalculationsOperator = "p25"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP75 ObservabilityQueryNewParamsParametersCalculationsOperator = "p75"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP90 ObservabilityQueryNewParamsParametersCalculationsOperator = "p90"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP95 ObservabilityQueryNewParamsParametersCalculationsOperator = "p95"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP99 ObservabilityQueryNewParamsParametersCalculationsOperator = "p99"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP999 ObservabilityQueryNewParamsParametersCalculationsOperator = "p999"

const ObservabilityQueryNewParamsParametersCalculationsOperatorStddev ObservabilityQueryNewParamsParametersCalculationsOperator = "stddev"

const ObservabilityQueryNewParamsParametersCalculationsOperatorVariance ObservabilityQueryNewParamsParametersCalculationsOperator = "variance"

const ObservabilityQueryNewParamsParametersCalculationsOperatorCountDistinct ObservabilityQueryNewParamsParametersCalculationsOperator = "COUNT_DISTINCT"

const ObservabilityQueryNewParamsParametersCalculationsOperatorCountUppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "COUNT"

const ObservabilityQueryNewParamsParametersCalculationsOperatorMaxUppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "MAX"

const ObservabilityQueryNewParamsParametersCalculationsOperatorMinUppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "MIN"

const ObservabilityQueryNewParamsParametersCalculationsOperatorSumUppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "SUM"

const ObservabilityQueryNewParamsParametersCalculationsOperatorAvgUppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "AVG"

const ObservabilityQueryNewParamsParametersCalculationsOperatorMedianUppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "MEDIAN"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP001Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P001"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP01Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P01"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP05Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P05"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP10Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P10"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP25Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P25"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP75Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P75"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP90Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P90"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP95Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P95"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP99Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P99"

const ObservabilityQueryNewParamsParametersCalculationsOperatorP999Uppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "P999"

const ObservabilityQueryNewParamsParametersCalculationsOperatorStddevUppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "STDDEV"

const ObservabilityQueryNewParamsParametersCalculationsOperatorVarianceUppercase ObservabilityQueryNewParamsParametersCalculationsOperator = "VARIANCE"

Alias stringOptional

Key stringOptional

KeyType ObservabilityQueryNewParamsParametersCalculationsKeyTypeOptional

One of the following:

const ObservabilityQueryNewParamsParametersCalculationsKeyTypeString ObservabilityQueryNewParamsParametersCalculationsKeyType = "string"

const ObservabilityQueryNewParamsParametersCalculationsKeyTypeNumber ObservabilityQueryNewParamsParametersCalculationsKeyType = "number"

const ObservabilityQueryNewParamsParametersCalculationsKeyTypeBoolean ObservabilityQueryNewParamsParametersCalculationsKeyType = "boolean"

Datasets []stringOptional

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

FilterCombination ObservabilityQueryNewParamsParametersFilterCombinationOptional

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

One of the following:

const ObservabilityQueryNewParamsParametersFilterCombinationAnd ObservabilityQueryNewParamsParametersFilterCombination = "and"

const ObservabilityQueryNewParamsParametersFilterCombinationOr ObservabilityQueryNewParamsParametersFilterCombination = "or"

const ObservabilityQueryNewParamsParametersFilterCombinationAndUppercase ObservabilityQueryNewParamsParametersFilterCombination = "AND"

const ObservabilityQueryNewParamsParametersFilterCombinationOrUppercase ObservabilityQueryNewParamsParametersFilterCombination = "OR"

Filters []ObservabilityQueryNewParamsParametersFilterOptional

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

One of the following:

type ObservabilityQueryNewParamsParametersFiltersObject struct{…}

FilterCombination ObservabilityQueryNewParamsParametersFiltersObjectFilterCombination

One of the following:

const ObservabilityQueryNewParamsParametersFiltersObjectFilterCombinationAnd ObservabilityQueryNewParamsParametersFiltersObjectFilterCombination = "and"

const ObservabilityQueryNewParamsParametersFiltersObjectFilterCombinationOr ObservabilityQueryNewParamsParametersFiltersObjectFilterCombination = "or"

const ObservabilityQueryNewParamsParametersFiltersObjectFilterCombinationAndUppercase ObservabilityQueryNewParamsParametersFiltersObjectFilterCombination = "AND"

const ObservabilityQueryNewParamsParametersFiltersObjectFilterCombinationOrUppercase ObservabilityQueryNewParamsParametersFiltersObjectFilterCombination = "OR"

Filters []unknown

Kind ObservabilityQueryNewParamsParametersFiltersObjectKind

type ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeaf 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 ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation

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 ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationIncludes ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "includes"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotIncludes ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "not_includes"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationStartsWith ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "starts_with"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationEndsWith ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "ends_with"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationRegex ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "regex"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationExists ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "exists"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationIsNull ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "is_null"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationIn ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "in"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotIn ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "not_in"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationEq ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "eq"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNeq ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "neq"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationGt ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "gt"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationGte ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "gte"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationLt ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "lt"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationLte ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "lte"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationEquals ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "="

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotEquals ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "!="

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationGreater ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = ">"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationGreaterOrEquals ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = ">="

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationLess ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "<"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationLessOrEquals ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "<="

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationIncludesUppercase ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "INCLUDES"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotInclude ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_INCLUDE"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationMatchRegex ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "MATCH_REGEX"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationExistsUppercase ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "EXISTS"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotExist ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_EXIST"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationInUppercase ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "IN"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotInUppercase ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "NOT_IN"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationStartsWithUppercase ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "STARTS_WITH"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationEndsWithUppercase ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "ENDS_WITH"

Type ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafType

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

One of the following:

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafTypeString ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafType = "string"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafTypeNumber ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafType = "number"

const ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafTypeBoolean ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafType = "boolean"

Kind ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafKindOptional

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

Value ObservabilityQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafValueUnionOptional

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

GroupBys []ObservabilityQueryNewParamsParametersGroupByOptional

Define how to group the results of the query.

Type ObservabilityQueryNewParamsParametersGroupBysType

One of the following:

const ObservabilityQueryNewParamsParametersGroupBysTypeString ObservabilityQueryNewParamsParametersGroupBysType = "string"

const ObservabilityQueryNewParamsParametersGroupBysTypeNumber ObservabilityQueryNewParamsParametersGroupBysType = "number"

const ObservabilityQueryNewParamsParametersGroupBysTypeBoolean ObservabilityQueryNewParamsParametersGroupBysType = "boolean"

Value string

Havings []ObservabilityQueryNewParamsParametersHavingOptional

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

Key string

Operation ObservabilityQueryNewParamsParametersHavingsOperation

One of the following:

const ObservabilityQueryNewParamsParametersHavingsOperationEq ObservabilityQueryNewParamsParametersHavingsOperation = "eq"

const ObservabilityQueryNewParamsParametersHavingsOperationNeq ObservabilityQueryNewParamsParametersHavingsOperation = "neq"

const ObservabilityQueryNewParamsParametersHavingsOperationGt ObservabilityQueryNewParamsParametersHavingsOperation = "gt"

const ObservabilityQueryNewParamsParametersHavingsOperationGte ObservabilityQueryNewParamsParametersHavingsOperation = "gte"

const ObservabilityQueryNewParamsParametersHavingsOperationLt ObservabilityQueryNewParamsParametersHavingsOperation = "lt"

const ObservabilityQueryNewParamsParametersHavingsOperationLte ObservabilityQueryNewParamsParametersHavingsOperation = "lte"

Value float64

Limit int64Optional

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

maximum100

minimum0

Needle ObservabilityQueryNewParamsParametersNeedleOptional

Define an expression to search using full-text search.

Value ObservabilityQueryNewParamsParametersNeedleValueUnion

maxLength1000

One of the following:

UnionString

UnionFloat

UnionBool

IsRegex boolOptional

MatchCase boolOptional

OrderBy ObservabilityQueryNewParamsParametersOrderByOptional

Configure the order of the results returned by the query.

Value string

Configure which Calculation to order the results by.

Order ObservabilityQueryNewParamsParametersOrderByOrderOptional

Set the order of the results

One of the following:

const ObservabilityQueryNewParamsParametersOrderByOrderAsc ObservabilityQueryNewParamsParametersOrderByOrder = "asc"

const ObservabilityQueryNewParamsParametersOrderByOrderDesc ObservabilityQueryNewParamsParametersOrderByOrder = "desc"

ReturnsExpand Collapse

type ObservabilityQueryNewResponse struct{…}

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 ObservabilityQueryNewResponseParameters

Calculations []ObservabilityQueryNewResponseParametersCalculationOptional

Create Calculations to compute as part of the query.

Operator ObservabilityQueryNewResponseParametersCalculationsOperator

One of the following:

const ObservabilityQueryNewResponseParametersCalculationsOperatorUniq ObservabilityQueryNewResponseParametersCalculationsOperator = "uniq"

const ObservabilityQueryNewResponseParametersCalculationsOperatorCount ObservabilityQueryNewResponseParametersCalculationsOperator = "count"

const ObservabilityQueryNewResponseParametersCalculationsOperatorMax ObservabilityQueryNewResponseParametersCalculationsOperator = "max"

const ObservabilityQueryNewResponseParametersCalculationsOperatorMin ObservabilityQueryNewResponseParametersCalculationsOperator = "min"

const ObservabilityQueryNewResponseParametersCalculationsOperatorSum ObservabilityQueryNewResponseParametersCalculationsOperator = "sum"

const ObservabilityQueryNewResponseParametersCalculationsOperatorAvg ObservabilityQueryNewResponseParametersCalculationsOperator = "avg"

const ObservabilityQueryNewResponseParametersCalculationsOperatorMedian ObservabilityQueryNewResponseParametersCalculationsOperator = "median"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP001 ObservabilityQueryNewResponseParametersCalculationsOperator = "p001"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP01 ObservabilityQueryNewResponseParametersCalculationsOperator = "p01"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP05 ObservabilityQueryNewResponseParametersCalculationsOperator = "p05"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP10 ObservabilityQueryNewResponseParametersCalculationsOperator = "p10"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP25 ObservabilityQueryNewResponseParametersCalculationsOperator = "p25"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP75 ObservabilityQueryNewResponseParametersCalculationsOperator = "p75"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP90 ObservabilityQueryNewResponseParametersCalculationsOperator = "p90"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP95 ObservabilityQueryNewResponseParametersCalculationsOperator = "p95"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP99 ObservabilityQueryNewResponseParametersCalculationsOperator = "p99"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP999 ObservabilityQueryNewResponseParametersCalculationsOperator = "p999"

const ObservabilityQueryNewResponseParametersCalculationsOperatorStddev ObservabilityQueryNewResponseParametersCalculationsOperator = "stddev"

const ObservabilityQueryNewResponseParametersCalculationsOperatorVariance ObservabilityQueryNewResponseParametersCalculationsOperator = "variance"

const ObservabilityQueryNewResponseParametersCalculationsOperatorCountDistinct ObservabilityQueryNewResponseParametersCalculationsOperator = "COUNT_DISTINCT"

const ObservabilityQueryNewResponseParametersCalculationsOperatorCountUppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "COUNT"

const ObservabilityQueryNewResponseParametersCalculationsOperatorMaxUppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "MAX"

const ObservabilityQueryNewResponseParametersCalculationsOperatorMinUppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "MIN"

const ObservabilityQueryNewResponseParametersCalculationsOperatorSumUppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "SUM"

const ObservabilityQueryNewResponseParametersCalculationsOperatorAvgUppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "AVG"

const ObservabilityQueryNewResponseParametersCalculationsOperatorMedianUppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "MEDIAN"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP001Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P001"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP01Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P01"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP05Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P05"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP10Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P10"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP25Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P25"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP75Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P75"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP90Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P90"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP95Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P95"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP99Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P99"

const ObservabilityQueryNewResponseParametersCalculationsOperatorP999Uppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "P999"

const ObservabilityQueryNewResponseParametersCalculationsOperatorStddevUppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "STDDEV"

const ObservabilityQueryNewResponseParametersCalculationsOperatorVarianceUppercase ObservabilityQueryNewResponseParametersCalculationsOperator = "VARIANCE"

Alias stringOptional

Key stringOptional

KeyType ObservabilityQueryNewResponseParametersCalculationsKeyTypeOptional

One of the following:

const ObservabilityQueryNewResponseParametersCalculationsKeyTypeString ObservabilityQueryNewResponseParametersCalculationsKeyType = "string"

const ObservabilityQueryNewResponseParametersCalculationsKeyTypeNumber ObservabilityQueryNewResponseParametersCalculationsKeyType = "number"

const ObservabilityQueryNewResponseParametersCalculationsKeyTypeBoolean ObservabilityQueryNewResponseParametersCalculationsKeyType = "boolean"

Datasets []stringOptional

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

FilterCombination ObservabilityQueryNewResponseParametersFilterCombinationOptional

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

One of the following:

const ObservabilityQueryNewResponseParametersFilterCombinationAnd ObservabilityQueryNewResponseParametersFilterCombination = "and"

const ObservabilityQueryNewResponseParametersFilterCombinationOr ObservabilityQueryNewResponseParametersFilterCombination = "or"

const ObservabilityQueryNewResponseParametersFilterCombinationAndUppercase ObservabilityQueryNewResponseParametersFilterCombination = "AND"

const ObservabilityQueryNewResponseParametersFilterCombinationOrUppercase ObservabilityQueryNewResponseParametersFilterCombination = "OR"

Filters []ObservabilityQueryNewResponseParametersFilterOptional

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

One of the following:

type ObservabilityQueryNewResponseParametersFiltersObject struct{…}

FilterCombination ObservabilityQueryNewResponseParametersFiltersObjectFilterCombination

One of the following:

const ObservabilityQueryNewResponseParametersFiltersObjectFilterCombinationAnd ObservabilityQueryNewResponseParametersFiltersObjectFilterCombination = "and"

const ObservabilityQueryNewResponseParametersFiltersObjectFilterCombinationOr ObservabilityQueryNewResponseParametersFiltersObjectFilterCombination = "or"

const ObservabilityQueryNewResponseParametersFiltersObjectFilterCombinationAndUppercase ObservabilityQueryNewResponseParametersFiltersObjectFilterCombination = "AND"

const ObservabilityQueryNewResponseParametersFiltersObjectFilterCombinationOrUppercase ObservabilityQueryNewResponseParametersFiltersObjectFilterCombination = "OR"

Filters []unknown

Kind ObservabilityQueryNewResponseParametersFiltersObjectKind

type ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeaf 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 ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation

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 ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationIncludes ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "includes"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationNotIncludes ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "not_includes"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationStartsWith ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "starts_with"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationEndsWith ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "ends_with"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationRegex ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "regex"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationExists ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "exists"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationIsNull ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "is_null"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationIn ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "in"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationNotIn ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "not_in"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationEq ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "eq"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationNeq ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "neq"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationGt ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "gt"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationGte ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "gte"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationLt ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "lt"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationLte ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "lte"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationEquals ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "="

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationNotEquals ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "!="

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationGreater ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = ">"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationGreaterOrEquals ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = ">="

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationLess ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "<"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationLessOrEquals ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "<="

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationIncludesUppercase ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "INCLUDES"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotInclude ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_INCLUDE"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationMatchRegex ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "MATCH_REGEX"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationExistsUppercase ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "EXISTS"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotExist ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES_NOT_EXIST"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationInUppercase ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "IN"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationNotInUppercase ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "NOT_IN"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationStartsWithUppercase ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "STARTS_WITH"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperationEndsWithUppercase ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafOperation = "ENDS_WITH"

Type ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafType

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

One of the following:

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafTypeString ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafType = "string"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafTypeNumber ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafType = "number"

const ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafTypeBoolean ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafType = "boolean"

Kind ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafKindOptional

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

Value ObservabilityQueryNewResponseParametersFiltersWorkersObservabilityFilterLeafValueUnionOptional

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

GroupBys []ObservabilityQueryNewResponseParametersGroupByOptional

Define how to group the results of the query.

Type ObservabilityQueryNewResponseParametersGroupBysType

One of the following:

const ObservabilityQueryNewResponseParametersGroupBysTypeString ObservabilityQueryNewResponseParametersGroupBysType = "string"

const ObservabilityQueryNewResponseParametersGroupBysTypeNumber ObservabilityQueryNewResponseParametersGroupBysType = "number"

const ObservabilityQueryNewResponseParametersGroupBysTypeBoolean ObservabilityQueryNewResponseParametersGroupBysType = "boolean"

Value string

Havings []ObservabilityQueryNewResponseParametersHavingOptional

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

Key string

Operation ObservabilityQueryNewResponseParametersHavingsOperation

One of the following:

const ObservabilityQueryNewResponseParametersHavingsOperationEq ObservabilityQueryNewResponseParametersHavingsOperation = "eq"

const ObservabilityQueryNewResponseParametersHavingsOperationNeq ObservabilityQueryNewResponseParametersHavingsOperation = "neq"

const ObservabilityQueryNewResponseParametersHavingsOperationGt ObservabilityQueryNewResponseParametersHavingsOperation = "gt"

const ObservabilityQueryNewResponseParametersHavingsOperationGte ObservabilityQueryNewResponseParametersHavingsOperation = "gte"

const ObservabilityQueryNewResponseParametersHavingsOperationLt ObservabilityQueryNewResponseParametersHavingsOperation = "lt"

const ObservabilityQueryNewResponseParametersHavingsOperationLte ObservabilityQueryNewResponseParametersHavingsOperation = "lte"

Value float64

Limit int64Optional

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

maximum100

minimum0

Needle ObservabilityQueryNewResponseParametersNeedleOptional

Define an expression to search using full-text search.

Value ObservabilityQueryNewResponseParametersNeedleValueUnion

maxLength1000

One of the following:

UnionString

UnionFloat

UnionBool

IsRegex boolOptional

MatchCase boolOptional

OrderBy ObservabilityQueryNewResponseParametersOrderByOptional

Configure the order of the results returned by the query.

Value string

Configure which Calculation to order the results by.

Order ObservabilityQueryNewResponseParametersOrderByOrderOptional

Set the order of the results

One of the following:

const ObservabilityQueryNewResponseParametersOrderByOrderAsc ObservabilityQueryNewResponseParametersOrderByOrder = "asc"

const ObservabilityQueryNewResponseParametersOrderByOrderDesc ObservabilityQueryNewResponseParametersOrderByOrder = "desc"

Updated string

UpdatedBy string

Save query

Go

HTTP

TypeScript

Python

Go

Terraform

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/option"
  "github.com/stainless-sdks/cloudflare-go/workers"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"),
    option.WithAPIEmail("user@example.com"),
  )
  query, err := client.Workers.Observability.Queries.New(context.TODO(), workers.ObservabilityQueryNewParams{
    AccountID: cloudflare.F("account_id"),
    Description: cloudflare.F("Query description"),
    Name: cloudflare.F("x"),
    Parameters: cloudflare.F(workers.ObservabilityQueryNewParamsParameters{

    }),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", query.ID)
}

200 example

{
  "errors": [
    {
      "message": "message"
    }
  ],
  "messages": [
    {
      "message": "Successful request"
    }
  ],
  "result": {
    "id": "id",
    "adhoc": true,
    "created": "created",
    "createdBy": "createdBy",
    "description": "Query description",
    "name": "x",
    "parameters": {
      "calculations": [
        {
          "operator": "uniq",
          "alias": "alias",
          "key": "key",
          "keyType": "string"
        }
      ],
      "datasets": [
        "string"
      ],
      "filterCombination": "and",
      "filters": [
        {
          "filterCombination": "and",
          "filters": [
            {}
          ],
          "kind": "group"
        }
      ],
      "groupBys": [
        {
          "type": "string",
          "value": "value"
        }
      ],
      "havings": [
        {
          "key": "key",
          "operation": "eq",
          "value": 0
        }
      ],
      "limit": 0,
      "needle": {
        "value": "string",
        "isRegex": true,
        "matchCase": true
      },
      "orderBy": {
        "value": "value",
        "order": "asc"
      }
    },
    "updated": "updated",
    "updatedBy": "updatedBy"
  },
  "success": true
}

Returns Examples

200 example

{
  "errors": [
    {
      "message": "message"
    }
  ],
  "messages": [
    {
      "message": "Successful request"
    }
  ],
  "result": {
    "id": "id",
    "adhoc": true,
    "created": "created",
    "createdBy": "createdBy",
    "description": "Query description",
    "name": "x",
    "parameters": {
      "calculations": [
        {
          "operator": "uniq",
          "alias": "alias",
          "key": "key",
          "keyType": "string"
        }
      ],
      "datasets": [
        "string"
      ],
      "filterCombination": "and",
      "filters": [
        {
          "filterCombination": "and",
          "filters": [
            {}
          ],
          "kind": "group"
        }
      ],
      "groupBys": [
        {
          "type": "string",
          "value": "value"
        }
      ],
      "havings": [
        {
          "key": "key",
          "operation": "eq",
          "value": 0
        }
      ],
      "limit": 0,
      "needle": {
        "value": "string",
        "isRegex": true,
        "matchCase": true
      },
      "orderBy": {
        "value": "value",
        "order": "asc"
      }
    },
    "updated": "updated",
    "updatedBy": "updatedBy"
  },
  "success": true
}