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.
# Modèles et 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](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)
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. 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. 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 reflètent la nouvelle valeur.
Elles peuvent être particulièrement utiles pour les administrateurs qui souhaitent permettre aux utilisateurs d'ajuster rapidement les visualisations, mais qui ne souhaitent pas leur accorder des autorisations de modification complètes. Les visualiseurs de Grafana peuvent utiliser des variables.
En utilisant des variables et des modèles, vous pouvez 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 visualisez. Cela simplifie la maintenance et l'entretien.
Pour obtenir la liste des types de variables pris en charge et les instructions pour ajouter chaque type de variable, voir [Types de variables](variables-types.md)
## Modèles
Un *modèle* est une requête contenant une variable.
Par exemple, si vous administriez un tableau de bord pour surveiller plusieurs serveurs, vous pourriez créer un tableau de bord pour chaque serveur. Vous pouvez également créer un tableau de bord et utiliser des panneaux contenant des modèles de requêtes, comme illustré dans l'exemple suivant.
```
wmi_system_threads{instance=~"$server"}
```
Les valeurs des variables sont toujours synchronisées avec l'URL à l'aide de la syntaxe`var-=value`.
## 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.
## Syntaxe variable
Les titres des panneaux et les requêtes métriques peuvent voir les variables à l'aide de deux syntaxes différentes :
+ `$varname`Cette syntaxe est plus facile à lire, comme dans l'exemple suivant : `apps.frontend.$server.requests.count` Cependant, vous ne pouvez pas utiliser de variable au milieu d'un mot.
+ `${var_name}`Utilisez cette syntaxe lorsque vous souhaitez interpoler une variable au milieu d'une expression.
+ `${var_name:}`Ce format vous permet de mieux contrôler la façon dont Grafana interpole les valeurs. Pour de plus amples informations, veuillez consulter [Options avancées de format variable](#advanced-variable-format-options).
Avant que les requêtes ne soient envoyées à votre source de données, elles sont *interpolées*, ce qui signifie que la variable est remplacée par sa valeur actuelle. Pendant l'interpolation, la valeur de la variable peut être *évitée* pour se conformer à la syntaxe du langage de requête et à l'endroit où elle est utilisée. Par exemple, une variable utilisée dans une expression régulière d'une requête Prometheus sera échappée à une expression régulière. Consultez la rubrique de documentation spécifique à la source de données pour plus de détails sur l'échappement de valeur lors de l'interpolation.
Pour plus d'informations sur la syntaxe avancée permettant de remplacer le formatage par défaut de la source de données, consultez[Options avancées de format variable](#advanced-variable-format-options).
# 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](using-grafana-v10.md)
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)
Grafana utilise plusieurs types de variables.
| Type de variable | Description |
| --- | --- |
| Query | Liste de valeurs générée par requête, telles que les noms des métriques, les noms des serveurs, les capteurs IDs, les centres de données, etc. Pour de plus amples informations, veuillez consulter [Ajouter une variable de requête](#add-a-query-variable). |
| Personnalisé | Définissez les options des variables manuellement à l'aide d'une liste séparée par des virgules. Pour de plus amples informations, veuillez consulter [Ajouter une variable personnalisée](#add-a-custom-variable). |
| Zone de texte | Affichez un champ de saisie de texte avec une valeur par défaut facultative. Pour de plus amples informations, veuillez consulter [Ajouter une variable de zone de texte](#add-a-text-box-variable). |
| Constant | Définissez une constante cachée. Pour de plus amples informations, veuillez consulter [Ajouter une variable constante](#add-a-constant-variable). |
| Source de données | Modifiez rapidement la source de données d'un tableau de bord complet. Pour de plus amples informations, veuillez consulter [Ajouter une variable de source de données](#add-a-data-source-variable). |
| Interval | Les variables d'intervalle représentent des intervalles de temps. Pour de plus amples informations, veuillez consulter [Ajouter une variable d'intervalle](#add-an-interval-variable). |
| Filtres ad hoc | Key/value filtres qui sont automatiquement ajoutés à toutes les requêtes métriques pour une source de données (InfluxDB, Prometheus et uniquement). OpenSearch Pour de plus amples informations, veuillez consulter [Ajouter des filtres ad hoc](#add-ad-hoc-filters). |
| Variables globales | Variables intégrées qui peuvent être utilisées dans les expressions de l'éditeur de requêtes. Pour de plus amples informations, veuillez consulter [Variables globales](#global-variables). |
| Variables enchaînées | Les requêtes de variables peuvent contenir d'autres variables. Pour de plus amples informations, veuillez consulter [Variables enchaînées](#chained-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, de capteurs IDs ou de centres de données. Les valeurs des variables changent lorsqu'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'adresse[Connexion aux sources de données](AMG-data-sources.md).
### 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.
1. Dans l'onglet **Variables**, choisissez **Nouveau**.
1. Entrez un **nom** pour votre variable.
1. Dans la liste **Type**, sélectionnez **Requête**.
1. (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.
1. 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, consultez[Connexion aux sources de données](AMG-data-sources.md).
1. 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.
1. 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.
1. (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](templates-and-variables.md#filter-variables-with-regex).
1. 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é.
1. (Facultatif) Entrez les **options de sélection**. Pour de plus amples informations, veuillez consulter [Saisie des options de sélection des variables](templates-and-variables.md#enter-variable-selection-options).
1. Dans **Aperçu des valeurs**, l'espace de travail Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes.
1. 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, consultez[Variables enchaînées](#chained-variables).
### 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.
1. Dans l'onglet **Variables**, choisissez **Nouveau**.
1. Entrez un **nom** pour votre variable.
1. Dans la liste **Type**, sélectionnez **Personnalisé**.
1. (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.
1. 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.
1. (Facultatif) Entrez les **options de sélection**. Pour de plus amples informations, veuillez consulter [Saisie des options de sélection des variables](templates-and-variables.md#enter-variable-selection-options).
1. Dans **Aperçu des valeurs**, l'espace de travail Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes.
1. 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.
1. Dans l'onglet **Variables**, choisissez **Nouveau**.
1. Entrez un **nom** pour votre variable.
1. Dans la liste **Type**, sélectionnez Zone de **texte**.
1. (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.
1. 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.
1. Dans **Aperçu des valeurs**, Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes.
1. 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.
1. Dans l'onglet **Variables**, choisissez **Nouveau**.
1. Entrez un **nom** pour votre variable.
1. Dans la liste **Type**, sélectionnez **Constante**.
1. (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.
1. 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 de plus amples informations, veuillez consulter [Options avancées de format variable](templates-and-variables.md#advanced-variable-format-options).
1. 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 à vos attentes.
1. 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.
1. Dans l'onglet **Variables**, choisissez **Nouveau**.
1. Entrez un **nom** pour votre variable.
1. Dans la liste **Type**, sélectionnez **Source de données**.
1. (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.
1. 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, consultez[Connexion aux sources de données](AMG-data-sources.md).
1. (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.
1. (Facultatif) Entrez les **options de sélection**. Pour de plus amples informations, veuillez consulter [Saisie des options de sélection des variables](templates-and-variables.md#enter-variable-selection-options).
1. Dans **Aperçu des valeurs**, Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes.
1. 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 que`1m`,`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.
1. Dans l'onglet **Variables**, choisissez **Nouveau**.
1. Entrez un **nom** pour votre variable.
1. Dans la liste **Type**, sélectionnez **Intervalle**.
1. (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.
1. 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)`, et`y (years)`. Vous pouvez également accepter ou modifier les valeurs par défaut :`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`.
1. (Facultatif) Activez **l'option automatique** si vous souhaitez ajouter l'`auto`option à 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'`auto`intervalle 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 sur`2m`, Grafana regroupe les données en 15 incréments de 2 minutes.
1. Dans **Aperçu des valeurs**, Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes.
1. 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.
1. Dans l'onglet **Variables**, choisissez **Nouveau**.
1. Entrez un **nom** pour votre variable.
1. Dans la liste **Type**, sélectionnez **Filtres ad hoc**.
1. (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.
1. 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, consultez[Connexion aux sources de données](AMG-data-sources.md).
1. 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.
### \$1\$1\$1tableau de bord
Cette variable est le nom du tableau de bord actuel.
### \$1\$1\$1from et \$1\$1\$1to
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 |
| --- | --- | --- |
| \$1\$1\$1\$1from\$1 | 1594671549254 | Époque Unix en millisecondes |
| \$1\$1\$1\$1from:date\$1 | 2020-07-13T 20:19:09.254 Z | Aucun argument, la valeur par défaut est ISO 8601/RFC 3339 |
| \$1\$1\$1\$1from:date:iso\$1 | 2020-07-13T 20:19:09.254 Z | ISO 8601/RFC 3339 |
| \$1\$1\$1\$1from:date:seconds\$1 | 1594671549 | Époque des secondes Unix |
| \$1\$1\$1\$1from:date:YYYY-MM\$1 | 2020-07 | Tout format de données personnalisé. Pour plus d'informations, consultez la section [Affichage](https://momentjs.com/docs/#/displaying/). |
La syntaxe ci-dessus fonctionne `${__to}` également avec.
Vous pouvez également utiliser cette variable dans URLs . 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-jouer à la maison ? ViewPanel=2&OrgId=1 ? de=maintenant-6h&to=maintenant
### \$1\$1\$1interval
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 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`
### \$1\$1\$1interval 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 le `$__interval` est`20m`, alors le `$__interval_ms` est`1200000`.
### \$1\$1\$1nom
**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.
### \$1\$1\$1org
Cette variable est l'ID de l'organisation actuelle. La variable `${__org.name}` est le nom de l'organisation actuelle.
### \$1\$1\$1utilisateur
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.
### \$1\$1\$1range
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é par`to - from`. Il comporte des représentations en millisecondes et secondes appelées et. `$__range_ms` `$__range_s`
### \$1timeFilter ou \$1\$1\$1timeFilter
La `$timeFilter` variable renvoie la plage de temps actuellement sélectionnée sous forme d'expression. Par exemple, l'`Last 7 days`expression de l'intervalle de temps est`time > 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.
## Autres options variables
Cette section explique les autres options de variables disponibles.
### Saisie des options de sélection des variables
Vous pouvez utiliser les **options de sélection** pour gérer les sélections d'options variables. Toutes les options de sélection sont facultatives et sont désactivées par défaut.
#### Valeurs multiples
Si vous activez cette option, la liste déroulante des variables permet de sélectionner plusieurs options en même temps. Pour de plus amples informations, veuillez consulter [Formatage de variables à valeurs multiples](#formatting-multi-value-variables).
#### Option Tout inclure
L'espace de travail Grafana ajoute une `All` option à la liste déroulante des variables. Si un utilisateur final sélectionne cette option, toutes les options variables sont sélectionnées.
#### Toutes les valeurs personnalisées
Cette option n'est visible que si l'**option Tout inclure** est sélectionnée.
Pour définir la valeur de l'`All`option, entrez la syntaxe regex, glob ou Lucene dans le champ **Personnaliser** toutes les valeurs.
Par défaut, la `All` valeur inclut toutes les options de l'expression combinée. Cela peut devenir très long et entraîner des problèmes de performance. Parfois, il peut être préférable de spécifier une valeur complète personnalisée, comme une expression régulière joker.
Lorsque vous utilisez une syntaxe regex, glob ou Lucene **personnalisée dans l'option Personnaliser toutes les valeurs**, elle n'est jamais évitée. Vous devez donc déterminer quelle est une valeur valide pour votre source de données.
### Options avancées de format variable
Le formatage de l'interpolation variable dépend de la source de données, mais dans certains cas, vous souhaiterez peut-être modifier le formatage par défaut.
Par exemple, la source de données MySQL par défaut consiste à joindre plusieurs valeurs séparées par des virgules par des guillemets :. `'server01','server02'` Dans certains cas, vous souhaiterez peut-être avoir une chaîne séparée par des virgules sans guillemets :. `server01,server02` Pour ce faire, utilisez les options avancées de mise en forme des variables suivantes.
#### Syntaxe générale
Syntaxe : `${var_name:option}`
Si une option de mise en forme non valide est spécifiée, `glob` c'est l'option par défaut, ou option de secours.
#### CSV
Formate les variables comportant plusieurs valeurs sous forme de chaîne séparée par des virgules.
```
servers = ['test1', 'test2']
String to interpolate: '${servers:csv}'
Interpolation result: 'test1,test2'
```
#### Distribué - OpenTSDB
Formate les variables avec plusieurs valeurs dans un format personnalisé pour OpenTSDB.
```
servers = ['test1', 'test2']
String to interpolate: '${servers:distributed}'
Interpolation result: 'test1,servers=test2'
```
#### Devis double
Formate les variables à valeur unique et à valeurs multiples dans une chaîne séparée par des virgules, exclut chaque valeur par et `"` met chaque valeur entre `\"` guillemets avec. `"`
```
servers = ['test1', 'test2']
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```
#### Globe - Graphite
Formate les variables comportant plusieurs valeurs dans un glob (pour les requêtes Graphite).
```
servers = ['test1', 'test2']
String to interpolate: '${servers:glob}'
Interpolation result: '{test1,test2}'
```
#### JSON
Formate les variables comportant plusieurs valeurs sous forme de chaîne séparée par des virgules.
```
servers = ['test1', 'test2']
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```
#### Lucène - OpenSearch
Formate les variables avec plusieurs valeurs au format Lucene pour. OpenSearch
```
servers = ['test1', 'test2']
String to interpolate: '${servers:lucene}'
Interpolation result: '("test1" OR "test2")'
```
#### Code en pourcentage
Formate les variables à valeur unique et à valeurs multiples à utiliser dans les paramètres d'URL.
```
servers = ['foo()bar BAZ', 'test2']
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```
#### Barre verticale
Formate les variables comportant plusieurs valeurs dans une chaîne séparée par des tubes.
```
servers = ['test1.', 'test2']
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```
#### Raw
Désactive le formatage spécifique à la source de données, tel que les guillemets simples dans une requête SQL.
```
servers = ['test1.', 'test2']
String to interpolate: '${var_name:raw}'
Interpolation result: '{test.1,test2}'
```
#### Regex
Formate les variables comportant plusieurs valeurs dans une chaîne regex.
```
servers = ['test1.', 'test2']
String to interpolate: '${servers:regex}'
Interpolation result: '(test1\.|test2)'
```
#### Devis unique
Formate les variables à valeur unique ou multiple dans une chaîne séparée par des virgules, saisit chaque valeur par `\'` et `'` met chaque valeur entre guillemets avec. `'`
```
servers = ['test1', 'test2']
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```
#### Chaîne SQL
Formate les variables à valeur unique ou multiple dans une chaîne séparée par des virgules, saisit chaque valeur par `''` et `'` met chaque valeur entre guillemets avec. `'`
```
servers = ["test'1", "test2"]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```
#### Texte
Formate les variables à valeur unique et à valeurs multiples dans leur représentation textuelle. Pour une seule variable, elle renverra simplement la représentation textuelle. Pour les variables à valeurs multiples, elle renverra la représentation textuelle combinée avec`+`.
```
servers = ["test1", "test2"]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```
### Formatage de variables à valeurs multiples
L'interpolation d'une variable avec plusieurs valeurs sélectionnées est délicate car il n'est pas simple de formater les multiples valeurs dans une chaîne valide dans le contexte donné dans lequel la variable est utilisée. Grafana essaie de résoudre ce problème en permettant à chaque plug-in de source de données d'indiquer au moteur d'interpolation de modèles le format à utiliser pour plusieurs valeurs.
**Note**
L'option **Personnaliser toutes les valeurs** de la variable doit être vide pour que Grafana puisse formater toutes les valeurs en une seule chaîne. Si vous laissez ce champ vide, le Grafana concatène (additionne) toutes les valeurs de la requête. Quelque chose comme`value1,value2,value3`. Si une `all` valeur personnalisée est utilisée, elle sera plutôt quelque chose comme `*` ou`all`.
#### Variables à valeurs multiples avec une source de données Graphite
Graphite utilise des expressions globulaires. *Dans ce cas, une variable comportant plusieurs valeurs serait interpolée comme `{host1,host2,host3}` si la valeur actuelle de la variable était *host1, host2* *et host3*.*
#### Variables à valeurs multiples avec une source de données Prometheus ou InfluxDB
InfluxDB et Prometheus utilisent des expressions regex, de sorte que la même variable serait interpolée comme. `(host1|host2|host3)` Chaque valeur serait également échappée à une regex. Dans le cas contraire, une valeur avec un caractère de contrôle regex briserait l'expression regex.
#### Variables à valeurs multiples avec une source de données Elastic
Amazon OpenSearch utilise la syntaxe de requête Lucene, de sorte que la même variable serait formatée comme suit. `("host1" OR "host2" OR "host3")` Dans ce cas, chaque valeur doit être ignorée afin qu'elle ne contienne que des mots de contrôle Lucene et des guillemets.
#### Résolution des problèmes de format
L'échappement automatique et le formatage peuvent poser problème. Il peut être difficile de comprendre la logique d'un problème, en particulier pour InfluxDB et Prometheus, où l'utilisation de la syntaxe regex nécessite que la variable soit utilisée dans le contexte d'un opérateur regex.
Si vous ne voulez pas que Grafana effectue cet échappement et ce formatage automatiques des regex, vous devez effectuer l'une des opérations suivantes :
+ Désactivez les **options Inclure tout** à **valeurs multiples**.
+ Utilisez le [format de variable brut] (\$1\$1< relref "advanced-variable-format-options.md \$1raw" >\$1\$1).
### Filtrer les variables avec regex
À l'aide de l'option Regex Query, vous pouvez filtrer la liste des options renvoyées par la variable query ou modifier les options renvoyées.
Cette section explique comment utiliser une expression régulière pour filtrer et modifier les valeurs de la liste déroulante des variables.
À l'aide de l'option Regex Query, vous filtrez la liste des options renvoyées par la requête Variable ou vous modifiez les options renvoyées. Pour plus d'informations, consultez la section [Expressions régulières](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).
Exemples de filtrage dans la liste d'options suivante :
```
backend_01
backend_02
backend_03
backend_04
```
#### Filtrer de manière à ce que seules les options se terminant par `01` ou `02` soient renvoyées
Régex :
```
/.*[01|02]/
```
Résultat :
```
backend_01
backend_02
```
#### Filtrer et modifier les options à l'aide d'un groupe de capture regex pour renvoyer une partie du texte
Régex :
```
/.*(01|02)/
```
Résultat :
```
01
02
```
#### Filtrer et modifier - Exemple Prometheus
Liste des options :
```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```
Régex :
```
/.*instance="([^"]*).*/
```
Résultat :
```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```
#### Filtrage et modification à l'aide de textes nommés et de groupes de capture de valeurs
À l'aide de groupes de capture nommés, vous pouvez capturer des parties « texte » et « valeur » distinctes à partir des options renvoyées par la requête variable. La liste déroulante des variables peut contenir un nom convivial pour chaque valeur pouvant être sélectionnée.
Par exemple, lorsque vous interrogez la métrique `node_hwmon_chip_names` Prometheus, la valeur est plus conviviale `chip_name` que la valeur. `chip` Commencez par le résultat de requête variable suivant.
```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```
Passez-le dans le Regex suivant.
```
/chip_name="(?[^"]+)|chip="(?[^"]+)/g
```
La liste déroulante suivante est produite.
```
Display Name Value
------------ -------------------------
enp216s0f0np0 0000:d7:00_0_0000:d8:00_0
enp216s0f0np1 0000:d7:00_0_0000:d8:00_1
enp216s0f0np2 0000:d7:00_0_0000:d8:00_2
enp216s0f0np3 0000:d7:00_0_0000:d8:00_3
```
**Remarque :** seuls les noms de groupes de `value` capture `text` et de capture sont pris en charge.
### Panneaux ou lignes répétitifs
Vous pouvez créer des tableaux de bord dynamiques à l'aide de *variables de modèle*. Toutes les variables de vos requêtes sont étendues à la valeur actuelle de la variable avant que la requête ne soit envoyée à la base de données. Avec les variables, vous pouvez réutiliser un tableau de bord unique pour tous vos services.
Les variables de modèle peuvent être très utiles pour modifier dynamiquement vos requêtes sur l'ensemble d'un tableau de bord. Si vous souhaitez que Grafana crée dynamiquement de nouveaux panneaux ou lignes en fonction des valeurs que vous avez sélectionnées, vous pouvez utiliser la fonction *Répéter*.
#### Panneaux répétitifs
Si une variable `Multi-value` ou des `Include all value` options sont activées, vous pouvez choisir un panneau et demander à Grafana de répéter ce panneau pour chaque valeur sélectionnée. Vous pouvez trouver la fonction de *répétition* sous l'*onglet Général* en mode édition du panneau.
Le `direction` contrôle la façon dont les panneaux sont disposés.
Si vous le souhaitez`horizontal`, les panneaux sont disposés side-by-side. Grafana ajuste automatiquement la largeur de chaque panneau répété afin que toute la ligne soit remplie. À l'heure actuelle, vous ne pouvez pas mélanger d'autres panneaux d'une ligne avec un panneau répété.
Réglez `Max per row` cette option pour indiquer à Grafana le nombre maximum de panneaux par ligne que vous souhaitez. La valeur par défaut est *4*.
Si vous le souhaitez`vertical`, les panneaux sont disposés de haut en bas dans une colonne. La largeur des panneaux répétés est la même que celle du premier panneau (le gabarit original) répété.
Apportez des modifications uniquement au premier panneau (le modèle d'origine). Pour que les modifications prennent effet sur tous les panneaux, vous devez lancer une refonte dynamique du tableau de bord. Vous pouvez le faire soit en modifiant la valeur de la variable (c'est-à-dire la base de la répétition), soit en rechargeant le tableau de bord.
**Note**
Les panneaux récurrents nécessitent des variables pour qu'un ou plusieurs éléments soient sélectionnés. Vous ne pouvez pas répéter un panneau zéro fois pour le masquer.
#### Lignes répétitives
Comme indiqué ci-dessus, avec les panneaux, vous pouvez également répéter des lignes si vous avez défini des variables `Multi-value` ou une option `Include all value` de sélection.
Pour activer cette fonctionnalité, vous devez d'abord ajouter une nouvelle *ligne* à l'aide du menu *Ajouter un panneau*. Faites ensuite une pause sur le titre de la ligne et cliquez sur le bouton en forme de roue dentée pour accéder au panneau `Row Options` de configuration. Vous pouvez ensuite sélectionner la variable pour laquelle vous souhaitez répéter la ligne.
Il est recommandé d'utiliser également une variable dans le titre de la ligne.