Qué hacer cuando Loki se hunde por labels con demasiada cardinalidad

Diagnóstico, mitigaciones en el pipeline de ingestión y pasos para validar sin perder contexto operativo

Guía práctica para detectar y arreglar problemas de alta cardinalidad en labels que degradan o bloquean Loki: síntomas operativos, métricas y logs a revisar, cambios seguros en Promtail/ingest pipelines y comprobaciones de validación.

Creada: 13 de abril de 2026

Publicada: 13 de abril de 2026

Tiempo estimado60 min

NivelAvanzado

Antes de empezarAcceso a métricas de Loki (endpoint /metrics) y a sus logs

PlataformasDocker / Linux

WhatsApp X LinkedIn

Docker

Pasos y comandos seguros para diagnosticar Loki en contenedores Docker (docker-compose o docker run).

docker CLI funcional y permiso para inspeccionar contenedoresloki expuesto en localhost:3100 o puerto accesible

Ver logs del contenedor Loki (no destructivo)

docker-compose logs --no-color loki | tail -n 200

Extraer métricas y filtrar métricas de ingester y querier

docker exec loki-container curl -s http://127.0.0.1:3100/metrics | egrep 'loki_ingester|http_request_duration_seconds'

Listar etiquetas activas vía API (muestreo, no traer todas si hay muchísimas)

curl -s 'http://127.0.0.1:3100/loki/api/v1/labels?limit=200' | head -n 200

Leer también enWhat to do when Loki sinks from label cardinality explosion

Contenido bloqueado

Esta guía requiere completar ambos pasos para leer el contenido completo.

○Dale a “Me gusta” en la guía.
○Comparte en WhatsApp, X, LinkedIn o copia el enlace.

Cuando se cumplan ambos pasos, el acceso se desbloquea automáticamente.