Observabilidade: Explicando os componentes do Grafana Loki distribuído

Olá, pessoal! Hoje vamos mergulhar no universo da observabilidade e entender como uma ferramenta sensacional chamada Loki pode simplificar (e muito!) a forma como lidamos com logs. Se você já se sentiu meio perdido na montanha de informações que seus sistemas geram, este artigo é para você. E para tornar tudo mais claro, vamos usar uma analogia que todo mundo entende: um condomínio!

O Porteiro, o Zelador e o Depósito: Entendendo o Fluxo dos Logs

Imagina só a vida de um log dentro do seu sistema. Ele não aparece do nada e se materializa num dashboard bonito, certo?

Existe um fluxo, um caminho que ele percorre, e o Loki tem componentes que simulam perfeitamente essa jornada.

Primeiro, temos o nosso…Porteiro! — o Distributor.

Pensa bem: quando uma encomenda (um log, nesse caso) chega no condomínio, o porteiro não guarda nada, ele só olha o endereço e direciona para o bloco e apartamento certos. No Loki, o Distributor faz exatamente isso: ele recebe os logs e os distribui para os “inquilinos” corretos, que chamamos de Ingesters. Ele é o primeiro ponto de contato, garantindo que cada log vá para o seu devido lugar.

Em seguida, entra em cena o: Zelador, nosso querido Ingester.

O Seu Pedro Zelador, que guarda as caixas na salinha do condomínio por um tempinho? Se a Dona Maria não está em casa, ele segura a entrega até alguém buscar ou até levar para o depósito maior. O Ingester no Loki age de forma similar, segurando temporariamente os logs na memória antes de enviá-los para o armazenamento definitivo. Ele é crucial para garantir que nenhum log se perca no caminho antes de chegar ao seu destino final.

E qual é esse destino final? O Depósito.

Nosso **Object Storage.** É como aquele depósito no subsolo do condomínio, onde só o zelador e a administração têm acesso, e onde ficam guardados os registros antigos, tipo caixas, papéis e documentos. No mundo do Loki, o Object Storage é o responsável pelo armazenamento durável dos logs, guardando os dados antigos de forma segura e acessível. Pense nele como a sua biblioteca histórica de eventos do sistema.

Os Fofoqueiros e a Administração: Acessando e Gerenciando Informações

Agora que os logs estão guardados, como fazemos para encontrá-los e tirar proveito deles? É aí que entram os próximos personagens da nossa história.

Conhece aquele…

**Vizinho Fofoqueiro?** Aquele que sempre quer saber “quem recebeu aquela pizza ontem às 23h?” ou “quem deixou a luz do hall acesa?”. Ele faz as perguntas e quer respostas rápidas.

Esse é o nosso **Querier.** No Loki, o Querier é o responsável por executar as queries, ou seja, as suas perguntas, para buscar os logs que você precisa. Ele é o motor por trás da sua busca por informações.

Mas para as coisas não virarem uma bagunça de fofocas soltas, precisamos de uma boa organização. E quem faz isso?

**A Administradora, a Querier**:Frontend. Pensa na Lanay, que recebe todas as reclamações, dúvidas e pedidos, e organiza tudo: “isso vai para o síndico, isso o zelador responde, isso eu já sei e te respondo agora”. A Querier = Frontend gerencia as queries e trabalha para melhorar a performance do sistema. Ela garante que suas buscas sejam eficientes e que você obtenha as respostas rapidamente.

### O Livro da Portaria e o Síndico: A Otimização por Trás das Cenas

Para que tudo funcione de forma fluida, há componentes essenciais que trabalham nos bastidores.

Um dos mais importantes é o Livro da Portaria, o Index Gateway.

Sabe o livro de registros que anota tudo: “Dia 01: pizza para o ap. 302. Dia 02: caixa da Net para o 704.”? Ele não guarda os objetos em si, mas diz onde eles estão. No Loki, o Index é exatamente isso: ele aponta onde os dados estão, como um índice de um livro gigante, permitindo que o sistema saiba rapidamente onde encontrar a informação que você está procurando. Ele é a chave para a agilidade nas suas buscas.

E por último, mas não menos importante, temos o Síndico, o Compactor.

O Seu Walter, o síndico, de tempos em tempos manda jogar fora o que não precisa mais e junta o que vale a pena guardar numa pasta só. O Compactor do Loki faz um trabalho similar: ele junta logs antigos e os organiza para ocupar menos espaço. Ele é o cara da otimização, garantindo que o seu armazenamento de logs seja eficiente e que você não gaste mais do que o necessário com infraestrutura.

Boas Práticas para um Condomínio Loki Feliz! (hahaha)

Agora que entendemos a função de cada “personagem” do nosso condomínio Loki, vamos a algumas boas práticas para garantir que seu sistema de logs seja eficiente e útil:

1. Monitore seus “Porteiros” e “Zeladores”: Fique de olho na saúde dos seus Distributors e Ingesters. Eles são a linha de frente da ingestão de logs, e qualquer gargalo ali pode comprometer todo o seu sistema de observabilidade.

2. Otimize suas “Fofocas”: Ao usar o Querier, seja específico nas suas queries. Quanto mais detalhada for sua pergunta, mais rápido o sistema encontrará a resposta. Evite buscar por períodos muito longos sem filtros.

3. Cuide do seu “Depósito”: Monitore o espaço ocupado pelo seu Object Storage. Embora seja durável, o armazenamento tem custos. O 3Compactor ajuda, mas é sempre bom ter uma política de retenção de logs clara.

4. Mantenha seu “Livro da Portaria” em ordem: Um Index bem projetado é crucial para a performance das suas consultas. Pense bem nas labels que você usa para indexar seus logs, pois elas serão suas chaves de busca.

5. Use as “Regras do Condomínio” a seu favor: O Loki permite configurar regras de alerta e extração de métricas a partir dos logs. Utilize essas funcionalidades para transformar seus dados brutos em inteligência acionável.

Se restou alguma dúvida, sinta-se à vontade de me contactar!

E, se tua pergunta é…Quando e porquê devo usar essa turma(?), o próximo post é sobre isso! Até mais!