Teste as suas regras de alerta do Loki antes que disparem em produção.

O AlertLint é um testador unitário gratuito e executado no navegador para regras de alerta e de gravação do Grafana Loki. Você cola o seu YAML do ruler do Loki mais um arquivo de testes modelado segundo o promtool com fluxos de logs sintéticos, aperta Executar, e o AlertLint avalia o LogQL e informa se os alertas que você esperava realmente dispararam. É o equivalente ao “test rules” do promtool que o Loki nunca lançou.

Não. O AlertLint roda 100% no lado do cliente. As suas regras e logs sintéticos são avaliados na aba do seu navegador — nada é enviado para um servidor, e não há conta nem cadastro. Você pode usá-lo com segurança em definições de regras internas ou sensíveis.

O Prometheus inclui o promtool test rules para fazer testes unitários de regras de alerta contra amostras sintéticas. O Loki não tem um equivalente integrado — não existe o comando loki test. O AlertLint preenche essa lacuna para o LogQL: você declara quais alertas devem disparar a partir de um determinado conjunto de linhas de log, antes que as regras cheguem à produção.

O avaliador em versão preliminar cobre os padrões comuns de alerta e de gravação — consultas de log e de métricas, seletores de fluxo, comparadores de rótulos, filtros de linha, agregações rate e count_over_time, agregações sum e comparações de limite frente aos alertas esperados. A paridade total com o motor de consultas oficial do Loki (Go compilado para WebAssembly) está prevista para uma versão futura.

Sim. Uma lista exp_alerts vazia em um caso de teste afirma que a regra não produz alertas no momento da avaliação — a mesma semântica de caso negativo que o promtool usa. É a forma canônica de provar que uma regra não vai disparar diante de um volume de logs benigno.

Não. O AlertLint é uma ferramenta comunitária e independente, e não é afiliado nem endossado pela Grafana Labs. Loki e Grafana são marcas registradas da Raintank, Inc. O AlertLint modela o formato de arquivo de testes do promtool por familiaridade e usa os nomes dos fornecedores apenas para descrever o que ele testa.

Antes de implantar, valide o YAML das suas regras com lokitool rules lint ou cortextool rules lint --backend=loki e faça uma execução de teste das suas consultas no Grafana Explore ou no logcli. Para testes prévios à implantação baseados em asserções — o passo que essas ferramentas não cobrem — cole as suas regras mais fluxos de logs sintéticos no AlertLint e afirme quais alertas devem disparar, incluindo os casos negativos. Uma execução em verde dá uma forte confiança prévia à implantação, embora o avaliador no navegador seja um motor em versão preliminar, e não uma reprodução completa de produção.

O lokitool e o cortextool oferecem os comandos rules lint e sync que validam a estrutura das regras e as enviam a um ruler do Loki — mas nenhum executa asserções de alerta com logs sintéticos nem diz se uma regra dispara. O AlertLint traz o fluxo de trabalho baseado em asserções, no estilo do promtool, para o LogQL: você fornece fluxos de logs sintéticos, declara quais alertas espera e recebe um veredito de sucesso ou falha, totalmente no navegador e sem instalar nada.

O AlertLint analisa o YAML padrão do ruler do Loki — grupos de regras de alerta e de gravação, cada uma com uma expr de LogQL, uma duração for opcional e labels/annotations — e informa os problemas estruturais inline. Para verificações mais profundas da política de expressões frente aos metadados das regras, o promruval com --support-loki é uma opção de CLI. O AlertLint roda totalmente no navegador e sem necessidade de cadastro.