Documentation Grafana Cloud Adaptive Telemetry Adaptive Traces Reference Policy types

Policy types

Here are the available policy types and their definitions. For more information on each of the policy types, refer to the Components documentation.

Numeric attribute policy

The numeric_attribute policy samples traces based on the value of a numeric span attribute. You define a key and a range using minimum and maximum values. Any trace with a matching attribute value within that range is sampled.

Example

JSON Copy

{
  "key": "http.response.content_length",
  "min_value": 1000000,
  "max_value": 10000000
}

This policy samples traces where the http.response.content_length attribute is between 1 MB and 10 MB.

Regex matching for string attributes

When using regular expressions (regex) in string attributes, you must explicitly enable regex matching in the configuration.

Set enabled_regex_matching to true for the corresponding attribute block.

Without this option, regex patterns are treated as plain text, and invalid regex syntax may cause errors during evaluation.

Example

Copy

{
  "key": "foo",
  "values": [
    "normal-value",
    "regex-value.*"
  ],
  "enabled_regex_matching": true
}