Aller au contenu

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.

Niveau Débutant4 min de lecture— vuesGrafana

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.

Environnement et versions

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

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
Grafana interroge l'API HTTP de Prometheus depuis l'environnement qui héberge Grafana ; le navigateur ne doit pas stocker de secret de collecte.

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 l'endpoint Prometheus

Le bouton de test ne corrige pas un chemin réseau ou une erreur TLS.

  1. Identifier l'URL de Prometheus joignable depuis Grafana, le certificat TLS et les droits minimaux.
  2. Vérifier qu'une requête API autorisée renvoie une réponse sans rendre Prometheus accessible publiquement.
Ce qui se passe à cette étape
1Source métrique
2Grafana
3Requête

À 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.

02

É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.

  1. Dans Connections > Data sources, sélectionner Prometheus et saisir l'URL de recette.
  2. Configurer l'authentification nécessaire, enregistrer puis utiliser Save & test.
Commandes et configuration
up
sum by(job)(up)
Ce qui se passe à cette étape
1Source métrique
2Grafana
3Requête

À 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.

03

ÉTAPE 3 / 4

Interroger les séries dans Explore

Une connexion réussie n'atteste pas que les métriques attendues sont collectées.

  1. Dans Explore, sélectionner la source et interroger up sur une période contenant des scrapes.
  2. Comparer les labels job et instance à Status > Targets dans Prometheus.
Ce qui se passe à cette étape
1Grafana
2Requête
3Visualisation

À 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.

04

É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.

  1. Tester une URL erronée dans une source temporaire, puis restaurer la configuration correcte.
  2. Tracer la source et les droits utilisés pour qu'une autre équipe puisse reproduire l'accès.
Ce qui se passe à cette étape
1Grafana
2Requête
3Visualisation

À 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.

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

Grafana confirme l'accès à la source choisie.

02

Les séries attendues apparaissent avec une fenêtre et une source explicites.

03

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

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