Reliability and observability

Cardinality management

Also known as Cardinality management

By WeavePublished 1 min read

Definition

Cardinality management is control of distinct attribute combinations so telemetry remains queryable and affordable.

What Cardinality management shows

Cardinality management is control of distinct attribute combinations so telemetry remains queryable and affordable. It matters when a team can state the decision the evidence should support, the population being measured, and the time window in which the observation matters. That framing keeps a familiar label from becoming a dashboard tile with no operational meaning. The collection method and owner should be visible whenever the signal is used in a review.

A concrete example

Normalized route and region remain metric labels while raw user ID stays in sampled traces. A useful workflow records relevant context, compares the observation with an appropriate baseline, and follows the evidence to the service or change that may explain it. The signal should start a question rather than close the investigation. Teams should also record what action follows a meaningful change and how the result will be checked.

Limitations and tradeoffs

Removing every high-cardinality field can hide useful slices, while unbounded labels overwhelm storage. Interpret cardinality management alongside related signals and explicit service objectives. Sampling, aggregation, clock behavior, retention, and access policy can all affect what an operator sees. When those details are missing, conclusions should remain provisional and a precise-looking value should not be presented as a complete account of user experience.

How this relates to Weave

Weave can help teams connect engineering delivery evidence with cardinality management questions. It can provide context from code, reviews, releases, and ownership, while the direct cardinality management measurement should remain in the system that collects it. Treat relationships as investigation leads and verify them against service telemetry and user impact.

Explore Engineering intelligence

Sources and further reading

  1. Primary documentation: Cardinality management