Returns a paginated list of tags (both correlation and metric kinds)
defined across the tenant's datasets. Each entry groups all per-dataset
definitions of a single (name, kind) pair.
Use GET /v1/tags/values to search tag values.
Filtering and ordering with CEL
The filter and orderBy query parameters are evaluated as
Common Expression Language (CEL) expressions over
each tag in the response.
Available CEL fields
name(string) — tag name; supports.matches("regex")kind(string) —"Correlation"or"Metric"datasetCount(int) — number of distinct datasets defining the tagmappings(list) — per-dataset definitions; supports.exists(m, ...)
quantifier. Eachmexposes:m.dataset.id(int) — dataset idm.dataset.label(string) — dataset label (available without
expand); matches thedataset.record.labelreturned in the bodym.path.field(string)m.path.path(string)m.origin.id(int, null for Metric) — dataset where the mapping
was originally declared. Equalsm.dataset.idwhen declared
directly on that dataset; differs when inherited from upstream.m.origin.label(string, null for Metric) — label of the origin
dataset; guard withm.origin != nullbefore accessing.m.createdBy.id(int, null for Metric)
Available CEL functions
The tag CEL environment registers the CEL standard
definitions
(operators, in, ?:, size(), string.contains, string.startsWith,
string.endsWith, matches, etc.) plus the following extension
libraries from
cel-go v0.28.0:
ext.Strings—charAt,indexOf,join,lowerAscii,replace,split,substring,trim,upperAscii,formatext.Lists—lists.flatten,lists.range,lists.sliceext.Math—math.greatest,math.leastext.Sets—sets.contains,sets.equivalent,sets.intersectsext.Regex—re.capture,re.extractext.Encoders—base64.encode,base64.decodeext.Bindings—cel.bindfor let-binding sub-expressionsext.Protos— protobuf helperscel.OptionalTypes—optional.of,optional.ofNonZero,optional.none
Defaults
- Default page size: 50; maximum: 100.
- Default order:
kindascending, thennameascending.
Set expand=true to inline the dataset.record brief (label,
description, iconUrl, contentType) on every dataset reference.
Set sampleValues=true to attach a bounded sample of each tag's
values (see the sampleValues parameter).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||