Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Ajouter et gérer des variables de tableau de bord
Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana.
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. Travailler dans la version 10 de Grafana
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Travailler dans la version 8 de Grafana
Une variable est un espace réservé pour une valeur. Vous pouvez utiliser des variables dans les requêtes métriques et dans les titres des panneaux. Ainsi, lorsque vous modifiez la valeur, à l'aide de la liste déroulante en haut du tableau de bord, les requêtes métriques de votre panneau changent pour refléter la nouvelle valeur.
Les variables vous permettent de créer des tableaux de bord plus interactifs et dynamiques. Au lieu de coder en dur des éléments tels que les noms des serveurs, des applications et des capteurs dans vos requêtes métriques, vous pouvez utiliser des variables à leur place. Les variables sont affichées sous forme de listes déroulantes en haut du tableau de bord. Ces listes déroulantes permettent de modifier facilement les données affichées dans votre tableau de bord.
Elles peuvent être particulièrement utiles pour les administrateurs qui souhaitent permettre aux utilisateurs de Grafana d'ajuster rapidement les visualisations, mais qui ne souhaitent pas leur accorder des autorisations de modification complètes. Les Grafana Viewers peuvent utiliser des variables.
Les variables et les modèles vous permettent également de créer des tableaux de bord à source unique. Si vous disposez de plusieurs sources de données ou serveurs identiques, vous pouvez créer un tableau de bord unique et utiliser des variables pour modifier ce que vous consultez. Cela simplifie énormément la maintenance et l'entretien.
Modèles
Un modèle est une requête contenant une variable. Par exemple, si vous administrez un tableau de bord pour surveiller plusieurs serveurs, vous pouvez créer un tableau de bord pour chaque serveur, ou vous pouvez créer un tableau de bord et utiliser des panneaux contenant des modèles de requêtes, tels que les suivants.
wmi_system_threads{instance=~"$server"}
Les valeurs des variables sont toujours synchronisées avec l'URL à l'aide de la syntaxe var- =value<varname>.
Exemples
Les variables sont répertoriées dans des listes déroulantes en haut de l'écran. Sélectionnez différentes variables pour voir comment les visualisations changent.
Pour voir les paramètres des variables, accédez à Paramètres du tableau de bord > Variables. Cliquez sur une variable dans la liste pour voir ses paramètres.
Les variables peuvent être utilisées dans les titres, les descriptions, les panneaux de texte et les requêtes. Les requêtes dont le texte commence par $ sont des modèles. Tous les panneaux ne comporteront pas de modèles de requêtes.
Bonnes pratiques variables
-
Les listes déroulantes de variables sont affichées dans l'ordre dans lequel elles sont répertoriées dans la liste des variables dans les paramètres du tableau de bord.
-
Placez les variables que vous allez souvent modifier en haut, afin qu'elles apparaissent en premier (à l'extrême gauche du tableau de bord).
