Back to guidesGuide

What to do when Loki sinks from label cardinality explosion

Practical troubleshooting: symptoms, redesigning labels and ingestion pipelines without losing useful context

Actionable guide to detect and fix high-cardinality labels that degrade or crash Loki: symptoms, metrics and logs to inspect, safe Promtail/ingest changes and validation steps.

Created: April 13, 2026

Published: April 13, 2026

Estimated time60 min
LevelAdvanced
Before you startAccess to Loki metrics (/metrics) and Loki logs
PlatformsDocker / Linux
WhatsAppXLinkedIn

Docker

Safe diagnostics and commands for Loki running in Docker (docker-compose or docker run).

docker CLI and permission to inspect containersloki reachable on localhost:3100 or via exposed port
View Loki container logs (non-destructive)
docker-compose logs --no-color loki | tail -n 200
Fetch metrics and filter ingester/querier metrics
docker exec loki-container curl -s http://127.0.0.1:3100/metrics | egrep 'loki_ingester|http_request_duration_seconds'
List active labels via API (sample, avoid full dump)
curl -s 'http://127.0.0.1:3100/loki/api/v1/labels?limit=200' | head -n 200

Content locked

This guide requires both steps before full content is available.

  • Click “Like” on this guide.
  • Share on WhatsApp, X, LinkedIn, or copy the link.

Access is automatically unlocked as soon as both steps are completed.