Grafana : utiliser des variables de dashboard

Une variable rend un tableau de bord réutilisable en remplaçant une valeur fixe par un sélecteur dynamique.

Prérequis

• Un dashboard existant avec une datasource Prometheus.
• Plusieurs cibles node_exporter déclarées.

1. Créer la variable

Dashboard settings → Variables → New variable. Configurer :

Name        : instance
Type        : Query
Data source : Prometheus
Query       : label_values(node_uname_info, instance)
Refresh     : On dashboard load

Cocher Multi-value et Include All option si nécessaire.

2. Utiliser la variable dans une requête

Remplacer la valeur fixe par $instance :

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

L’opérateur =~ est obligatoire avec une variable multi-valeurs.

3. Afficher le sélecteur

Le menu déroulant instance apparaît en haut du dashboard. Sauvegarder avec l’icône disquette.

Vérification

Changer la valeur du sélecteur. Les panneaux liés se rafraîchissent et n’affichent que l’instance choisie.

Dépannage

• Sélecteur vide : tester label_values(...) dans Explore ; la métrique source doit exister.
• Filtre ignoré : vérifier l’usage de =~ au lieu de = pour les variables multiples.
• Variable non rafraîchie : régler Refresh sur On time range change si les labels évoluent souvent.