Repolode
Enviar
grafana

grafana/loki

Sistema de agregação de logs multi-tenant e horizontalmente escalável que indexa apenas labels, não o conteúdo dos logs, da Grafana Labs.

Alternativa open source a:SplunkDatadog Logs

Ver no GitHubSite
Estrelas
29,048
Forks
4,146
Issues abertas
1,139
Último commit
há 9 horas

O que é?

Loki é um sistema de agregação de logs inspirado no Prometheus. Em vez de indexar o texto completo de cada linha de log, ele armazena logs não estruturados e compactados e indexa apenas um conjunto de labels para cada fluxo de logs. Isso reduz os custos de armazenamento e operação e permite consultar logs com o mesmo modelo de labels usado nas métricas do Prometheus.

Uma stack de logging baseada no Loki geralmente combina três componentes: Alloy, que coleta logs e os envia ao Loki; o próprio Loki, que armazena os logs e processa consultas; e Grafana, usada para consultar e exibir esses logs. O Loki recebe logs por push, em vez de pull, e pode ser executado como um único binário, sem dependências externas. Ele também é uma boa opção para logs de Pods no Kubernetes, já que metadados dos Pods, como labels, podem ser coletados e indexados automaticamente.

O projeto oferece a ferramenta de linha de comando LogCLI para consultar logs, o Loki Canary para detectar logs ausentes e um plugin de logging para Docker que envia logs de containers diretamente ao Loki. Ele oferece suporte à operação multi-tenant quando a autenticação está habilitada.

Recursos principais

  • 01Indexa apenas os conjuntos de labels de cada fluxo de logs, em vez do texto completo dos logs.
  • 02Usa o mesmo modelo de labels do Prometheus, facilitando a transição entre métricas e logs.
  • 03Pode ser executado como um único binário, sem dependências, ou como microsserviços horizontalmente escaláveis.
  • 04Oferece suporte a implantações multi-tenant com substituições de configuração em tempo de execução por tenant.
  • 05Inclui o LogCLI para consultas e o Loki Canary para detectar logs ausentes.
  • 06Oferece um plugin para Docker que envia logs de containers diretamente ao Loki.

Casos de uso

  • Coletar e consultar logs de Pods do Kubernetes usando labels dos metadados dos Pods.
  • Montar uma stack centralizada de logging com custos controlados e dashboards do Grafana.
  • Correlacionar logs de aplicações com métricas do Prometheus usando labels compartilhadas.
  • Executar uma plataforma de logs multi-tenant que mantém separados os logs de diferentes equipes.

Início rápido

  1. 1

    Clone o repositório do código-fonte

    git clone https://github.com/grafana/loki
  2. 2

    Entre no diretório do projeto

    cd loki
  3. 3

    Compile o binário do Loki com Go

    go build ./cmd/loki
  4. 4

    Execute o Loki com o arquivo de configuração local

    ./loki -config.file=./cmd/loki/loki-local-config.yaml

Antes de usar

  • É necessário ter uma toolchain do Go atualizada para compilar a partir do código-fonte.
  • A manutenção do chart do Helm para quem não usa GEL está sendo transferida para um repositório separado.

Tópicos

#logging#observability#prometheus#kubernetes#log-aggregation#grafana#time-series#cloudnative#hacktoberfest#loki

Perguntas frequentes

O que é loki?
Sistema de agregação de logs multi-tenant e horizontalmente escalável que indexa apenas labels, não o conteúdo dos logs, da Grafana Labs. Loki é um sistema de agregação de logs inspirado no Prometheus. Em vez de indexar o texto completo de cada linha de log, ele armazena logs não estruturados e compactados e indexa apenas um conjunto de labels para cada fluxo de logs. Isso reduz os custos de armazenamento e operação e permite consultar logs com o mesmo modelo de labels usado nas métricas do Prometheus.
loki é gratuito? Qual é a licença?
loki é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
loki ainda é mantido?
Manutenção ativa. O último commit de loki foi em 21 de out. de 2026.
Para que posso usar loki?
Coletar e consultar logs de Pods do Kubernetes usando labels dos metadados dos Pods. Montar uma stack centralizada de logging com custos controlados e dashboards do Grafana. Correlacionar logs de aplicações com métricas do Prometheus usando labels compartilhadas. Executar uma plataforma de logs multi-tenant que mantém separados os logs de diferentes equipes.
Como instalar loki?
Clone o repositório do código-fonte: git clone https://github.com/grafana/loki Entre no diretório do projeto: cd loki Compile o binário do Loki com Go: go build ./cmd/loki Execute o Loki com o arquivo de configuração local: ./loki -config.file=./cmd/loki/loki-local-config.yaml
Onde consigo loki?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/grafana/loki

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados