Aller au contenu

GUIDE TECHNIQUE · GRAFANA

Analyser les logs Loki avec LogQL

Explorer les journaux Loki avec LogQL, filtrer les erreurs d'un service de recette et rapprocher leur volume d'une dégradation observée dans les métriques.

Niveau Avancé5 min de lecture— vuesGrafana

L’ESSENTIEL EN BREF

Les étapes clés

Ce guide présente 4 étapes, de « Vérifier le flux et les données de recette » à « Corréler un incident et retirer le test ».

Avant de commencer : Environnement de recette Grafana autorisé, indépendant des configurations de production.

01 · CADRAGE

Périmètre et résultat visé

Résultat attendu : Le compteur d’erreurs conserve le filtre de la recherche logs.

Public concerné : Ingénieurs DevOps, SRE, administrateurs plateforme et support N2/N3.

Environnement et versions

Grafana Explore et Loki avec une source de logs correctement configurée ; adapter les labels aux flux réels.

02 · AVANT DE COMMENCER

Prérequis et points de contrôle

Une source Loki accessible dans Grafana et un flux de recette service_name=lab avec messages normaux et error pour vérifier le comptage.

  • Environnement de recette Grafana autorisé, indépendant des configurations de production.
  • Accès et permissions minimales vérifiés pour le scénario « grafana loki logs correlation ».
  • Jeu de données non sensible et critères de réussite définis avant les modifications.

Votre environnement de départ

Environnement
Grafana opérationnel avec droits de lecture et d’édition sur un dossier de recette.
Outils
Navigateur ; une source Prometheus ou Loki répondant avec des données fictives.
Comptes et droits
Droits de création de source de données, dashboard ou règle selon le guide ; accès aux destinations de notification de recette.
Réseau et accès
Serveur Grafana vers Prometheus ou Loki ; un test depuis le navigateur seul ne vérifie pas ce flux serveur-à-serveur.

Contrôles avant de commencer

Où effectuer le contrôle : Grafana

Commandes et configuration
Dans Connections > Data sources, exécuter Save & test sur la source utilisée.

Résultat attendu : Grafana peut joindre le backend ; Explore retourne les séries ou flux attendus.

03 · VUE D’ENSEMBLE

Comprendre l’architecture et les flux

ARCHITECTURE TECHNIQUEComprendre la chaîne de bout en bout
01Source métrique
02Grafana
03Requête
04Visualisation
Loki indexe les labels des streams ; LogQL sélectionne les flux puis filtre les lignes. La corrélation temporelle ne démontre pas automatiquement une causalité.

04 · TUTORIEL

Procédure complète, étape par étape

Suivez les étapes dans l’ordre et contrôlez chaque résultat avant de poursuivre. Renseignez les paramètres adaptés à votre environnement.

01

ÉTAPE 1 / 4

Vérifier le flux et les données de recette

Un label ne peut être interrogé que s’il existe réellement dans Loki.

  1. Dans Explore, sélectionner la source Loki puis une fenêtre contenant les événements du laboratoire. Dans le navigateur de labels, confirmer service_name=lab ; sinon remplacer ce label dans toutes les requêtes.
  2. Le flux doit contenir au moins deux messages normaux et un message contenant exactement error en minuscules. Si vous ne disposez pas de ce jeu, le créer via votre collecteur de recette puis attendre son ingestion.
Commandes et configuration
{service_name="lab"}
Ce qui se passe à cette étape
1Préparer
2Vérifier le flux et les données de recette
3Contrôler

À vérifier : Les trois messages de recette sont visibles dans la même fenêtre ; le nom de la source et les labels sont confirmés.

Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.

02

ÉTAPE 2 / 4

Filtrer puis compter les mêmes erreurs

Le filtre doit faire partie de la plage agrégée, sinon le compteur inclut tous les logs.

  1. Exécuter la première requête en mode logs pour voir les lignes retenues.
  2. Exécuter la seconde en mode métrique ; avec un seul flux, deux messages normaux et un error dans les cinq minutes, la valeur attendue est 1. Le filtre est sensible à la casse.
Commandes et configuration
{service_name="lab"} |= "error"
sum(count_over_time({service_name="lab"} |= "error" [5m]))
Ce qui se passe à cette étape
1Préparer
2Filtrer puis compter les mêmes erreurs
3Contrôler

À vérifier : Les lignes filtrées et le compteur désignent les mêmes événements ; les messages normaux ne contribuent pas au compteur.

Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.

03

ÉTAPE 3 / 4

Comparer au volume total et au comportement sans données

Un compteur d’erreurs nul et une absence de flux n’ont pas la même signification.

  1. Comparer les deux calculs au même instant et sur le même intervalle ; si plusieurs flux correspondent, sum les agrège.
  2. Retirer ou attendre la sortie du message error de la fenêtre : la requête peut ne plus produire de série. Choisir explicitement si l’affichage doit substituer zéro ; garder un contrôle séparé de présence du flux.
Commandes et configuration
sum(count_over_time({service_name="lab"}[5m]))
(sum(count_over_time({service_name="lab"} |= "error" [5m]))) or vector(0)
Ce qui se passe à cette étape
1Préparer
2Comparer au volume total et au comportement sans données
3Contrôler

À vérifier : Le volume total inclut les messages normaux ; le volume filtré les exclut. La substitution de zéro est une décision d’affichage documentée.

Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.

04

ÉTAPE 4 / 4

Corréler un incident et retirer le test

La concomitance temporelle n’établit pas à elle seule une cause.

  1. Sur un message error, relever l’horodatage, l’instance et, s’il est présent, trace_id. Chercher la même trace dans la source de traces configurée, sans supposer que Loki crée automatiquement ce lien.
  2. Comparer avec les métriques sur la même fenêtre, puis supprimer les événements ou la configuration de collecte de recette selon votre politique.
Ce qui se passe à cette étape
1Préparer
2Corréler un incident et retirer le test
3Contrôler

À vérifier : Le diagnostic relie des identifiants précis ; les hypothèses restent distinguées des causes démontrées.

Point de vigilance : Arrêter cette étape si le contrôle échoue ; diagnostiquer avant de poursuivre.

RÉFÉRENCES TECHNIQUES

Documentation officielle

Retrouvez les fonctionnalités, les paramètres et les matrices de compatibilité de Grafana.

Consulter la documentation officielle

05 · RECETTE

Comment vérifier que tout fonctionne ?

Résultat attenduContrôles avant de considérer la procédure terminée
01

Le compteur d’erreurs conserve le filtre de la recherche logs.

02

Un jeu contenant deux messages normaux et un error ne compte qu’une erreur dans sa fenêtre.

03

La présence du flux est contrôlée séparément de l’affichage zéro.

06 · DIAGNOSTIC

Problèmes fréquents et résolution

Le signal attendu n'apparaît pas

Cause probable : Un filtre de chaîne agit après la sélection du stream et peut masquer des événements si les labels sont incorrects.

Que faire : Utiliser |= "error" uniquement si ce terme est présent dans les logs de recette. Comparer la hausse de logs à un événement de test et aux métriques du service.

La vérification donne un résultat incohérent

Cause probable : Le nombre de lignes doit être ramené à une fenêtre et à un périmètre comparables.

Que faire : Construire count_over_time sur cinq minutes puis agréger les streams si nécessaire. Aligner les horloges, les fuseaux, les labels de service et les fenêtres des graphiques.

Une action est refusée

Cause probable : Les permissions ou la portée de l'accès ne sont pas adaptées au laboratoire

Que faire : Vérifier le droit précis et le périmètre, sans élever globalement les privilèges.

07 · QUESTIONS PRATIQUES

Questions fréquentes

Comment reconnaître une configuration valide ?

Les messages attendus apparaissent et peuvent être corrélés à une instance.

Quel contrôle prouve un fonctionnement réel ?

Les variations sont cohérentes sur la même fenêtre temporelle.

Que faire en cas d'échec ?

Aligner les horloges, les fuseaux, les labels de service et les fenêtres des graphiques. Conserver les indices utiles, puis vérifier l'hypothèse sur une trace ou un événement technique indépendant.

AUTRES TECHNOLOGIES

Guides complémentaires

Tous les guides Grafana

VOTRE ENVIRONNEMENT

Besoin d’aller plus loin sur votre environnement ?

Échangeons sur votre environnement Grafana : pratiques, sécurité et exploitation.

Découvrir nos offres d’observabilité

Échanger avec ADN Consulting

Pour aller plus loin