Types de variables

Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.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 9.x de Grafana, voir. Travailler dans la version 9 de Grafana

Grafana utilise plusieurs types de variables.

Type de variable	Description
Requête	Liste de valeurs générée par requête, telles que les noms des métriques, les noms des serveurs, les identifiants des capteurs, les centres de données, etc. Pour plus d’informations, consultez Ajouter une variable de requête.
Personnalisé	Définissez les options des variables manuellement à l'aide d'une liste séparée par des virgules. Pour plus d’informations, consultez Ajouter une variable personnalisée.
Zone de texte	Affichez un champ de saisie de texte avec une valeur par défaut facultative. Pour plus d’informations, consultez Ajouter une variable de zone de texte.
Constant	Définissez une constante cachée. Pour plus d’informations, consultez Ajouter une variable constante.
Source de données	Modifiez rapidement la source de données d'un tableau de bord complet. Pour plus d’informations, consultez Ajouter une variable de source de données.
Intervalle	Les variables d'intervalle représentent des intervalles de temps. Pour plus d’informations, consultez Ajouter une variable d'intervalle.
Filtres ad hoc	Filtres clé/valeur ajoutés automatiquement à toutes les requêtes métriques pour une source de données (InfluxDB, Prometheus et uniquement). OpenSearch Pour plus d’informations, consultez Ajouter des filtres ad hoc.
Variables globales	Variables intégrées qui peuvent être utilisées dans les expressions de l'éditeur de requêtes. Pour plus d’informations, consultez Variables globales.
Variables enchaînées	Les requêtes de variables peuvent contenir d'autres variables. Pour plus d’informations, consultez Variables enchaînées.

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

Pour saisir des options générales pour une variable de requête

1. Accédez au tableau de bord pour lequel vous souhaitez créer une variable, puis choisissez l'icône des paramètres du tableau de bord (engrenage) en haut de la page.

2. Dans l'onglet Variables, choisissez Nouveau.

3. Entrez un nom pour votre variable.

4. Dans la liste Type, sélectionnez Requête.

5. (Facultatif) Pour Label, entrez le nom d'affichage de la liste déroulante des variables. Si vous ne saisissez pas de nom d'affichage, le libellé de la liste déroulante sera le nom de la variable.

6. Choisissez une option Masquer :

   • Aucune sélection (vide) : la liste déroulante des variables affiche le nom ou la valeur de l'étiquette de la variable. Il s’agit de l’option par défaut.

   • Libellé — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas.

   • Variable — Aucune liste déroulante de variables n'est affichée sur le tableau de bord.

Saisie des options de requête

Pour saisir des options de requête pour une variable de requête

1. Dans la liste des sources de données, sélectionnez la source de données cible pour la requête. Pour plus d'informations sur les sources de données, consultezConnexion aux sources de données.

2. Dans la liste Actualiser, sélectionnez le moment où la variable doit mettre à jour les options.

   • Jamais : met en cache les requêtes variables et les valeurs ne sont pas mises à jour. C'est bien si les valeurs ne changent jamais, mais problématique si elles sont dynamiques et changent beaucoup.

   • Lors du chargement du tableau de bord : interroge la source de données à chaque fois que le tableau de bord se charge. Cela ralentit le chargement du tableau de bord, car la requête variable doit être terminée avant que le tableau de bord puisse être initialisé.

   • En cas de changement d'intervalle de temps : interroge la source de données lorsque la plage horaire du tableau de bord change. Utilisez cette option uniquement si votre requête d'options variables contient un filtre de plage de temps ou dépend de la plage de temps du tableau de bord.

3. Dans le champ Requête, entrez une requête.

   • Le champ de requête varie en fonction de votre source de données. Certaines sources de données disposent d'éditeurs de requêtes personnalisés.

   • Si vous avez besoin de plus d'espace dans un éditeur de requêtes pour un seul champ de saisie, faites une pause sur les lignes situées dans le coin inférieur droit du champ et faites glisser le pointeur vers le bas pour l'agrandir.

4. (Facultatif) Dans le champ Regex, tapez une expression regex pour filtrer ou capturer des parties spécifiques des noms renvoyés par votre requête de source de données. Pour obtenir des exemples, consultez Filtrer les variables avec regex.

5. Dans la liste de tri, sélectionnez l'ordre de tri des valeurs à afficher dans la liste déroulante. L'option par défaut, Désactivé, signifie que l'ordre des options renvoyées par votre requête de source de données sera utilisé.

6. (Facultatif) Entrez les options de sélection. Pour plus d’informations, consultez Saisie des options de sélection des variables.

7. Dans Aperçu des valeurs, l'espace de travail Grafana affiche une liste des valeurs des variables actuelles. Passez-les en revue pour vous assurer qu'ils correspondent à vos attentes.

8. Choisissez Ajouter pour ajouter la variable au tableau de bord.

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

Pour saisir des options de requête pour une variable personnalisée

1. Accédez au tableau de bord pour lequel vous souhaitez créer une variable, puis choisissez l'icône des paramètres du tableau de bord (engrenage) en haut de la page.

2. Dans l'onglet Variables, choisissez Nouveau.

3. Entrez un nom pour votre variable.

4. Dans la liste Type, sélectionnez Personnalisé.

5. (Facultatif) Pour Label, entrez le nom d'affichage de la liste déroulante des variables. Si vous ne saisissez pas de nom d'affichage, le libellé de la liste déroulante sera le nom de la variable.

6. Choisissez une option Masquer :

   • Aucune sélection (vide) : la liste déroulante des variables affiche le nom ou la valeur de l'étiquette de la variable. Il s’agit de l’option par défaut.

   • Libellé ‐ La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas.

   • Variable — Aucune liste déroulante de variables n'est affichée sur le tableau de bord.

Saisie d'options personnalisées

Pour saisir des options personnalisées pour une variable personnalisée

1. Dans la liste Valeurs séparées par des virgules, entrez les valeurs de cette variable dans une liste séparée par des virgules. Vous pouvez inclure des nombres, des chaînes, d'autres variables ou des paires clé-valeur séparés par deux points.

2. (Facultatif) Entrez les options de sélection. Pour plus d’informations, consultez Saisie des options de sélection des variables.

3. Dans Aperçu des valeurs, l'espace de travail Grafana affiche une liste des valeurs des variables actuelles. Passez-les en revue pour vous assurer qu'ils correspondent à vos attentes.

4. Choisissez Ajouter pour ajouter la variable au tableau de bord.

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

Pour saisir les options générales d'une variable de zone de texte

1. Accédez au tableau de bord pour lequel vous souhaitez créer une variable, puis choisissez l'icône des paramètres du tableau de bord (engrenage) en haut de la page.

2. Dans l'onglet Variables, choisissez Nouveau.

3. Entrez un nom pour votre variable.

4. Dans la liste Type, sélectionnez Zone de texte.

5. (Facultatif) Pour Label, entrez le nom d'affichage de la liste déroulante des variables. Si vous ne saisissez pas de nom d'affichage, le libellé de la liste déroulante sera le nom de la variable.

6. Choisissez une option Masquer :

   • Aucune sélection (vide) : la liste déroulante des variables affiche le nom ou la valeur de l'étiquette de la variable. Il s’agit de l’option par défaut.

   • Libellé — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas.

   • Variable — Aucune liste déroulante de variables n'est affichée sur le tableau de bord.

Saisie des options de texte

Pour saisir des options de texte pour une variable de zone de texte

1. (Facultatif) Dans le champ Valeur par défaut, sélectionnez la valeur par défaut de la variable. Si vous ne saisissez rien dans ce champ, Grafana affiche une zone de texte vide dans laquelle vous pouvez taper du texte.

2. Dans Aperçu des valeurs, Grafana affiche une liste des valeurs des variables actuelles. Passez-les en revue pour vous assurer qu'ils correspondent à vos attentes.

3. Choisissez Ajouter pour ajouter la variable au tableau de bord.

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

Pour saisir des options générales pour une variable constante

1. Accédez au tableau de bord pour lequel vous souhaitez créer une variable, puis choisissez l'icône des paramètres du tableau de bord (engrenage) en haut de la page.

2. Dans l'onglet Variables, choisissez Nouveau.

3. Entrez un nom pour votre variable.

4. Dans la liste Type, sélectionnez Constante.

5. (Facultatif) Pour Label, entrez le nom d'affichage de la liste déroulante des variables. Si vous ne saisissez pas de nom d'affichage, le libellé de la liste déroulante sera le nom de la variable.

6. Choisissez une option Masquer :

   • Variable — Aucune liste déroulante de variables n'est affichée sur le tableau de bord. Il s’agit de l’option par défaut.

   • Aucune sélection (vide) : la liste déroulante des variables affiche le nom ou la valeur de l'étiquette de la variable.

   • Libellé — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas.

Saisie d'options constantes

Pour saisir des options constantes pour une variable constante

1. Dans le champ Valeur, entrez la valeur de la variable. Vous pouvez saisir des lettres, des chiffres et des symboles. Si vous utilisez des options de format variable avancées, vous pouvez même utiliser des caractères génériques. Pour plus d’informations, consultez Options avancées de format variable.

2. Dans Aperçu des valeurs, l'espace de travail Grafana affiche la valeur de la variable actuelle. Révisez-le pour vous assurer qu'il correspond à ce que vous attendez.

3. Choisissez Ajouter pour ajouter la variable au tableau de bord.

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

Pour saisir des options générales pour une variable de source de données

1. Accédez au tableau de bord pour lequel vous souhaitez créer une variable, puis choisissez l'icône des paramètres du tableau de bord (engrenage) en haut de la page.

2. Dans l'onglet Variables, choisissez Nouveau.

3. Entrez un nom pour votre variable.

4. Dans la liste Type, sélectionnez Source de données.

5. (Facultatif) Pour Label, entrez le nom d'affichage de la liste déroulante des variables. Si vous ne saisissez pas de nom d'affichage, le libellé de la liste déroulante sera le nom de la variable.

6. Choisissez une option Masquer :

   • Aucune sélection (vide) : la liste déroulante des variables affiche le nom ou la valeur de l'étiquette de la variable. Il s’agit de l’option par défaut.

   • Libellé — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas.

   • Variable — Aucune liste déroulante de variables n'est affichée sur le tableau de bord.

Saisie des options de source de données

Pour saisir les options de source de données pour une variable de source de données

1. Dans la liste Type, sélectionnez la source de données cible pour la variable. Pour plus d'informations sur les sources de données, consultezConnexion aux sources de données.

2. (Facultatif) Pour le filtre de nom d'instance, entrez un filtre regex pour les instances de source de données parmi lesquelles choisir dans la liste déroulante des valeurs variables. Laissez ce champ vide pour afficher toutes les instances.

3. (Facultatif) Entrez les options de sélection. Pour plus d’informations, consultez Saisie des options de sélection des variables.

4. Dans Aperçu des valeurs, Grafana affiche une liste des valeurs des variables actuelles. Passez-les en revue pour vous assurer qu'ils correspondent à vos attentes.

5. Choisissez Ajouter pour ajouter la variable au tableau de bord.

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

Pour saisir les options générales d'une variable d'intervalle

1. Accédez au tableau de bord pour lequel vous souhaitez créer une variable, puis choisissez l'icône des paramètres du tableau de bord (engrenage) en haut de la page.

2. Dans l'onglet Variables, choisissez Nouveau.

3. Entrez un nom pour votre variable.

4. Dans la liste Type, sélectionnez Intervalle.

5. (Facultatif) Pour Label, entrez le nom d'affichage de la liste déroulante des variables. Si vous ne saisissez pas de nom d'affichage, le libellé de la liste déroulante sera le nom de la variable.

6. Choisissez une option Masquer :

   • Aucune sélection (vide) : la liste déroulante des variables affiche le nom ou la valeur de l'étiquette de la variable. Il s’agit de l’option par défaut.

   • Libellé — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas.

   • Variable — Aucune liste déroulante de variables n'est affichée sur le tableau de bord.

Saisie des options d'intervalle

Pour saisir des options d'intervalle pour une variable d'intervalle

1. Dans le champ Valeurs, entrez les intervalles de temps que vous souhaitez voir apparaître dans la liste déroulante des variables. Les unités de temps suivantes sont prises en charge : s (seconds) m (minutes)h (hours),d (days),,w (weeks),M (months), ety (years). Vous pouvez également accepter ou modifier les valeurs par défaut :1m,10m,30m,1h,6h,12h,1d,7d,14d,30d.

2. (Facultatif) Activez l'option automatique si vous souhaitez ajouter l'autooption à la liste. Utilisez cette option pour spécifier combien de fois la plage de temps actuelle doit être divisée pour calculer la auto période actuelle. Si vous l'activez, deux autres options apparaissent :

   • Nombre de pas : sélectionnez le nombre de fois que la plage de temps actuelle sera divisée pour calculer la valeur, comme pour l'option de requête Max data points. Par exemple, si la plage de temps visible actuelle est de 30 minutes, l'autointervalle regroupe les données en 30 incréments d'une minute. La valeur par défaut est de 30 étapes.

   • Intervalle minimum : seuil minimal en dessous duquel les intervalles de décompte des pas ne divisent pas le temps. Pour continuer l'exemple de 30 minutes, si l'intervalle minimum est défini sur2m, Grafana regroupe les données en 15 incréments de 2 minutes.

3. Dans Aperçu des valeurs, Grafana affiche une liste des valeurs des variables actuelles. Passez-les en revue pour vous assurer qu'ils correspondent à vos attentes.

4. Choisissez Ajouter pour ajouter la variable au tableau de bord.

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.

Note

Remarque : les variables de filtre ponctuelles ou ad hoc ne fonctionnent qu'avec InfluxDB, Prometheus et les sources de données. OpenSearch

Saisie des options générales

Pour saisir les options générales d'un filtre ad hoc

1. Accédez au tableau de bord pour lequel vous souhaitez créer une variable, puis choisissez l'icône des paramètres du tableau de bord (engrenage) en haut de la page.

2. Dans l'onglet Variables, choisissez Nouveau.

3. Entrez un nom pour votre variable.

4. Dans la liste Type, sélectionnez Filtres ad hoc.

5. (Facultatif) Pour Label, entrez le nom d'affichage de la liste déroulante des variables. Si vous ne saisissez pas de nom d'affichage, le libellé de la liste déroulante sera le nom de la variable.

6. Choisissez une option Masquer :

   • Aucune sélection (vide) : la liste déroulante des variables affiche le nom ou la valeur de l'étiquette de la variable. Il s’agit de l’option par défaut.

   • Libellé — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas.

   • Variable — Aucune liste déroulante de variables n'est affichée sur le tableau de bord.

Options de saisie

Pour saisir les options d'un filtre ad hoc

1. Dans la liste des sources de données, sélectionnez la source de données cible. Pour plus d'informations sur les sources de données, consultezConnexion aux sources de données.

2. Choisissez Ajouter pour ajouter la variable au tableau de bord.

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

• Le chaînage de variables crée des dépendances parent-enfant. Vous pouvez les imaginer comme une échelle ou un arbre.

• Le moyen le plus rapide de créer une nouvelle variable chaînée consiste à copier la variable sur laquelle vous souhaitez baser la nouvelle variable. Dans la liste des variables, cliquez sur l'icône Dupliquer la variable à droite de l'entrée de variable pour créer une copie. Vous pouvez ensuite ajouter un élément à la requête pour la variable parent.

• Les nouvelles variables chaînées que vous créez de cette manière apparaissent en bas de la liste. Pour donner un ordre logique à la liste, faites glisser la variable vers une autre position dans la liste.

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.

• Répertoriez les variables qui n'ont pas de dépendances en haut, avant leurs variables enfants.

• Chaque variable doit suivre celle dont elle dépend.

• L'interface utilisateur n'indique pas quelles variables ont des relations de dépendance. Répertoriez les variables dans un ordre logique afin de le rendre plus clair pour les utilisateurs finaux (et pour vous-même).

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.

Syntaxe	Exemple de résultat	Description
${__from}	1594671549254	Époque Unix en millisecondes
${__from:date}	2020-07-13T 20:19:09.254 Z	Aucun argument, la valeur par défaut est ISO 8601/RFC 3339
${__from:date:iso}	2020-07-13T 20:19:09.254 Z	ISO 8601/RFC 3339
${__from:date:seconds}	1594671549	Époque des secondes Unix
${__from:date:YYYY-MM}	2020-07	Tout format de données personnalisé. Pour plus d'informations, consultez la section Affichage.

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 :

• La clause WHERE pour la source de données InfluxDB. Grafana l'ajoute automatiquement aux requêtes InfluxDB en mode éditeur de requêtes. Vous pouvez l'ajouter manuellement en mode éditeur de texte :WHERE $timeFilter.

• Enregistrez les requêtes Analytics dans la source de données Azure Monitor.

• Requêtes SQL dans MySQL, Postgres et MSSQL.

• La $__timeFilter variable est utilisée dans la source de données MySQL.