Cardinality Guardian Processor
OpenTelemetry Collector processor · contrib distribution
An OpenTelemetry Collector processor that catches metric cardinality explosions before they reach your TSDB.
- Component ID:
contrib-cardinalityguardianprocessor - Name:
cardinalityguardianprocessor - Type: processor
- Distribution: contrib
- Repository:
opentelemetry-collector-contrib
Stability
| Level | Signals |
|---|---|
| alpha | metrics |
Internal telemetry
| Metric | Type | Value type | Unit | Stability | Enabled | Attributes | Description |
|---|---|---|---|---|---|---|---|
processor_cardinality_labels.stripped | sum (monotonic) | int | {labels} | development | yes | Total number of high-cardinality labels stripped or tagged. | |
processor_cardinality_savings.estimated | sum (monotonic) | double | {dollars} | development | yes | Cumulative estimated dollar value of time-series churn prevented by the processor. | |
processor_cardinality_top.offenders | gauge | int | {pairs} | development | yes | Cardinality delta of the top-N highest-growth (metric, label) pairs from the last epoch rotation. | |
processor_cardinality_trackers.active | gauge | int | {trackers} | development | yes | Current number of active cardinality trackers across all shards. | |
processor_cardinality_trackers.rejected | sum (monotonic) | int | {trackers} | development | yes | Number of new (metric, label) pairs ignored because max_tracker_count was reached. |