Manage Operation Pattern Rules (Private BETA)

Get an Operation Pattern Rule by origin or ID

get/api/operation-pattern-rules/{originOrId}

Returns a specific Operation Pattern Rule, identified either by its server-generated dash0.com/id or its client-chosen dash0.com/origin.

Parameters 2

originOrIdpathrequired

The Operation Pattern Rule's dash0.com/origin or dash0.com/id.

string

datasetqueryrequired

The dataset the Pattern Rule belongs to.

References Dataset

Optional dataset to query across. Defaults to whatever is configured to be the default dataset for the organization.

stringpattern "^[a-zA-Z0-9_-]{3,26}$"

bash

Sample request12
curl --request GET 'https://api.eu-west-1.aws.dash0.com/api/operation-pattern-rules/123e4567-e89b-42d3-a456-426614174000?dataset=default' \
  --header "Authorization: Bearer ${DASH0_AUTH_TOKEN}"

Server

Responses

The requested Operation Pattern Rule

References OperationPatternRuleResponse

References OperationPatternRuleDefinition

A Pattern Rule abstracts a high-cardinality span operation name (e.g. /users/1234) into a templated one (e.g. /users/<userId>), so the collector's Operation Processor can collapse matching operation names together. Rows are either authored by a human through this API (spec.ownership: user_defined) or inferred by the Operation Miner (spec.ownership: auto_derived).

Unlike most CRD-enveloped resources in this API, Pattern Rules have no independent, user-editable display name, versioning, folder, or sharing concept -- metadata.name is server-computed (see below). They are addressable either by their server-generated metadata.labels["dash0.com/id"] or by metadata.labels["dash0.com/origin"] (an IaC/Terraform-style stable label) -- see {originOrId} on each path below. metadata.labels["dash0.com/dataset"]/spec.serviceNamespace/spec.serviceName identify the partition (dataset + service) a rule belongs to, and are immutable once the rule is created.

stringrequired

"Dash0OperationPatternRule"

OperationPatternRuleMetadatarequired

OperationPatternRuleSpecrequired