Prueba tus reglas de alertas de Loki antes de que se disparen en producción.

AlertLint es un tester unitario gratuito y basado en el navegador para reglas de alertas y de registro de Grafana Loki. Pegas tu YAML del ruler de Loki más un archivo de pruebas modelado según promtool con flujos de logs sintéticos, pulsas Ejecutar y AlertLint evalúa el LogQL e informa si las alertas que esperabas realmente se dispararon. Es el equivalente al “test rules” de promtool que Loki nunca incluyó.

No. AlertLint se ejecuta 100% del lado del cliente. Tus reglas y logs sintéticos se evalúan en la pestaña de tu navegador: nada se sube a un servidor y no hay cuenta ni registro. Puedes usarlo con total seguridad sobre definiciones de reglas internas o sensibles.

Prometheus incluye promtool test rules para hacer pruebas unitarias de las reglas de alertas contra muestras sintéticas. Loki no tiene un equivalente integrado: no existe el comando loki test. AlertLint cubre esa carencia para LogQL: declaras qué alertas deberían dispararse a partir de un conjunto dado de líneas de log, antes de que las reglas lleguen a producción.

El evaluador en versión preliminar cubre los patrones habituales de alertas y de registro: consultas de logs y de métricas, selectores de flujos, comparadores de etiquetas, filtros de línea, agregaciones rate y count_over_time, agregaciones sum y comparaciones de umbral frente a las alertas esperadas. La paridad total con el motor de consultas oficial de Loki (Go compilado a WebAssembly) está prevista para una versión futura.

Sí. Una lista exp_alerts vacía en un caso de prueba afirma que la regla no produce alertas en el momento de la evaluación: la misma semántica de caso negativo que usa promtool. Es la forma canónica de demostrar que una regla no se disparará ante un volumen de logs benigno.

No. AlertLint es una herramienta comunitaria e independiente, y no está afiliada a Grafana Labs ni respaldada por esta. Loki y Grafana son marcas comerciales de Raintank, Inc. AlertLint modela el formato de archivo de pruebas de promtool por familiaridad y usa los nombres de los proveedores únicamente para describir lo que prueba.

Antes de desplegar, valida el YAML de tus reglas con lokitool rules lint o cortextool rules lint --backend=loki y haz una ejecución de prueba de tus consultas en Grafana Explore o logcli. Para pruebas previas al despliegue basadas en aserciones —el paso que esas herramientas no cubren— pega tus reglas más flujos de logs sintéticos en AlertLint y afirma qué alertas deberían dispararse, incluidos los casos negativos. Una ejecución en verde da una sólida confianza previa al despliegue, aunque el evaluador en el navegador es un motor en versión preliminar, no una reproducción de producción completa.

lokitool y cortextool ofrecen los comandos rules lint y sync que validan la estructura de las reglas y las envían a un ruler de Loki, pero ninguno ejecuta aserciones de alertas con logs sintéticos ni te dice si una regla se dispara. AlertLint lleva el flujo de trabajo basado en aserciones, al estilo de promtool, a LogQL: tú aportas flujos de logs sintéticos, declaras qué alertas esperas y obtienes un veredicto de éxito o fallo, todo en el navegador y sin instalar nada.

AlertLint analiza el YAML estándar del ruler de Loki —grupos de reglas de alertas y de registro, cada una con una expr de LogQL, una duración for opcional y labels/annotations— e informa de los problemas estructurales en línea. Para comprobaciones más profundas de la política de expresiones frente a los metadatos de las reglas, promruval con --support-loki es una opción de CLI. AlertLint se ejecuta por completo en el navegador y sin necesidad de registro.