Loki: como Prometheus, mas para logs.

Loki é um sistema de agregação de logs multi-tenant, altamente disponível e escalável horizontalmente, inspirado no Prometheus. Ele foi projetado para ser muito econômico e fácil de operar. Ele não indexa o conteúdo dos logs, mas sim um conjunto de labels para cada stream de logs.

Em comparação com outros sistemas de agregação de logs, o Loki:

• não faz indexação de texto completo nos logs. Ao armazenar logs não estruturados e compactados e indexar apenas metadados, o Loki é mais simples de operar e mais barato de executar.
• indexa e agrupa streams de logs usando os mesmos labels que você já usa com o Prometheus, permitindo que você alterne perfeitamente entre métricas e logs usando os mesmos labels que você já usa com o Prometheus.
• é especialmente adequado para armazenar logs de Pods do Kubernetes. Metadados como labels de Pods são automaticamente coletados e indexados.
• tem suporte nativo no Grafana (requer Grafana v6.0).

Uma stack de logging baseada em Loki consiste em 3 componentes:

• Alloy é o agente, responsável por coletar logs e enviá-los ao Loki.
• Loki é o serviço principal, responsável por armazenar logs e processar consultas.
• Grafana para consultar e exibir os logs.

Observe que o Alloy substituiu o Promtail na stack, porque o Promtail é considerado completo em termos de funcionalidades, e o desenvolvimento futuro para coleta de logs será no Grafana Alloy.

Loki é como o Prometheus, mas para logs: preferimos uma abordagem multidimensional baseada em labels para indexação e queremos um sistema de binário único, fácil de operar e sem dependências. O Loki difere do Prometheus por focar em logs em vez de métricas e por entregar logs via push, em vez de pull.

Primeiros passos

• Instalando o Loki
• Instalando o Alloy
• Introdução

⚠️ Migração do Helm Chart

A partir de 16 de março de 2026, o Helm chart do Grafana Loki será bifurcado (fork) para um novo repositório grafana-community/helm-charts. O chart no repositório do Loki continuará sendo mantido apenas para usuários do GEL. Consulte #20705 para obter detalhes.

Atualização

• Atualizando o Loki

Documentação

• Última versão
• Próxima versão, na ponta do branch principal

Seções de uso comum:

• Documentação da API para enviar logs ao Loki.
• Labels
• Operações
• Docker Driver Client é um plugin do Docker para enviar logs diretamente ao Loki a partir de contêineres Docker.
• LogCLI fornece uma interface de linha de comando para consultar logs.
• Loki Canary monitora sua instalação do Loki em busca de logs ausentes.
• Solução de problemas apresenta ajuda para lidar com mensagens de erro.
• Loki no Grafana descreve como configurar uma fonte de dados do Loki no Grafana.

Obtendo Ajuda

Se você tiver alguma dúvida ou feedback sobre o Loki:

• Procure em tópicos existentes no fórum da comunidade Grafana Labs sobre o Loki: https://community.grafana.com
• Faça uma pergunta no canal do Loki no Slack. Para se convidar para o Slack da Grafana, visite https://slack.grafana.com/ e entre no canal #loki.
• Abra uma issue para bugs, problemas e sugestões de funcionalidades.
• Envie um e-mail para [email protected] ou use a interface web.
• Problemas de interface (UI) devem ser registrados diretamente no Grafana.

Seu feedback é sempre bem-vindo.

Leitura Complementar

• O documento de design original do Loki é uma boa fonte para discutir a motivação e as decisões de design.
• A palestra de Callum Styan no DevOpsDays Vancouver em março de 2019, "Grafana Loki: Agregação de Logs para Investigações de Incidentes".
• Postagem do blog da Grafana Labs, "Como projetamos o Loki para funcionar facilmente tanto como microsserviços quanto como monólitos".
• A palestra de Tom Wilkie no início de 2019 na CNCF Paris/FOSDEM, "Grafana Loki: como Prometheus, mas para logs" (slides, vídeo).
• A palestra de David Kaltschmidt no KubeCon 2018, "No caminho OSS para a observabilidade total com Grafana" (slides, vídeo), sobre como o Loki se encaixa em um ambiente cloud-native.
• Postagem do blog de Goutham Veeramachaneni, "Loki: logging open source inspirado no Prometheus para nativos de nuvem", com detalhes da arquitetura do Loki.
• Postagem do blog de David Kaltschmidt, "Uma análise mais detalhada da interface do Grafana para o Loki", sobre as ideias que deram origem à interface de usuário de logs.

Contribuindo

Consulte CONTRIBUTING.md

Compilando a partir do código-fonte

O Loki pode ser executado em um único host, sem dependências, usando os seguintes comandos.

Você precisa de uma versão atualizada do Go; recomendamos usar a versão encontrada em nosso 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, em sistemas Unix, você pode usar make para compilar o binário, o que adiciona argumentos extras ao comando go build.

# Build binary
$ make loki

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

Para executar vários tenants do Loki localmente, certifique-se de que auth_enabled esteja definido como true e forneça uma configuração de runtime com quaisquer overrides específicos do tenant.

# 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

Adotantes

Consulte ADOPTERS.md para ver algumas das organizações que usam o Loki atualmente. Se você quiser adicionar sua organização à lista, abra um PR para incluí-la.

Licença

O Grafana Loki é distribuído sob a licença AGPL-3.0-only. Para exceções do Apache-2.0, consulte LICENSING.md.