Loki: como Prometheus, pero para logs.

Loki es un sistema de agregación de logs multiinquilino, altamente disponible y escalable horizontalmente, inspirado en Prometheus. Está diseñado para ser muy rentable y fácil de operar. No indexa el contenido de los logs, sino un conjunto de etiquetas para cada flujo de logs.

En comparación con otros sistemas de agregación de logs, Loki:

• no realiza indexación de texto completo sobre los logs. Al almacenar logs no estructurados comprimidos e indexar solo metadatos, Loki es más simple de operar y más barato de ejecutar.
• indexa y agrupa los flujos de logs utilizando las mismas etiquetas que ya usas con Prometheus, lo que te permite alternar sin problemas entre métricas y logs usando las mismas etiquetas que ya usas con Prometheus.
• es especialmente adecuado para almacenar logs de Pods de Kubernetes. Los metadatos, como las etiquetas de los Pods, se recopilan e indexan automáticamente.
• tiene soporte nativo en Grafana (requiere Grafana v6.0).

Una stack de logging basada en Loki consta de 3 componentes:

• Alloy es el agente, encargado de recopilar los logs y enviarlos a Loki.
• Loki es el servicio principal, encargado de almacenar los logs y procesar las consultas.
• Grafana para consultar y visualizar los logs.

Ten en cuenta que Alloy reemplazó a Promtail en la stack, porque Promtail se considera funcionalmente completo y el desarrollo futuro de la recopilación de logs estará en Grafana Alloy.

Loki es como Prometheus, pero para logs: preferimos un enfoque multidimensional basado en etiquetas para la indexación y queremos un sistema de un solo binario, fácil de operar y sin dependencias. Loki se diferencia de Prometheus al centrarse en logs en lugar de métricas y al entregar los logs mediante push, en lugar de pull.

Primeros pasos

• Instalación de Loki
• Instalación de Alloy
• Primeros pasos

⚠️ Migración del Helm Chart

A partir del 16 de marzo de 2026, el Helm chart de Grafana Loki se bifurcará a un nuevo repositorio grafana-community/helm-charts. El chart en el repositorio de Loki continuará manteniéndose solo para usuarios de GEL. Consulta #20705 para más detalles.

Actualización

• Actualización de Loki

Documentación

• Última versión
• Próxima versión, en la punta de la rama principal

Secciones de uso frecuente:

• Documentación de la API para enviar logs a Loki.
• Etiquetas
• Operaciones
• Cliente Docker Driver es un plugin de Docker para enviar logs directamente a Loki desde contenedores Docker.
• LogCLI proporciona una interfaz de línea de comandos para consultar logs.
• Loki Canary supervisa tu instalación de Loki en busca de logs faltantes.
• Solución de problemas ofrece ayuda para lidiar con mensajes de error.
• Loki en Grafana describe cómo configurar una fuente de datos de Loki en Grafana.

Obtener ayuda

Si tienes alguna pregunta o comentario sobre Loki:

• Busca hilos existentes en el foro de la comunidad de Grafana Labs para Loki: https://community.grafana.com
• Haz una pregunta en el canal de Slack de Loki. Para invitarte al Slack de Grafana, visita https://slack.grafana.com/ y únete al canal #loki.
• Abre un issue para errores, problemas y sugerencias de funcionalidades.
• Envía un correo electrónico a [email protected], o utiliza la interfaz web.
• Los problemas de interfaz de usuario deben registrarse directamente en Grafana.

Tus comentarios siempre son bienvenidos.

Lecturas adicionales

• El documento de diseño original de Loki es una buena fuente para discutir la motivación y las decisiones de diseño.
• La charla de Callum Styan en DevOpsDays Vancouver de marzo de 2019 "Grafana Loki: Log Aggregation for Incident Investigations".
• Entrada de blog de Grafana Labs "How We Designed Loki to Work Easily Both as Microservices and as Monoliths".
• La charla de Tom Wilkie a principios de 2019 en CNCF París/FOSDEM "Grafana Loki: like Prometheus, but for logs" (diapositivas, vídeo).
• La charla de David Kaltschmidt en KubeCon 2018 "On the OSS Path to Full Observability with Grafana" (diapositivas, vídeo) sobre cómo encaja Loki en un entorno nativo de la nube.
• Entrada de blog de Goutham Veeramachaneni "Loki: Prometheus-inspired, open source logging for cloud natives" sobre los detalles de la arquitectura de Loki.
• Entrada de blog de David Kaltschmidt "Closer look at Grafana's user interface for Loki" sobre las ideas que dieron forma a la interfaz de usuario de logging.

Contribuciones

Consulta CONTRIBUTING.md

Compilación desde el código fuente

Loki se puede ejecutar en un solo host, en modo sin dependencias, utilizando los siguientes comandos.

Necesitas una versión actualizada de Go; recomendamos usar la versión que se encuentra en nuestro Makefile

# Checkout source code
$ git clone https://github.com/grafana/loki
$ cd loki

# Build binary
$ go build ./cmd/loki

# Run executable
$ ./loki -config.file=./cmd/loki/loki-local-config.yaml

Alternativamente, en sistemas Unix puedes usar make para compilar el binario, lo que añade argumentos adicionales al comando go build.

# Build binary
$ make loki

# Run executable
$ ./cmd/loki/loki -config.file=./cmd/loki/loki-local-config.yaml

Para ejecutar varios inquilinos de Loki localmente, asegúrate de que auth_enabled esté establecido en true y proporciona una configuración de runtime con cualquier anulación específica del inquilino.

# Build binary
$ make loki

# Run executable
./loki -config.file=./cmd/loki/loki-local-multi-tenant-config.yaml -runtime-config.file=./cmd/loki/loki-overrides.yaml

Adoptantes

Consulta ADOPTERS.md para ver algunas de las organizaciones que utilizan Loki hoy en día. Si deseas añadir tu organización a la lista, abre un PR para agregarla.

Licencia

Grafana Loki se distribuye bajo AGPL-3.0-only. Para excepciones de Apache-2.0, consulta LICENSING.md.