Testez vos règles d’alerte Loki avant qu’elles ne se déclenchent en production.

AlertLint est un testeur unitaire gratuit, exécuté dans le navigateur, pour les règles d’alerte et d’enregistrement de Grafana Loki. Vous collez votre YAML de ruler Loki ainsi qu’un fichier de test calqué sur promtool contenant des flux de logs synthétiques, vous appuyez sur Run, et AlertLint évalue le LogQL puis indique si les alertes que vous attendiez se sont réellement déclenchées. C’est l’équivalent du « test rules » de promtool que Loki n’a jamais livré.

Non. AlertLint s’exécute à 100 % côté client. Vos règles et vos logs synthétiques sont évalués dans votre onglet de navigateur — rien n’est envoyé à un serveur, et il n’y a ni compte ni inscription. Vous pouvez l’utiliser en toute sécurité sur des définitions de règles internes ou sensibles.

Prometheus livre promtool test rules pour tester unitairement les règles d’alerte par rapport à des échantillons synthétiques. Loki n’a aucun équivalent intégré — il n’existe pas de commande loki test. AlertLint comble ce manque pour LogQL : vous affirmez quelles alertes devraient se déclencher à partir d’un ensemble donné de lignes de logs, avant même que les règles n’atteignent la production.

L’évaluateur en préversion couvre les schémas d’alerte et d’enregistrement courants — requêtes de logs et de métriques, sélecteurs de flux, matchers de labels, filtres de lignes, agrégations rate et count_over_time, agrégations sum et comparaisons de seuils par rapport aux alertes attendues. Une parité complète avec le moteur de requêtes Loki en amont (Go compilé en WebAssembly) est prévue pour une future version.

Oui. Une liste exp_alerts vide sur un cas de test affirme que la règle ne produit aucune alerte au moment de l’évaluation — la même sémantique de cas négatif qu’utilise promtool. C’est la manière canonique de prouver qu’une règle ne se déclenchera pas sur un volume de logs anodin.

Non. AlertLint est un outil communautaire indépendant qui n’est ni affilié à Grafana Labs ni approuvé par lui. Loki et Grafana sont des marques de Raintank, Inc. AlertLint modélise le format de fichier de test de promtool par souci de familiarité et n’utilise les noms des éditeurs que pour décrire ce qu’il teste.

Avant le déploiement, vérifiez votre YAML de règles avec lokitool rules lint ou cortextool rules lint --backend=loki et testez vos requêtes à blanc dans Grafana Explore ou logcli. Pour des tests préliminaires de type assertion — l’étape que ces outils ne couvrent pas — collez vos règles ainsi que des flux de logs synthétiques dans AlertLint et affirmez quelles alertes devraient se déclencher, y compris les cas négatifs. Une exécution au vert apporte une solide confiance préliminaire, même si l’évaluateur dans le navigateur est un moteur en préversion plutôt qu’une rediffusion complète de production.

lokitool et cortextool proposent des commandes rules lint et sync qui valident la structure des règles et poussent les règles vers un ruler Loki — mais aucun n’exécute d’assertions d’alerte sur des logs synthétiques ni ne vous indique si une règle se déclenche. AlertLint apporte à LogQL le flux de travail basé sur les assertions, de style promtool : vous fournissez des flux de logs synthétiques, vous déclarez quelles alertes vous attendez, et vous obtenez un verdict réussite ou échec, entièrement dans le navigateur et sans installation.

AlertLint analyse le YAML de ruler Loki standard — des groupes de règles d’alerte et d’enregistrement, chacune avec une expr LogQL, une durée for optionnelle et des labels/annotations — et signale les problèmes structurels en ligne. Pour des vérifications plus poussées de politique d’expression par rapport aux métadonnées des règles, promruval avec --support-loki est une option en ligne de commande. AlertLint s’exécute entièrement dans le navigateur, sans inscription requise.