Consultando logs com LogQL

LinuxBeginner
Pratique Agora

Introdução

Imagine procurar uma frase específica em uma biblioteca com 10 milhões de livros. Você não pode ler todos os livros um por um. É necessário usar um mecanismo de pesquisa.

Para logs, esse mecanismo de pesquisa se chama LogQL (Log Query Language).

O LogQL desempenha para os logs um papel semelhante ao do PromQL para as métricas: ele oferece uma forma estruturada de selecionar, filtrar e transformar grandes volumes de dados operacionais em respostas específicas.

Neste laboratório, você usará o LogQL para pesquisar e filtrar logs centralizados. As linguagens de consulta são importantes para a observabilidade porque, quando o volume de dados cresce, uma solução de problemas eficiente depende de uma seleção precisa, e não da leitura manual.

  • Selecione a "estante" (selecione logs por rótulo).
  • Procure palavras-chave (filtre palavras específicas, como "ERROR").
  • Faça uma pesquisa avançada (use expressões regulares para padrões complexos).

Acessar o Grafana Explore

Nesta etapa, você vai abrir a fonte de dados do Loki no Grafana Explore. O laboratório inicia o Loki, o Promtail e um gerador de logs de exemplo.

Verificar se o Loki está pronto

No terminal da VM, execute:

curl -fsS http://localhost:3100/ready

Aguarde a resposta ready. Se o Loki ainda estiver iniciando, espere alguns segundos e tente novamente.

Abrir Explore

Alterne para Desktop, abra o Firefox na VM e acesse http://localhost:8080. Entre no Grafana 9.2.10 com admin como usuário e senha, e selecione Skip se for solicitado a alterá-la.

Abra Explore usando o ícone de bússola na barra lateral. No alto, selecione Loki se ele ainda não estiver selecionado.

Selecionar o fluxo de logs

Nesta etapa, você vai selecionar por rótulo o fluxo que contém os logs de exemplo. Um seletor de rótulo diz ao Loki em quais fluxos pesquisar.

Executar o seletor

No Explore, mude para Code e digite:

{job="syslog"}

As chaves delimitam o seletor. Ele escolhe os fluxos cujo rótulo job é igual a syslog. Pressione Shift + Enter no editor para executar a consulta. Os resultados devem mostrar mensagens INFO, WARN e ERROR com data e hora. Se o gerador acabou de iniciar, aguarde um pouco e execute novamente.

Explore do Grafana 9.2.10 com o seletor syslog e os resultados

Salvar a consulta para a verificação

Salve a mesma consulta no terminal da VM. A verificação lê o arquivo e executa a consulta no Loki.

echo '{job="syslog"}' > ~/project/q1.txt

Filtrar logs

Nesta etapa, você vai limitar o fluxo selecionado às mensagens com ERROR.

No modo Code, substitua a consulta por:

{job="syslog"} |= "ERROR"

O operador |= mantém as linhas que contêm o texto à direita. O filtro != faz o inverso. Pressione Shift + Enter no editor para executar a consulta e confira se as linhas exibidas contêm ERROR.

Salve o filtro no terminal da VM:

echo '{job="syslog"} |= "ERROR"' > ~/project/q2.txt

Usar pesquisa com expressões regulares

Nesta etapa, você vai usar uma expressão regular para manter as mensagens com ERROR ou WARN.

No modo Code, digite:

{job="syslog"} |~ "ERROR|WARN"

O filtro |~ procura linhas que correspondam à expressão regular. Em "ERROR|WARN", a barra vertical significa “ou”. Pressione Shift + Enter no editor para executar a consulta e procure os dois tipos de mensagem.

Resultados ERROR e WARN do filtro por expressão regular no Grafana 9.2.10

Salve a consulta no terminal da VM:

echo '{job="syslog"} |~ "ERROR|WARN"' > ~/project/q3.txt

Resumo

Neste laboratório, você aprendeu a pesquisar sua biblioteca de logs usando LogQL.

Você aprendeu as três etapas básicas da pesquisa:

  1. Selecionar ({...}): escolha a estante que deseja consultar (por exemplo, job="syslog").
  2. Filtrar (|=): encontre palavras-chave simples nesses logs (por exemplo, "ERROR").
  3. Regex (|~): encontre padrões complexos, como "A ou B" (por exemplo, "ERROR|WARN").

O LogQL é muito poderoso. No próximo laboratório, iremos um passo além e faremos cálculos sobre esses logs para criar gráficos, como a visualização de "erros por minuto"!