Cardinality Protection

TinyOlly includes built-in protection against metric cardinality explosion with a configurable limit on unique metric names.

Configuration

Variable	Default	Description
`MAX_METRIC_CARDINALITY`	1000	Maximum unique metric names
`REDIS_TTL`	1800	Metric retention (seconds)

Update k8s/tinyolly-otlp-receiver.yaml:

env:
  - name: MAX_METRIC_CARDINALITY
    value: "2000"  # Increase limit
  - name: REDIS_TTL
    value: "3600"  # 1 hour retention

Update docker-compose-tinyolly-core.yml in the docker/ directory:

environment:
  MAX_METRIC_CARDINALITY: 2000
  REDIS_TTL: 3600

The UI displays cardinality warnings when approaching the limit: - Yellow Warning: 70-90% of limit reached - Red Alert: 90%+ of limit reached

Check current cardinality via the API:

curl http://localhost:5005/api/stats

Response:

{
  "traces": 145,
  "logs": 892,
  "metrics": 850,
  "metrics_max": 1000,
  "metrics_dropped": 23
}