GUIDE TECHNIQUE · GRAFANA
Connecter Grafana à Prometheus
Configurer Prometheus comme source de données Grafana, contrôler l'accès réseau depuis Grafana et vérifier les séries dans Explore avant de construire un tableau de bord.
L’ESSENTIEL EN BREF
Les étapes clés
Ce guide présente 4 étapes, de « Vérifier l'endpoint Prometheus » à « Tester les échecs et documenter ».
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 : Grafana confirme l'accès à la source choisie.
Public concerné : Ingénieurs DevOps, SRE, administrateurs plateforme et support N2/N3.
Grafana et plugin Prometheus intégrés : confirmer la version, le mode d'authentification et les options TLS disponibles.
02 · AVANT DE COMMENCER
Prérequis et points de contrôle
Grafana avec droit de créer une source et un Prometheus joignable depuis le serveur Grafana ; ses credentials/TLS si exigés.
- Environnement de recette Grafana autorisé, indépendant des configurations de production.
- Accès et permissions minimales vérifiés pour le scénario « grafana connecter prometheus ».
- 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
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
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.
ÉTAPE 1 / 4
Vérifier l'endpoint Prometheus
Le bouton de test ne corrige pas un chemin réseau ou une erreur TLS.
- Identifier l'URL de Prometheus joignable depuis Grafana, le certificat TLS et les droits minimaux.
- Vérifier qu'une requête API autorisée renvoie une réponse sans rendre Prometheus accessible publiquement.
À vérifier : La connectivité et les contraintes d'authentification sont connues.
Point de vigilance : Conserver le moindre privilège et ne jamais afficher de secret.
ÉTAPE 2 / 4
Créer la source Prometheus
Une source de données doit représenter le bon environnement pour éviter les diagnostics croisés.
- Dans Connections > Data sources, sélectionner Prometheus et saisir l'URL de recette.
- Configurer l'authentification nécessaire, enregistrer puis utiliser Save & test.
up
sum by(job)(up)À vérifier : Grafana confirme l'accès à la source choisie.
Point de vigilance : Tester la configuration sur une instance ou un projet de recette, sans modifier la production.
ÉTAPE 3 / 4
Interroger les séries dans Explore
Une connexion réussie n'atteste pas que les métriques attendues sont collectées.
- Dans Explore, sélectionner la source et interroger up sur une période contenant des scrapes.
- Comparer les labels job et instance à Status > Targets dans Prometheus.
À vérifier : Les séries attendues apparaissent avec une fenêtre et une source explicites.
Point de vigilance : Conserver le moindre privilège et ne jamais afficher de secret.
ÉTAPE 4 / 4
Tester les échecs et documenter
Les refus TLS et les erreurs d'authentification doivent être distingués d'une absence de métriques.
- Tester une URL erronée dans une source temporaire, puis restaurer la configuration correcte.
- Tracer la source et les droits utilisés pour qu'une autre équipe puisse reproduire l'accès.
À vérifier : Le diagnostic différencie connexion, permissions et absence de données.
Point de vigilance : Ne jamais supprimer de ressource partagée pendant la recette.
RÉFÉRENCES TECHNIQUES
Documentation officielle
Retrouvez les fonctionnalités, les paramètres et les matrices de compatibilité de Grafana.
05 · RECETTE
Comment vérifier que tout fonctionne ?
Grafana confirme l'accès à la source choisie.
Les séries attendues apparaissent avec une fenêtre et une source explicites.
Le diagnostic différencie connexion, permissions et absence de données.
06 · DIAGNOSTIC
Problèmes fréquents et résolution
Le signal attendu n'apparaît pas
Cause probable : Une source de données doit représenter le bon environnement pour éviter les diagnostics croisés.
Que faire : Configurer l'authentification nécessaire, enregistrer puis utiliser Save & test. Comparer les labels job et instance à Status > Targets dans Prometheus.
La vérification donne un résultat incohérent
Cause probable : Une connexion réussie n'atteste pas que les métriques attendues sont collectées.
Que faire : Dans Explore, sélectionner la source et interroger up sur une période contenant des scrapes. Tester une URL erronée dans une source temporaire, puis restaurer la configuration correcte.
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 ?
Grafana confirme l'accès à la source choisie.
Quel contrôle prouve un fonctionnement réel ?
Les séries attendues apparaissent avec une fenêtre et une source explicites.
Que faire en cas d'échec ?
Tester une URL erronée dans une source temporaire, puis restaurer la configuration correcte. Tracer la source et les droits utilisés pour qu'une autre équipe puisse reproduire l'accès.
AUTRES TECHNOLOGIES
Guides complémentaires
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