Tableaux de bord Grafana

LinuxBeginner
Pratiquer maintenant

Introduction

Dans ce laboratoire, vous apprendrez les bases de la création d'un tableau de bord de monitoring avec Grafana. Grafana est une plateforme open-source populaire dédiée au monitoring et à l'observabilité, qui vous permet d'interroger, de visualiser, d'alerter et d'explorer vos métriques, quel que soit leur emplacement de stockage.

Vous démarrerez une pile de surveillance à partir de fichiers de configuration préparés. Elle comprend :

  • Grafana : L'outil de visualisation où vous construirez votre tableau de bord.
  • Prometheus : Une base de données de séries temporelles qui servira de source de données pour Grafana.
  • Node Exporter : Un agent qui collecte les métriques matérielles et système de la machine hôte et les expose pour que Prometheus puisse les récupérer (scrape).

Votre objectif est de construire un tableau de bord simple à partir de zéro qui affiche l'utilisation en temps réel du processeur (CPU) de l'environnement de laboratoire.

Démarrer et explorer la pile de surveillance

Dans cette étape, vous démarrerez Grafana, Prometheus et Node Exporter. Node Exporter expose les métriques système, Prometheus les collecte et Grafana les affiche. Les fichiers de configuration et de provisionnement de la source de données sont préparés pour vous.

cd /home/labex/project

Chaque étiquette fixe sélectionne la version utilisée dans ce laboratoire. Les téléchargements peuvent prendre plusieurs minutes. Attendez que chaque commande rende l’invite. Si un téléchargement échoue, relancez la même commande : Docker réutilise les couches terminées. Ne continuez pas tant qu’un téléchargement reste incomplet.

docker pull prom/prometheus:v3.3.0
docker pull prom/node-exporter:v1.9.1
docker pull grafana/grafana:11.6.0

docker network create crée un réseau où les conteneurs peuvent résoudre leurs noms respectifs. docker run -d démarre un conteneur en arrière-plan ; --name le nomme, --network le rattache au réseau et -p associe un port de l’hôte à un port du conteneur. Les montages -v attachent les fichiers de configuration préparés. Le suffixe :ro les rend accessibles en lecture seule.

docker network create monitoring-net
docker run -d --name node-exporter --network monitoring-net -p 9100:9100 prom/node-exporter:v1.9.1
docker run -d --name prometheus --network monitoring-net -p 9090:9090 -v /home/labex/project/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro prom/prometheus:v3.3.0
docker run -d --name grafana --network monitoring-net -p 8080:3000 -v /home/labex/project/grafana/provisioning:/etc/grafana/provisioning:ro grafana/grafana:11.6.0

Les options de curl signalent les échecs HTTP et réessaient les erreurs temporaires de démarrage jusqu’à 30 fois, à deux secondes d’intervalle. Un conteneur en cours d’exécution peut encore s’initialiser : attendez la réussite du contrôle de santé avant de poursuivre.

curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:9090/-/ready
curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:8080/api/health

Prometheus doit indiquer qu’il est prêt ; Grafana doit renvoyer "database": "ok". Examinez les conteneurs avec :

docker ps

Les trois conteneurs nommés doivent être Up. Sélectionnez l’onglet Grafana du laboratoire. Si la connexion intégrée est bloquée, ouvrez-le dans un nouvel onglet du navigateur à l’aide de sa commande d’ouverture. Connectez-vous avec le nom d’utilisateur admin et le mot de passe admin, puis cliquez sur Skip sur l’écran de changement de mot de passe. Ces identifiants sont réservés à ce laboratoire temporaire.

Ouvrez Connections → Data sources et vérifiez la présence de Prometheus. Son fichier de provisionnement le connecte à http://prometheus:9090 via le réseau Docker partagé. Laissez la pile fonctionner afin que Prometheus collecte plusieurs échantillons avant d’écrire la requête CPU.

Créer un tableau de bord dans Grafana

Dans cette étape, vous créerez un tableau de bord vide et ajouterez sa première visualisation. Un tableau de bord organise des panneaux en grille ; chaque panneau présente le résultat d’une requête.

Ouvrez Dashboards dans la barre latérale gauche. Cliquez sur New, puis sélectionnez New dashboard.

Dans le tableau de bord vide, cliquez sur Add visualization. Dans le sélecteur de sources de données, choisissez Prometheus. Cela indique au nouveau panneau où envoyer ses requêtes.

L’éditeur de panneau doit maintenant apparaître avec l’aperçu, l’éditeur de requêtes et les options d’affichage. Vous saisirez la requête CPU à l’étape suivante.

Ajouter un panneau avec une requête PromQL pour l'utilisation du CPU

Dans cette étape, vous allez ajouter un panneau à votre tableau de bord et utiliser une requête PromQL (Prometheus Query Language) pour récupérer les données d'utilisation du CPU.

Vous devriez déjà être dans l'éditeur de panneau de l'étape précédente.

En bas de l'éditeur, vous trouverez la section des requêtes. La source de données Prometheus devrait déjà être sélectionnée par défaut. Passez l’éditeur de requêtes en mode Code, puis saisissez la requête PromQL suivante. Vous pouvez la copier et la coller directement.

100 - (avg by (instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

Analysons cette requête :

  • node_cpu_seconds_total{mode="idle"} : Il s'agit d'une métrique de Node Exporter qui compte le nombre total de secondes pendant lesquelles le CPU a été en état "inactif" (idle).
  • rate(...[5m]) : Cette fonction calcule le taux moyen d'augmentation par seconde du temps d'inactivité sur les 5 dernières minutes. Le résultat est une valeur comprise entre 0 et 1, représentant la fraction de temps pendant laquelle le CPU était inactif.
  • avg by (instance) : Cela agrège les résultats, ce qui est utile si vous avez plusieurs CPU ou machines.
  • * 100 : Cela convertit la valeur fractionnaire en pourcentage (par exemple, 0,95 devient 95 %).
  • 100 - ... : Enfin, nous soustrayons le pourcentage d'inactivité de 100 pour obtenir le pourcentage d'utilisation active du CPU.

Cliquez sur Run queries. Le calcul de rate nécessite au moins deux collectes ; si la pile vient de démarrer, attendez environ 30 secondes et relancez la requête. Un graphique de l’utilisation du CPU au fil du temps doit apparaître dans l’aperçu supérieur.

Votre panneau affiche maintenant des données, mais il peut être amélioré avec un meilleur étiquetage et un meilleur formatage, ce que vous ferez à l'étape suivante.

Personnaliser et enregistrer le tableau de bord

Dans cette étape, vous nommerez le panneau CPU, formaterez ses valeurs en pourcentages et enregistrerez le tableau de bord. Des libellés clairs facilitent l’interprétation des résultats.

Dans Panel options, à droite, définissez Title exactement sur CPU Usage %.

Sous Standard options, ouvrez Unit, recherchez percent, puis sélectionnez Misc / Percent (0-100). La requête renvoie déjà des valeurs entre 0 et 100 ; cette unité ajoute donc le symbole de pourcentage sans modifier leur échelle.

Cliquez sur Back to dashboard pour conserver le panneau et revenir au tableau de bord. Celui-ci n’est pas encore enregistré de façon permanente.

Cliquez sur Save dashboard. Dans la boîte de dialogue, saisissez le titre exact My System Dashboard, puis cliquez sur Save. Le laboratoire utilise ce titre pour retrouver votre tableau de bord.

Vérifiez que le tableau de bord enregistré contient le panneau CPU Usage % avec un graphique du CPU et des unités en pourcentage.

Résumé

Dans ce laboratoire, vous avez construit un tableau de bord Grafana à partir de zéro. Vous avez démarré la pile de surveillance avec les fichiers de configuration préparés et réalisé les actions suivantes :

  • Exploration de l'environnement composé des conteneurs Grafana, Prometheus et Node Exporter.
  • Navigation dans l'interface utilisateur de Grafana pour créer un nouveau tableau de bord vide.
  • Ajout d'un panneau de visualisation et rédaction d'une requête PromQL pour récupérer les données d'utilisation du CPU depuis la source de données Prometheus.
  • Personnalisation du titre du panneau et du formatage des unités pour une meilleure lisibilité.
  • Enregistrement du tableau de bord terminé pour une utilisation future.

Vous connaissez désormais le flux de travail fondamental pour créer des visualisations dans Grafana. Vous pouvez approfondir ces connaissances en ajoutant d'autres panneaux à votre tableau de bord pour surveiller d'autres métriques système telles que l'utilisation de la mémoire, les E/S disque ou le trafic réseau.