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.

Types de variables

Grafana utilise plusieurs types de variables.

Ajouter une variable de requête

À l'aide de variables de requête, vous pouvez écrire une requête de source de données qui renvoie une liste de noms de métriques, de valeurs de balises ou de clés. Par exemple, une variable de requête peut renvoyer une liste de noms de serveurs, d'identifiants de capteurs ou de centres de données. Les valeurs des variables changent au fur et à mesure qu'elles extraient des options de manière dynamique avec une requête de source de données.

Les expressions de requête peuvent contenir des références à d'autres variables et, en fait, créer des variables liées. Grafana le détecte et actualise automatiquement une variable lorsque l'une de ses variables liées change.

Expressions de requête

Les expressions de requête sont différentes pour chaque source de données. Pour plus d'informations, consultez la documentation de votre source de données à l'adresseConnexion aux sources de données.

Saisie des options générales

Saisie des options de requête

Ajouter une variable personnalisée

Utilisez une variable personnalisée pour les valeurs qui ne changent pas. Il peut s'agir de nombres, de chaînes ou même d'autres variables.

Par exemple, si les noms de serveurs ou de régions ne changent pas, vous pouvez les créer sous forme de variables personnalisées plutôt que de variables de requête. Comme elles ne changent pas, vous pouvez les utiliser dans des variables chaînées plutôt que dans d'autres variables de requête. Cela réduirait le nombre de requêtes que Grafana doit envoyer lorsque les variables chaînées sont mises à jour. Pour plus d'informations sur les variables chaînées, consultezVariables enchaînées.

Saisie des options générales

Saisie d'options personnalisées

Ajouter une variable de zone de texte

Les variables de zone de texte affichent un champ de saisie de texte avec une valeur par défaut facultative. Il s'agit de la variable la plus flexible, car vous pouvez saisir n'importe quelle valeur. Utilisez ce type de variable si vous disposez de métriques présentant une cardinalité élevée ou si vous souhaitez mettre à jour plusieurs panneaux d'un tableau de bord en même temps.

Saisie des options générales

Saisie des options de texte

Ajouter une variable constante

Pour définir une constante cachée, utilisez des variables constantes. Les variables constantes sont utiles pour les préfixes de chemin des métriques pour les tableaux de bord que vous souhaitez partager. Lorsque vous exportez un tableau de bord, les variables constantes sont converties en options d'importation.

Les variables constantes ne sont pas flexibles. Chaque variable constante ne contient qu'une seule valeur. Pour le mettre à jour, vous devez mettre à jour les paramètres des variables.

Les variables constantes sont utiles lorsque vous avez des valeurs complexes que vous devez inclure dans les requêtes, mais que vous ne souhaitez pas saisir à nouveau dans chaque requête. Par exemple, si le chemin d'un serveur est appeléi-0b6a61efe2ab843gg, vous pouvez le remplacer par une variable appelée$path_gg.

Saisie des options générales

Saisie d'options constantes

Ajouter une variable de source de données

Pour modifier rapidement la source de données d'un tableau de bord complet, vous pouvez utiliser des variables de source de données. Ils sont utiles si vous disposez de plusieurs instances d'une source de données, par exemple dans différents environnements.

Saisie des options générales

Saisie des options de source de données

Ajouter une variable d'intervalle

Utilisez une variable d'intervalle pour représenter des périodes telles que1m,1h,1d. Vous pouvez les considérer comme une commande à l'échelle du tableau de bord group-by-time . Les variables d'intervalle modifient la façon dont les données sont regroupées dans la visualisation. Vous pouvez également utiliser l'option Auto pour renvoyer un nombre défini de points de données par période.

Vous pouvez utiliser une variable d'intervalle comme paramètre à regrouper par heure (pour InfluxDB), par intervalle d'histogramme de date (pour OpenSearch) ou comme paramètre de fonction de synthèse (pour Graphite).

Saisie des options générales

Saisie des options d'intervalle

Exemples de variables d'intervalle

Exemple d'utilisation de la variable template myinterval dans une fonction Graphite :

summarize($myinterval, sum, false)

Un exemple de graphite plus complexe :

groupByNode(summarize(movingAverage(apps.$app.$server.counters.requests.count, 5), '$interval', 'sum', false), 2, 'sum')

Ajouter des filtres ad hoc

Vous pouvez utiliser des filtres ponctuels ou ad hoc pour ajouter des filtres clé/valeur qui sont automatiquement ajoutés à toutes les requêtes métriques utilisant la source de données spécifiée. Contrairement aux autres variables, vous n'utilisez pas de filtres ponctuels dans les requêtes. Vous les utilisez plutôt pour écrire des filtres pour les requêtes existantes.

Saisie des options générales

Options de saisie

Création de filtres ad hoc

Les filtres ad hoc constituent l'une des options variables les plus complexes et les plus flexibles disponibles. Au lieu d'une liste classique d'options de variables, cette variable permet de créer une requête ad hoc à l'échelle du tableau de bord. Les filtres que vous appliquez de cette manière sont appliqués à tous les panneaux du tableau de bord.

Variables enchaînées

Les variables chaînées, également appelées variables liées ou variables imbriquées, sont des variables de requête contenant une ou plusieurs autres variables dans leur requête variable. Cette section explique le fonctionnement des variables chaînées et fournit des liens vers des exemples de tableaux de bord utilisant des variables chaînées.

Les requêtes de variables chaînées sont différentes pour chaque source de données, mais le principe est le même pour toutes. Vous pouvez utiliser des requêtes variables chaînées dans n'importe quelle source de données qui les prend en charge.

Vous pouvez créer des tableaux de bord complexes, liés et basés sur des modèles, d'une profondeur de 5 ou 10 niveaux. Techniquement, il n'y a aucune limite quant à la profondeur ou à la complexité que vous pouvez atteindre, mais plus vous avez de liens, plus la charge de requête est importante.

Bonnes pratiques et conseils

Les pratiques suivantes faciliteront l'utilisation de vos tableaux de bord et de vos variables.

Création de nouvelles variables chaînées

Ordre variable

Pour modifier l'ordre des variables dans la liste des variables du tableau de bord, cliquez sur les flèches haut et bas à droite de chaque entrée. L'espace de travail Grafana répertorie les listes déroulantes de variables de gauche à droite en fonction de cette liste, en affichant la variable en haut de la liste à l'extrême gauche.

Considération de complexité

Plus vous avez de couches de dépendance dans les variables, plus la mise à jour des tableaux de bord prend du temps après avoir modifié les variables.

Par exemple, si vous avez une série de quatre variables liées (pays, région, serveur, métrique) et que vous modifiez la valeur d'une variable racine (pays), l'espace de travail Grafana doit exécuter des requêtes pour toutes les variables dépendantes avant de mettre à jour les visualisations dans le tableau de bord.

Variables globales

Grafana possède des variables intégrées globales qui peuvent être utilisées dans les expressions de l'éditeur de requêtes. Cette rubrique les répertorie par ordre alphabétique et les définit. Ces variables sont utiles dans les requêtes, les liens de tableau de bord, les liens de panneaux et les liens de données.

$__tableau de bord

Cette variable est le nom du tableau de bord actuel.

$__from et $__to

Grafana possède deux variables de plage de temps intégrées : $__from et. $__to Ils sont actuellement toujours interpolés en millisecondes d'époque par défaut, mais vous pouvez contrôler le formatage des dates.

La syntaxe ci-dessus fonctionne ${__to} également avec.

Vous pouvez également utiliser cette variable dans les URL. Par exemple, pour envoyer un utilisateur final vers un tableau de bord qui indique une période allant d'il y a six heures à aujourd'hui, utilisez l'URL suivante : https://play.grafana.org/d/000000012/ grafana-play-home ? ViewPanel=2&OrgId=1 ? de=maintenant-6h&to=maintenant

$__interval

Vous pouvez utiliser la $__interval variable comme paramètre à regrouper par heure (pour InfluxDB, Myself, Postgres, MSSQL), par intervalle d'histogramme de date (pour OpenSearch) ou comme paramètre de fonction de synthèse (pour Graphite).

L'espace de travail Grafana calcule automatiquement un intervalle qui peut être utilisé pour regrouper par heure dans les requêtes. Lorsque le nombre de points de données est supérieur à ce qui peut être affiché sur un graphique, les requêtes peuvent être rendues plus efficaces en les regroupant selon un intervalle plus long. Par exemple, il est plus efficace de regrouper par 1 jour que par 10 lorsqu'on examine 3 mois de données. Le graphique aura le même aspect et la requête sera plus rapide. Le $__interval est calculé en utilisant la plage de temps et la largeur du graphique (le nombre de pixels).

Calcul approximatif : (from - to) / resolution

Par exemple, lorsque l'intervalle de temps est d'une heure et que le graphique est affiché en plein écran, l'intervalle peut être calculé comme suit 2m : les points sont regroupés par intervalles de 2 minutes. Si l'intervalle de temps est de 6 mois et que le graphique est affiché en plein écran, l'intervalle peut être de 1d (1 jour) ; les points sont regroupés par jour.

Dans la source de données InfluxDB, la variable héritée $interval est la même variable. Utilisez $__interval à la place.

L'InfluxDB et OpenSearch les sources de données ont Group by time interval des champs qui sont utilisés pour coder en dur l'intervalle ou pour définir la limite minimale de la $__interval variable en utilisant la > syntaxe ->. >10m

$__interval_ms

Cette variable est la $__interval variable exprimée en millisecondes, et non une chaîne formatée par intervalle de temps. Par exemple, si $__interval c'est le cas, 20m alors c'$__interval_msest le cas1200000.

$__nom

Cette variable est uniquement disponible dans le panneau Singlestat et peut être utilisée dans les champs de préfixe ou de suffixe de l'onglet Options. La variable sera remplacée par le nom ou l'alias de la série.

$__org

Cette variable est l'ID de l'organisation actuelle. La variable ${__org.name} est le nom de l'organisation actuelle.

$__utilisateur

La variable ${__user.id} est l'ID de l'utilisateur actuel. La variable ${__user.login} est l'identifiant de connexion de l'utilisateur actuel. La variable ${__user.email} est l'adresse e-mail de l'utilisateur actuel.

$__range

Cette variable n'est actuellement prise en charge que pour les sources de données Prometheus. Cette variable représente la plage du tableau de bord actuel. Il est calculé parto - from. Il comporte des représentations en millisecondes et secondes appelées et. $__range_ms $__range_s

$timeFilter ou $__timeFilter

La $timeFilter variable renvoie la plage de temps actuellement sélectionnée sous forme d'expression. Par exemple, l'Last 7 daysexpression de l'intervalle de temps esttime > now() - 7d.

Cette variable est utilisée à plusieurs endroits, notamment :