

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.

# Tableaux de bord dans Grafana version 10
<a name="v10-dashboards"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

 Un tableau de bord est un ensemble d'un ou de plusieurs [panneaux](v10-panels.md) organisés et disposés en une ou plusieurs rangées. Grafana est livré avec une variété de panneaux qui permettent de créer facilement les bonnes requêtes et de personnaliser la visualisation afin que vous puissiez créer le tableau de bord parfait pour vos besoins. Chaque panneau peut interagir avec les données de n'importe quelle configuration[Connexion aux sources de données](AMG-data-sources.md). 

 Les instantanés du tableau de bord sont statiques. Les requêtes et les expressions ne peuvent pas être réexécutées à partir d'instantanés. Par conséquent, si vous mettez à jour des variables dans votre requête ou expression, les données de votre tableau de bord ne seront pas modifiées. 

**Topics**
+ [Utilisation des tableaux de bord](v10-dash-using-dashboards.md)
+ [Création de tableaux de bord](v10-dash-building-dashboards.md)
+ [Gestion des tableaux de bord](v10-dash-managing-dashboards.md)
+ [Gestion des playlists](v10-dash-managing-playlists.md)
+ [Partage de tableaux de bord et de panneaux](v10-dash-sharing.md)
+ [Variables](v10-dash-variables.md)
+ [Evaluation de l'utilisation du tableau](v10-dash-assess-dashboard-usage.md)
+ [Résoudre les problèmes liés aux tableaux de bord](v10-dash-troubleshoot.md)
+ [Recherche dans les tableaux de bord dans la version 10 de Grafana](v10-search.md)

# Utilisation des tableaux de bord
<a name="v10-dash-using-dashboards"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Cette rubrique fournit une vue d'ensemble des fonctionnalités et des raccourcis du tableau de bord, et décrit comment utiliser la recherche dans le tableau de bord.

## Caractéristiques
<a name="v10-dash-features"></a>

Vous pouvez utiliser des tableaux de bord pour personnaliser la présentation de vos données. L'image suivante montre l'interface du tableau de bord dans l'espace de travail Amazon Managed Grafana.

![\[Image illustrant l'interface des tableaux de bord dans un espace de travail Grafana géré par Amazon, avec des surlignages pour les boutons correspondant aux différentes fonctionnalités.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  Fonctionnalité  |  Description  | 
| --- | --- | 
| **1. Home** | Sélectionnez l'icône d'accueil de Grafana pour être redirigé vers la page d'accueil configurée dans l'instance de Grafana. | 
| **2. Titre** | Lorsque vous sélectionnez le titre du tableau de bord, vous pouvez rechercher les tableaux de bord contenus dans le dossier actuel. | 
| **3. Partage d'un tableau de bord** | Utilisez cette option pour partager le tableau de bord actuel par lien ou instantané. Vous pouvez également exporter la définition du tableau de bord depuis le mode de partage. | 
| **4. Ajouter un nouveau panneau** | Utilisez cette option pour ajouter un panneau, une ligne de tableau de bord ou un panneau de bibliothèque au tableau de bord actuel. | 
| **5. Enregistrer le tableau de bord** | Cliquez sur l'icône Enregistrer pour enregistrer les modifications apportées à votre tableau de bord. | 
| **6. Informations du tableau de bord** | Choisissez d'afficher les analyses relatives à votre tableau de bord, notamment les informations sur les utilisateurs, l'activité et le nombre de requêtes. Pour de plus amples informations, veuillez consulter [Evaluation de l'utilisation du tableau](v10-dash-assess-dashboard-usage.md). | 
| **7. Paramètres du tableau de bord** | Utilisez cette option pour modifier le nom, le dossier ou les balises du tableau de bord et pour gérer les variables et les requêtes d'annotation. Pour plus d'informations sur les paramètres du tableau de bord, consultez[Modification des paramètres du tableau de bord](v10-dash-modify-settings.md). | 
| **8. Liste déroulante du sélecteur d'heure** |  Permet de sélectionner des options de plage de temps relative et de définir des plages de temps absolues personnalisées. Vous pouvez modifier les paramètres du **fuseau horaire** et de **l'année fiscale** à partir des commandes de plage horaire en cliquant sur le bouton **Modifier les paramètres horaires**. Les paramètres horaires sont enregistrés pour chaque tableau de bord.  | 
| **9. Plage de temps de zoom arrière** |  À utiliser pour dézoomer sur la plage de temps. Pour plus d'informations sur l'utilisation des commandes de plage de temps, consultez[Configuration de la plage horaire du tableau de bord](#v10-dash-setting-dashboard-time-range).  | 
| **10. Actualiser le tableau de** | Sélectionnez cette option pour déclencher immédiatement des requêtes et actualiser les données du tableau de bord. | 
| **11. Intervalle d'actualisation du tableau de bord** | Sélectionnez un intervalle de temps d'actualisation automatique du tableau de bord. | 
| **12. Mode d'affichage**  | Sélectionnez cette option pour afficher le tableau de bord sur un grand écran tel qu'un téléviseur ou un kiosque. Le mode Affichage masque les informations non pertinentes telles que les menus de navigation.  | 
| **13. Panneau de tableau de bord** |  L'élément de base d'un tableau de bord est le panneau. Pour ajouter un nouveau panneau, une nouvelle ligne de tableau de bord ou un nouveau panneau de bibliothèque, sélectionnez **Ajouter un panneau**. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. Légende du graphique** | Modifiez les couleurs des séries, l'axe Y et la visibilité des séries directement depuis la légende. | 
| **15. Ligne de tableau de bord** | Une ligne de tableau de bord est un séparateur logique au sein d'un tableau de bord qui regroupe les panneaux. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 

## Raccourcis clavier
<a name="v10-dash-keyboard-shortcuts"></a>

Grafana propose un certain nombre de raccourcis clavier. Pour afficher tous les raccourcis clavier disponibles, appuyez sur **?** ou **h** sur votre clavier.
+ `Ctrl+S`enregistre le tableau de bord actuel. 
+ `f`ouvre l'outil de recherche/de recherche du tableau de bord. 
+  `d+k`bascule en mode kiosque (masque le menu). 
+ `d+e`développe toutes les lignes. 
+ `d+s`ouvre les paramètres du tableau de bord. 
+ `Ctrl+K`ouvre la palette de commandes.
+ `Esc`quitte le panneau en mode plein écran ou en mode édition. Vous renvoie également au tableau de bord à partir des paramètres du tableau de bord.

**Panel ciblé**

Pour utiliser des raccourcis ciblant un panneau spécifique, passez le pointeur de la souris sur un panneau.
+ `e`bascule la vue d'édition du panneau 
+ `v`fait basculer le panneau en mode plein écran 
+ `ps`ouvre la fonction de partage de panneau 
+ `pd`double panneau 
+ `pr`supprime le panneau 
+ `pl`active la légende du panneau 

## Configuration de la plage horaire du tableau de bord
<a name="v10-dash-setting-dashboard-time-range"></a>

Grafana propose plusieurs méthodes pour gérer les plages temporelles des données visualisées, pour le tableau de bord, les panneaux et également pour les alertes.

Cette section décrit les unités de temps et les plages relatives prises en charge, les contrôles horaires courants, les paramètres horaires à l'échelle du tableau de bord et les paramètres horaires spécifiques au panneau.

**Unités de temps et plages relatives**

Grafana prend en charge les unités de temps suivantes : `s (seconds)``m (minutes)`,`h (hours)`,`d (days)`,, `w (weeks)` `M (months)``Q (quarters)`, et. `y (years)` 

L'opérateur moins vous permet de revenir dans le temps, par rapport à la date et à l'heure actuelles, ou`now`. Si vous souhaitez afficher la période complète de l'unité (jour, semaine ou mois), ajoutez-la `/<time unit>` à la fin. Pour consulter les périodes fiscales, utilisez `fQ (fiscal quarter)` et unités de `fy (fiscal year)` temps.

L'opérateur plus vous permet d'avancer dans le temps par rapport au présent. Par exemple, vous pouvez utiliser cette fonctionnalité pour examiner les données prédites dans le futur.

Le tableau suivant fournit des exemples de plages relatives.


| Exemple de plage relative | De | À | 
| --- | --- | --- | 
| Les 5 dernières minutes |  `now-5m`  |  `now`  | 
| Jusqu'à présent |  `now/d`  |  `now`  | 
| Cette semaine |  `now/w`  |  `now/w`  | 
| Jusqu'à présent cette semaine |  `now/w`  |  `now`  | 
| Ce mois-ci |  `now/M`  |  `now/M`  | 
| Ce mois-ci, jusqu'à présent |  `now/M`  |  `now`  | 
| Mois précédent |  `now-1M/M`  |  `now-1M/M`  | 
| Cette année jusqu'à présent |  `now/Y`  |  `now`  | 
| Cette année |  `now/Y`  |  `now/Y`  | 
| Exercice financier précédent |  `now-1y/fy`  |  `now-1y/fy`  | 

**Note**  
 Grafana Alerting ne prend pas en charge les syntaxes suivantes :  
`now+n`pour les futurs horodatages.
`now-1n/n`pour le *début de n jusqu'à la fin de n*, car il s'agit d'un horodatage absolu.

**Contrôles de plage de temps courants**

Les commandes horaires du tableau de bord et du panneau ont une interface utilisateur commune. Ce qui suit décrit les contrôles de plage de temps courants.
+ La plage horaire actuelle, également appelée *sélecteur de temps*, indique la plage de temps actuellement affichée dans le tableau de bord ou le panneau que vous consultez. Passez votre curseur sur le champ pour voir les horodatages exacts de la plage et leur source (telle que l'heure du navigateur local). Cliquez sur la *plage horaire actuelle* pour la modifier. Vous pouvez modifier l'heure actuelle en utilisant une *plage de temps relative*, telle que les 15 dernières minutes, ou une plage de temps absolue, telle que `2020-05-14 00:00:00` à`2020-05-15 23:59:59`.
+ La **plage de temps relative** peut être sélectionnée dans la liste des **plages de temps relatives**. Vous pouvez filtrer la liste à l'aide du champ de saisie situé en haut. Quelques exemples de plages horaires incluent les *30 dernières minutes*, les *12 dernières heures*, les *7 derniers jours*, les *2 dernières années*, *hier*, *avant-hier*, *ce jour la semaine dernière*, *aujourd'hui jusqu'à présent*, *cette semaine jusqu'à présent* et *Ce mois jusqu'à présent*.
+ La **plage de temps absolue** peut être définie de deux manières : en saisissant des valeurs temporelles exactes ou relatives dans les champs **De** et **à** et en cliquant sur **Appliquer la plage de temps**, ou en cliquant sur une date ou une plage de dates dans le calendrier affiché lorsque vous cliquez sur le champ **De ou **de**** fin. Pour appliquer vos sélections, cliquez sur **Appliquer la plage horaire**. Vous pouvez également choisir parmi une liste des plages temporelles absolues récemment utilisées.
+ La **plage de temps semi-relative** peut être sélectionnée dans les paramètres de plage de temps absolus. Par exemple, pour afficher l'activité depuis une date précise, vous pouvez choisir une heure absolue pour l'heure de début et une heure relative (telle que`now`) pour l'heure de fin.

  En utilisant une plage de temps semi-relative, au fil du temps, votre tableau de bord effectue automatiquement et progressivement un zoom arrière pour afficher plus d'historique et moins de détails. Au même rythme, à mesure que la haute résolution des données diminue, les tendances historiques sur l'ensemble de la période deviendront plus claires.
**Note**  
Les alertes ne prennent pas en charge les plages temporelles semi-relatives.
+ **Effectuez un zoom** arrière en sélectionnant l'icône de zoom arrière (ou en utilisant Cmd\$1Z ou Ctrl\$1Z comme raccourci clavier). Cela augmente la vue, en affichant une plage de temps plus large dans la visualisation du tableau de bord ou du panneau.
+ **Zoomez en** sélectionnant la plage de temps que vous souhaitez afficher sur le graphique de la visualisation.
**Note**  
Le zoom avant ne s'applique qu'aux visualisations graphiques. 

**Actualiser les tableaux de bord**

Cliquez sur l'icône **Actualiser le tableau de bord** pour exécuter immédiatement chaque requête sur le tableau de bord et actualiser les visualisations. Grafana annule toutes les demandes en attente lorsque vous déclenchez une actualisation.

Par défaut, Grafana n'actualise pas automatiquement le tableau de bord. Les requêtes sont exécutées selon leur propre calendrier en fonction des paramètres du panneau. Toutefois, si vous souhaitez actualiser régulièrement le tableau de bord, cliquez sur la flèche vers le bas à côté de l'icône **Actualiser le tableau de bord**, puis sélectionnez un intervalle d'actualisation.

**Contrôlez la plage horaire à l'aide d'une URL**

Vous pouvez contrôler la plage horaire d'un tableau de bord en fournissant les paramètres de requête suivants dans l'URL du tableau de bord.
+ `from`définit la limite inférieure de la plage de temps, spécifiée en ms epoch ou en [temps relatif.](#v10-dash-setting-dashboard-time-range)
+ `to`définit la limite supérieure de la plage de temps, spécifiée en ms epoch ou en temps relatif.
+ `time`et `time.window` définit une plage de temps allant de `time-time.window/2` à`time+time.window/2`. Les deux paramètres doivent être spécifiés en ms. Par exemple, les `?time=1500000000000&time.window=10000` résultats indiquent une plage de temps de 10 s comprise entre 1499999995000 et 1500000005000.

# Création de tableaux de bord
<a name="v10-dash-building-dashboards"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Une fois que vous avez créé un espace de travail Grafana et que vous vous êtes connecté, vous pouvez créer des tableaux de bord et modifier les paramètres en fonction de vos besoins. Un tableau de bord est composé de [panneaux contenant des visualisations.](v10-panels-viz.md) Chaque panneau est associé à une requête, pour extraire des données de l'un de vos[Connexion aux sources de données](AMG-data-sources.md).

Vous pouvez créer des tableaux de bord plus interactifs et dynamiques en ajoutant et en utilisant des [variables](v10-dash-variables.md). Au lieu de coder en dur le nom du serveur, de l'application ou d'autres noms dans vos requêtes métriques, vous pouvez utiliser des variables à leur place.

**Topics**
+ [Création de tableaux de bord](v10-dash-creating.md)
+ [Importation de tableaux de bord](v10-dash-importing.md)
+ [Exportation de tableaux de bord](v10-dash-exporting.md)
+ [Modification des paramètres du tableau de bord](v10-dash-modify-settings.md)
+ [Variables URL du tableau de bord](v10-dash-dashboard-url-variables.md)
+ [Gestion des panneaux de bibliothèque](v10-dash-manage-library-panels.md)
+ [Gérer l'historique des versions du tableau de bord](v10-dash-manage-version-history.md)
+ [Gestion des liens du tableau de bord](v10-dash-manage-dashboard-links.md)
+ [Annotez les visualisations](v10-dash-annotations.md)
+ [Modèle JSON du tableau de bord](v10-dash-dashboard-json-model.md)
+ [Bonnes pratiques pour les tableaux de bord](v10-dash-bestpractices.md)

# Création de tableaux de bord
<a name="v10-dash-creating"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

**Création d'un tableau de bord**

Les tableaux de bord et les panneaux vous permettent de présenter vos données sous forme visuelle à l'aide de Grafana. Chaque panneau a besoin d'au moins une requête pour afficher une visualisation. Avant de commencer, remplissez les conditions préalables suivantes.
+ Assurez-vous de disposer des autorisations appropriées. Pour en savoir plus sur les autorisations, consultez [Utilisateurs, équipes et autorisations](Grafana-administration-authorization.md).
+ Identifiez le tableau de bord auquel vous souhaitez ajouter le panneau.
+ Comprenez le langage de requête de la source de données cible.
+ Assurez-vous que la source de données pour laquelle vous rédigez une requête a été ajoutée. Pour de plus amples informations, veuillez consulter [Connexion aux sources de données](AMG-data-sources.md).

 Pour créer un tableau de bord :

1. Connectez-vous à Grafana, puis sélectionnez **Tableaux de bord dans le menu** de gauche.

1. Sélectionnez **Nouveau**, puis **Nouveau tableau de bord**.

1. Sur le tableau de bord vide, sélectionnez **\$1 Ajouter une visualisation**. Cela ouvre la nouvelle boîte de dialogue de visualisation.

1. Sélectionnez une source de données. Vous pouvez choisir une source de données existante, l'une des sources de données intégrées de Grafana à des fins de test, ou choisir **Configurer une nouvelle source de données** pour en créer une nouvelle (seuls les utilisateurs disposant d'autorisations d'administrateur peuvent configurer de nouvelles sources de données).

   La vue du **panneau d'édition** s'ouvre, avec votre source de données sélectionnée. Vous pouvez modifier la source de données du panneau ultérieurement, en utilisant l'onglet **Requête** de l'éditeur de panneau, si nécessaire.

1. Rédigez ou créez une requête dans le langage de requête de votre source de données. Cliquez sur l'icône d'actualisation du tableau de bord pour effectuer une requête sur la source de données et voir les résultats au fur et à mesure.

1. Dans la liste **Visualisation**, sélectionnez un type de visualisation. Grafana affiche un aperçu des résultats de votre requête avec la visualisation appliquée. Pour plus d'informations, consultez [la section Options de visualisation.](v10-panels-viz.md)

1. Sous **Options du panneau**, vous pouvez saisir le titre et la description de votre panneau. 

1. La plupart des visualisations nécessitent quelques ajustements avant d'afficher les informations exactes dont vous avez besoin. Vous pouvez régler les paramètres du panneau de différentes manières.
   + [Configurer les mappages de valeurs](v10-panels-configure-value-mappings.md)
   + [Options spécifiques à la visualisation](v10-panels-viz.md)
   + [Remplacer les valeurs des champs](v10-panels-configure-overrides.md)
   + [Configuration des seuils](v10-panels-configure-thresholds.md)
   + [Configuration des options standard](v10-panels-configure-standard-options.md)

1. Lorsque vous avez terminé de configurer votre panneau, choisissez **Enregistrer** pour enregistrer le tableau de bord.

   Vous pouvez également sélectionner **Appliquer** pour voir les modifications sans quitter l'éditeur de panneaux.

1. Ajoutez une note pour décrire la visualisation (ou décrivez vos modifications), puis cliquez sur **Enregistrer** dans le coin supérieur droit de la page.
**Note**  
Les notes sont utiles si vous devez rétablir une version précédente du tableau de bord.

1. Choisissez **Enregistrer**.

1. Vous pouvez éventuellement ajouter d'autres panneaux au tableau de bord en choisissant **Ajouter** dans l'en-tête du tableau de bord et en sélectionnant **Visualisation** dans le menu déroulant.

**Copier un tableau de bord existant**

Vous pouvez rapidement copier un tableau de bord existant pour commencer à en créer un nouveau.

**Pour copier un tableau de bord existant**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Choisissez le tableau de bord que vous souhaitez copier pour l'ouvrir.

1. Sélectionnez **Paramètres** (icône en forme de roue dentée) en haut à droite du tableau de bord.

1. Sélectionnez **Enregistrer sous** dans le coin supérieur droit du tableau de bord.

1. (Facultatif) Spécifiez le nom, le dossier, la description et indiquez si vous souhaitez copier ou non les balises du tableau de bord d'origine pour le tableau de bord copié.

1. Cliquez sur **Enregistrer**.

**Configuration des lignes répétitives**

Vous pouvez configurer Grafana pour ajouter dynamiquement des panneaux ou des lignes à un tableau de bord en fonction de la valeur d'une variable. Les variables modifient dynamiquement vos requêtes sur toutes les lignes d'un tableau de bord. Pour plus d'informations sur les panneaux récurrents, voir [Configuration des panneaux répétitifs]().

Vous pouvez également répéter des lignes si des variables sont définies `Multi-value` ou `Include all values` sélectionnées.

Avant de commencer, assurez-vous que la requête inclut une variable à valeurs multiples, puis effectuez les étapes suivantes.

**Pour configurer les lignes répétitives**

1. Sélectionnez **Tableaux** de bord dans le menu de gauche, puis choisissez le tableau de bord que vous souhaitez modifier.

1. En haut du tableau de bord, sélectionnez **Ajouter**, puis sélectionnez **Ligne** dans le menu déroulant.

   Si le tableau de bord est vide, vous pouvez également sélectionner le bouton **\$1 Ajouter une ligne** au milieu du tableau de bord.

1. Passez le curseur sur le titre de la ligne et sélectionnez l'icône **Paramètres** (engrenage) qui apparaît.

1. Dans la boîte de dialogue **Options de ligne**, ajoutez un titre et sélectionnez la variable pour laquelle vous souhaitez ajouter des lignes répétitives.
**Note**  
 Pour fournir du contexte aux utilisateurs du tableau de bord, ajoutez la variable au titre de la ligne. 

1. Tâche de sélection **Update (Mise à jour)**.

**Lignes répétitives et source de données spéciale du tableau de bord**

Si une ligne inclut des panneaux utilisant la source de données spéciale du tableau de [bord](AMG-data-sources.md#AMG-data-sources-special), c'est-à-dire la source de données qui utilise un ensemble de résultats provenant d'un autre panneau du même tableau de bord, les panneaux correspondants dans des lignes répétées feront référence au panneau de la ligne d'origine, et non à ceux des lignes répétées.

Par exemple, dans un tableau de bord :
+ `Row 1`inclut `Panel 1A` et`Panel 1B`.
+ `Panel 1B`utilise les résultats de `Panel 1A` en utilisant la source `Dashboard` de données.
+ `Row 2`La répétition inclut `Panel 2A` et`Panel 2B`.
+ `Panel 2B`références`Panel 1A`, non`Panel 2A`.

**Pour déplacer un panneau**

1. Ouvrez le tableau de bord.

1. Sélectionnez le titre du panneau et faites-le glisser vers le nouvel emplacement. Vous pouvez placer un panneau sur un tableau de bord à n'importe quel endroit.

**Pour redimensionner un panneau**

1. Ouvrez le tableau de bord.

1. Pour ajuster la taille du panneau, faites glisser le coin inférieur droit du panneau. Vous pouvez dimensionner un panneau de tableau de bord en fonction de vos besoins.

# Importation de tableaux de bord
<a name="v10-dash-importing"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Vous pouvez importer des tableaux de bord préconfigurés dans votre espace de travail Amazon Managed Grafana.

**Pour importer un tableau de bord**

1. Connectez-vous à votre espace de travail Amazon Managed Grafana.

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez **Nouveau**, puis choisissez **Importer** dans le menu déroulant.

1. Ensuite, vous devez choisir la définition JSON du tableau de bord à importer. Trois options s'offrent à vous pour importer du JSON :
   + Téléchargez un fichier contenant le JSON du tableau de bord.
   + Copiez directement le texte JSON dans la zone de texte.
   + Collez une URL ou un identifiant de tableau de bord Grafana Labs dans le champ. Pour plus d'informations sur le tableau de bord de grafana.com URLs, consultez la section suivante.
   + (Facultatif) Modifiez les détails du tableau de bord que vous souhaitez modifier.
   + Sélectionnez une source de données, si nécessaire.
   + Choisissez **Importer**.
   + Enregistrez le tableau de bord.

## Trouver des tableaux de bord sur grafana.com
<a name="v10-dash-import-from-grafana"></a>

La page [Tableaux](https://grafana.com/grafana/dashboards/) de bord sur grafana.com vous fournit des tableaux de bord pour les applications serveur courantes. Parcourez une bibliothèque de tableaux de bord officiels et créés par la communauté et importez-les pour être rapidement opérationnels.

**Note**  
Pour importer des tableaux de bord depuis grafana.com, votre espace de travail Amazon Managed Grafana doit avoir accès à Internet.

# Exportation de tableaux de bord
<a name="v10-dash-exporting"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Vous pouvez utiliser l'interface utilisateur de Grafana ou l'API HTTP pour exporter des tableaux de bord.

L'action d'exportation du tableau de bord crée un fichier Grafana JSON contenant tout ce dont vous avez besoin, y compris la mise en page, les variables, les styles, les sources de données, les requêtes, etc., afin que vous puissiez ultérieurement importer le tableau de bord.

**Rendre un tableau de bord portable**

Si vous souhaitez exporter un tableau de bord pour que d'autres utilisateurs puissent l'utiliser, vous pouvez ajouter des variables de modèle pour des éléments tels qu'un préfixe de métrique (utilisez une variable constante) et le nom du serveur.

Une variable de modèle de ce type `Constant` sera automatiquement masquée dans le tableau de bord et sera également ajoutée en tant qu'entrée obligatoire lors de l'importation du tableau de bord.

**Pour exporter un tableau de bord**

1. Ouvrez le tableau de bord que vous souhaitez exporter.

1. Sélectionnez l'icône de partage.

1. Cliquez sur **Exporter**.

1. Choisissez **Enregistrer dans un fichier.**

**Note**  
Grafana télécharge un fichier JSON sur votre machine locale. 

# Modification des paramètres du tableau de bord
<a name="v10-dash-modify-settings"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

La page des paramètres du tableau de bord vous permet de :
+ Modifiez les propriétés générales du tableau de bord, y compris les paramètres horaires.
+ Ajoutez des requêtes d'annotation.
+ Ajoutez des variables de tableau de bord.
+ Ajoutez des liens.
+ Afficher le modèle JSON du tableau de bord

**Pour accéder à la page de configuration du tableau de bord**

1. Ouvrez un tableau de bord en mode édition.

1. Cliquez sur **Paramètres du tableau de bord** (icône en forme de roue dentée) en haut de la page.

**Modification des paramètres horaires du tableau de bord**

Ajustez les paramètres horaires du tableau de bord lorsque vous souhaitez modifier le fuseau horaire du tableau de bord, l'heure du navigateur local et spécifier des intervalles de temps d'actualisation automatique.

**Pour modifier les paramètres horaires du tableau de bord**

1. Sur la page des paramètres du **tableau** de bord, sélectionnez **Général**.

1. Accédez à la section **Options temporelles**.

1. Spécifiez les paramètres horaires conformément aux descriptions suivantes.

1. 
   + **Fuseau horaire** — Spécifiez le fuseau horaire local du service ou du système que vous surveillez. Cela peut être utile lors de la surveillance d'un système ou d'un service qui fonctionne sur plusieurs fuseaux horaires.
     + **Par défaut** — Grafana utilise le fuseau horaire sélectionné par défaut pour le profil utilisateur, l'équipe ou l'organisation. Si aucun fuseau horaire n'est spécifié pour le profil utilisateur, l'équipe dont l'utilisateur est membre ou l'organisation, Grafana utilise l'heure locale du navigateur.
     + **Heure locale du navigateur** : le fuseau horaire configuré pour le navigateur de l'utilisateur qui consulte est utilisé. Il s'agit généralement du même fuseau horaire que celui défini sur l'ordinateur.
     + Utilisez les [fuseaux horaires standard ISO 8601](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), y compris l'UTC.
   + **Actualisation automatique** : personnalisez les options affichées pour le temps relatif et les options d'actualisation automatique. Les entrées sont séparées par des virgules et acceptent toute unité de temps valide.
   + **Retard actuel** : remplacez l'`now`heure en saisissant un délai. Utilisez cette option pour tenir compte des délais connus dans l'agrégation des données afin d'éviter les valeurs nulles.
   + **Masquer le sélecteur de temps** : sélectionnez cette option si vous ne souhaitez pas que le tableau de bord affiche le sélecteur de temps.

**Note**  
Pour pouvoir contrôler le temps, vos données doivent inclure une colonne horaire. Consultez la documentation de votre [source de données](AMG-data-sources.md) spécifique pour plus d'informations sur l'inclusion d'une colonne de temps.

**Ajouter une requête d'annotation**

Une requête d'annotation est une requête qui demande des événements. Ces événements peuvent être visualisés sous forme de graphiques sur le tableau de bord sous forme de lignes verticales accompagnées d'une petite icône que vous pouvez survoler pour afficher les informations relatives à l'événement.

**Pour ajouter une requête d'annotation**

1. Sur la page des **paramètres du tableau** de bord, sélectionnez **Annotations.**

1. Sélectionnez **Ajouter une requête d'annotation**. 

1. Entrez un nom et sélectionnez une source de données.

1. Complétez le reste du formulaire pour créer une requête et une annotation.

L'interface utilisateur de l'éditeur de requêtes change en fonction de la source de données que vous sélectionnez. Consultez la documentation sur les [sources de données](AMG-data-sources.md) pour savoir comment créer une requête. Ou, pour les plugins de source de données que vous installez à partir du[Trouvez des plugins avec le catalogue de plugins](grafana-plugins.md#plugin-catalog), vous pouvez utiliser la [documentation sur le site Web de Grafana Labs](https://grafana.com/docs/grafana/v10.3/datasources/).

**Ajouter une variable**

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.

Pour plus d'informations sur les variables, consultez la section [Variables](v10-dash-variables.md).

**Pour ajouter une variable**

1. Sur la page des **paramètres du tableau de bord**, cliquez sur **Variable** dans le menu de gauche, puis sur le bouton **Ajouter une variable**.

1. Dans la section **Général**, ajoutez le nom de la variable. Il s'agit du nom que vous utiliserez ultérieurement dans les requêtes.

1. Sélectionnez un **type de** variable.
**Note**  
Le type de variable que vous sélectionnez a un impact sur les champs que vous remplissez sur la page.

1. Définissez la variable et cliquez sur **Mettre à jour**.

**Ajouter un lien**

Les liens du tableau de bord vous permettent de placer des liens vers d'autres tableaux de bord et sites Web directement sous l'en-tête du tableau de bord. Les liens permettent de naviguer facilement vers d'autres tableaux de bord et contenus connexes. 

**Pour ajouter un lien**

1. Sur la page des **paramètres du tableau de bord**, choisissez **Liens** dans le menu de gauche, puis cliquez sur le bouton **Ajouter un lien**.

1. Entrez un titre et dans le champ **Type**, sélectionnez **Tableau de bord** ou **Lien**.

1. Pour ajouter un lien au tableau de bord, ajoutez une balise facultative, sélectionnez l'une des options du lien du tableau de bord, puis cliquez sur **Appliquer**.
**Note**  
L'utilisation de balises crée une liste déroulante dynamique de tableaux de bord dotés tous d'une balise spécifique.

1. Pour ajouter un lien Web, ajoutez une URL et un texte d'infobulle qui s'affichent lorsque l'utilisateur survole le lien, sélectionnez une icône qui apparaît à côté du lien et sélectionnez l'une des options de lien du tableau de bord. 

**Afficher le modèle JSON du tableau de bord**

Un tableau de bord dans Grafana est représenté par un objet JSON, qui stocke les métadonnées d'un tableau de bord. Les métadonnées du tableau de bord incluent les propriétés du tableau de bord, les métadonnées des panneaux, les variables de modèle, les requêtes des panneaux, etc. Les métadonnées JSON définissent le tableau de bord.

Pour afficher un modèle JSON de tableau de bord, sur la page des **paramètres du tableau de bord**, cliquez sur **JSON**.

Pour plus d'informations sur les champs JSON, consultez la section [Champs JSON](v10-dash-dashboard-json-model.md).

# Variables URL du tableau de bord
<a name="v10-dash-dashboard-url-variables"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Grafana peut appliquer des valeurs de variables transmises en tant que paramètres de requête dans le tableau de bord. URLs Pour plus d'informations, consultez [Gérer les liens du tableau de bord](v10-dash-manage-dashboard-links.md) et [les modèles et variables](v10-dash-variables.md).

**Transmission de variables en tant que paramètres de requête**

Grafana interprète les paramètres des chaînes de requête préfixés par des variables dans `var-` le tableau de bord donné.

Par exemple, dans cette URL : 

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

Le paramètre de requête `var-example=value` représente l'exemple de variable de tableau de bord avec une valeur de`value`.

**Transmission de plusieurs valeurs pour une variable**

Pour transmettre plusieurs valeurs, répétez le paramètre de variable une fois pour chaque valeur.

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana interprète `var-example=value1&var-example=value2` comme exemple de variable de tableau de bord avec deux valeurs : et. `value1` `value2`

**Ajouter des variables aux liens du tableau de bord**

Grafana peut ajouter des variables aux liens du tableau de bord lorsque vous les générez à partir des paramètres d'un tableau de bord. Pour plus d'informations et pour savoir comment ajouter des variables, consultez [Gérer les liens du tableau de bord](v10-dash-manage-dashboard-links.md).

**Passer des filtres ad hoc**

Les filtres ad hoc appliquent des filtres de clé ou de valeur à toutes les requêtes métriques qui utilisent une source de données spécifiée. Pour plus d'informations, consultez la section [Filtres ad hoc](v10-dash-variable-add.md#v10-dash-variable-add-adhoc).

Pour transmettre un filtre ad hoc en tant que paramètre de requête, utilisez la syntaxe de variable pour transmettre la variable de filtre ad hoc, et fournissez également la clé, l'opérateur comme valeur et la valeur sous forme de liste séparée par des tubes.

Par exemple, dans cette URL :

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

Le paramètre de requête `var-adhoc=key|=|value` applique le filtre ad hoc configuré en tant que variable de tableau de bord ad hoc à l'aide de la `example_key` clé, de l'`=`opérateur et de la `example_value` valeur.

**Note**  
Lorsque vous partagez URLs avec des filtres ad hoc, n'oubliez pas de coder l'URL. Dans l'exemple ci-dessus, remplacez les tubes (`|`) par `%7C` et l'opérateur d'égalité (`=`) par`%3D`.

**Contrôle de l'intervalle de temps à l'aide de l'URL**

Pour définir la plage horaire d'un tableau de bord, utilisez les `from` paramètres `to``time`,, et de `time.window` requête. Comme il ne s'agit pas de variables, le `var-` préfixe n'est pas nécessaire.

# Gestion des panneaux de bibliothèque
<a name="v10-dash-manage-library-panels"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Un panneau de bibliothèque est un panneau réutilisable que vous pouvez utiliser dans n'importe quel tableau de bord. Lorsque vous modifiez un panneau de bibliothèque, la modification se propage à toutes les instances où le panneau est utilisé. Les panneaux de bibliothèque rationalisent la réutilisation des panneaux sur plusieurs tableaux de bord.

Vous pouvez enregistrer un panneau de bibliothèque dans un dossier à côté des tableaux de bord enregistrés.

**Création d'un panneau de bibliothèque**

Lorsque vous créez un panneau de bibliothèque, le panneau du tableau de bord source est également converti en panneau de bibliothèque. Vous devez enregistrer le tableau de bord d'origine après la conversion d'un panneau.

**Pour créer un panneau de bibliothèque**

1. Ouvrez le panneau que vous souhaitez convertir en panneau de bibliothèque en mode édition.

1. Dans les options d'affichage du panneau, cliquez sur l'option flèche vers le bas pour commencer à modifier la visualisation.

1. Sélectionnez **Panneaux de bibliothèque**, puis **\$1 Créer un panneau de bibliothèque**. Cela ouvre la boîte de dialogue de création.

1. Dans **Nom du panneau Bibliothèque**, entrez le nom que vous souhaitez pour le panneau.

1. Dans **Enregistrer dans le dossier**, sélectionnez le dossier dans lequel enregistrer le panneau de bibliothèque.

1. Sélectionnez le **panneau Créer une bibliothèque** pour enregistrer les modifications apportées à la bibliothèque.

1. Enregistrez le tableau de bord.

Une fois le panneau de bibliothèque créé, vous pouvez le modifier à l'aide de n'importe quel tableau de bord sur lequel il apparaît. Une fois les modifications enregistrées, toutes les instances du panneau de bibliothèque reflètent ces modifications.

Vous pouvez également créer un panneau de bibliothèque directement depuis le menu d'édition de n'importe quel panneau, en sélectionnant **Plus...** puis **Créer un panneau de bibliothèque**.

**Ajouter un panneau de bibliothèque à un tableau de bord**

Ajoutez un panneau de bibliothèque Grafana à un tableau de bord lorsque vous souhaitez fournir des visualisations aux autres utilisateurs du tableau de bord.

**Pour ajouter un panneau de bibliothèque à un tableau de bord**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez **Nouveau**, puis choisissez **Nouveau tableau de bord** dans le menu déroulant.

1. Sur le tableau de bord vide, sélectionnez **\$1 Panneau de bibliothèque d'importation**. Vous verrez la liste des panneaux de votre bibliothèque.

1. Filtrez la liste ou effectuez une recherche pour trouver le panneau que vous souhaitez ajouter.

1. Cliquez sur un panneau pour l'ajouter au tableau de bord.

**Dissociation d'un panneau de bibliothèque**

Dissociez un panneau de bibliothèque lorsque vous souhaitez apporter une modification au panneau sans affecter les autres instances du panneau de bibliothèque.

**Pour dissocier un panneau de bibliothèque**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez les **panneaux Bibliothèque**.

1. Sélectionnez un panneau de bibliothèque utilisé dans différents tableaux de bord.

1. Sélectionnez le panneau dont vous souhaitez dissocier le lien.

1. Sélectionnez le titre du panneau (ou placez le pointeur n'importe où sur le panneau) pour afficher le menu d'actions dans le coin supérieur droit du panneau.

1. Tâche de sélection **Modifier**. Le panneau s'ouvre en mode édition.

1. Sélectionnez **Dissocier** dans le coin supérieur droit de la page.

1. Choisissez **Oui, dissocier**.

**Afficher la liste des panneaux de bibliothèque**

Vous pouvez consulter la liste des panneaux de bibliothèque disponibles et rechercher un panneau de bibliothèque.

**Pour afficher la liste des panneaux de bibliothèque**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez les **panneaux Bibliothèque**. Vous pouvez consulter la liste des panneaux de bibliothèque définis précédemment.

1. Recherchez un panneau de bibliothèque spécifique si vous connaissez son nom. Vous pouvez également filtrer les panneaux par dossier ou par type.

**Supprimer un panneau de bibliothèque**

Supprimez un panneau de bibliothèque lorsque vous n'en avez plus besoin.

**Pour supprimer un panneau de bibliothèque**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez les **panneaux Bibliothèque**.

1. Sélectionnez l'icône de suppression à côté du nom du panneau de bibliothèque pour le panneau que vous souhaitez supprimer.

# Gérer l'historique des versions du tableau de bord
<a name="v10-dash-manage-version-history"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Chaque fois que vous enregistrez une version de votre tableau de bord, une copie de cette version est enregistrée afin que les versions précédentes de votre tableau de bord ne soient pas perdues. Une liste de ces versions est disponible en saisissant les paramètres du tableau de bord, puis en sélectionnant **Versions** dans le menu de gauche.

**Note**  
Les 20 versions les plus récentes d'un tableau de bord sont enregistrées.

La fonction d'historique des versions du tableau de bord vous permet de comparer et de restaurer des versions de tableau de bord précédemment enregistrées.

**Comparaison de deux versions de tableau de bord**

Pour comparer deux versions de tableau de bord, sélectionnez les deux versions dans la liste que vous souhaitez comparer. Cliquez sur **Comparer les versions** pour voir la différence entre les deux versions. Cela fait apparaître la vue des différences de version. Par défaut, vous verrez un résumé textuel des modifications.

Si vous souhaitez voir le diff du JSON brut qui représente votre tableau de bord, vous pouvez le faire en cliquant sur le bouton **Afficher le JSON Diff** en bas.

**Restauration vers une version de tableau de bord précédemment enregistrée**

Si vous devez restaurer une version du tableau de bord précédemment enregistrée, vous pouvez soit sélectionner le bouton **Restaurer** à droite d'une ligne de la liste des versions du tableau de bord, soit sélectionner le** <x>bouton **Restaurer à la version** dans la vue des différences. Si vous sélectionnez l'une de ces options, vous serez invité à confirmer la restauration.

Après la restauration d'une version précédente, une nouvelle version sera créée contenant exactement les mêmes données que la version précédente, mais avec un numéro de version différent. Cela est indiqué dans la **colonne Notes** de la ligne de la nouvelle version du tableau de bord. Cela garantit que les versions précédentes de votre tableau de bord ne sont pas affectées par la modification.

# Gestion des liens du tableau de bord
<a name="v10-dash-manage-dashboard-links"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Vous pouvez utiliser des liens pour naviguer entre les tableaux de bord couramment utilisés ou pour connecter d'autres personnes à vos visualisations. Les liens vous permettent de créer des raccourcis vers d'autres tableaux de bord, panneaux et même vers des sites Web externes.

Grafana prend en charge les liens de tableau de bord, les liens de panneau et les liens de données. Les liens du tableau de bord sont affichés en haut du tableau de bord. Les liens du panneau sont accessibles en cliquant sur une icône dans le coin supérieur gauche du panneau.

**Choix du lien à utiliser**

Commencez par déterminer comment vous naviguez actuellement entre les tableaux de bord. Si vous passez souvent d'un tableau de bord à l'autre et que vous avez du mal à trouver le même contexte dans chacun d'eux, les liens peuvent vous aider à optimiser votre flux de travail.

L'étape suivante consiste à déterminer le type de lien le mieux adapté à votre flux de travail. Même si tous les types de liens de Grafana sont utilisés pour créer des raccourcis vers d'autres tableaux de bord ou des sites Web externes, ils fonctionnent dans des contextes différents.
+ Si le lien concerne la plupart, sinon la totalité des panneaux du tableau de bord, utilisez les liens du tableau de bord.
+ Si vous souhaitez accéder à des panneaux spécifiques, utilisez les liens vers les panneaux.
+ Si vous souhaitez créer un lien vers un site externe, vous pouvez utiliser un lien de tableau de bord ou un lien de panneau.
+ Si vous souhaitez approfondir une série spécifique, ou même une seule mesure, utilisez des liens de données.

**Contrôle de l'intervalle de temps à l'aide d'une URL**

Pour contrôler la plage horaire d'un panneau ou d'un tableau de bord, vous pouvez fournir des paramètres de requête dans l'URL du tableau de bord :
+ `from`définit la limite inférieure de la plage de temps, spécifiée en ms epoch.
+ `to`définit la limite supérieure de la plage de temps, spécifiée en ms epoch.
+ `time`et `time.window` définit une plage de temps allant de `time-time.window/2` à`time+time.window/2`. Les deux paramètres doivent être spécifiés en ms. Par exemple, `?time=1500000000000&time.window=10000` cela donnera une plage de temps de 10 s comprise entre 1499999995000 et 1500000005000.

**Liens du tableau de bord**

Lorsque vous créez un lien vers un tableau de bord, vous pouvez inclure la plage de temps et les variables du modèle actuel pour accéder directement au même contexte dans un autre tableau de bord. Ainsi, vous n'avez pas à vous soucier de savoir si la personne à qui vous envoyez le lien consulte les bonnes données. Pour les autres types de liens, consultez la section [Variables de liaison de données]().

Les liens du tableau de bord peuvent également être utilisés comme raccourcis vers des systèmes externes, par exemple pour signaler un GitHub problème avec le nom du tableau de bord actuel.

Après avoir ajouté un lien au tableau de bord, celui-ci s'affichera dans le coin supérieur droit de votre tableau de bord.

**Ajouter des liens aux tableaux de bord**

Ajoutez des liens vers d'autres tableaux de bord en haut de votre tableau de bord actuel.

**Pour ajouter un lien vers un tableau de bord**

1. Lorsque vous consultez le tableau de bord que vous souhaitez associer, cliquez sur l'engrenage en haut de l'écran pour ouvrir les **paramètres du tableau de bord**.

1. Sélectionnez **Liens**, puis **Ajouter un lien au tableau de bord** ou **Nouveau**.

1. Dans **Type**, sélectionnez les **tableaux de bord.**

1. Sélectionnez les options de lien parmi les options suivantes.
   + **Avec des balises** : entrez des balises pour limiter les tableaux de bord liés à ceux contenant les balises que vous avez saisies. Sinon, Grafana inclut des liens vers tous les autres tableaux de bord.
   + **Sous forme de liste déroulante** — Si vous créez des liens vers de nombreux tableaux de bord, Grafana les affiche par défaut en haut de votre side-by-side tableau de bord. La sélection de cette option et l'ajout d'un titre facultatif feront apparaître les liens dans une liste déroulante.
   + **Plage de temps** : sélectionnez cette option pour inclure la plage horaire du tableau de bord dans le lien. Lorsque l'utilisateur clique sur le lien, le tableau de bord associé s'ouvre avec la plage de temps indiquée déjà définie.
   + **Valeurs des variables** : sélectionnez cette option pour inclure dans le lien les variables de modèle actuellement utilisées comme paramètres de requête. Lorsque l'utilisateur clique sur le lien, tous les modèles correspondants du tableau de bord lié sont définis selon les valeurs du lien. Pour plus d'informations, consultez la section [Variables d'URL du tableau](v10-dash-dashboard-url-variables.md) de bord.
   + **Ouvrir dans un nouvel onglet** : sélectionnez cette option si vous souhaitez que le lien du tableau de bord s'ouvre dans un nouvel onglet ou une nouvelle fenêtre.

1. Cliquez sur **Ajouter**.

**Ajouter un lien URL à un tableau de bord**

Ajoutez un lien vers une URL en haut de votre tableau de bord actuel. Vous pouvez créer un lien vers n'importe quelle URL disponible, y compris les tableaux de bord, les panneaux ou les sites externes. Vous pouvez même contrôler la plage horaire pour vous assurer que l'utilisateur est concentré sur les bonnes données dans Grafana.

**Pour ajouter un lien URL à un tableau de bord**

1. Lorsque vous consultez le tableau de bord que vous souhaitez associer, sélectionnez l'engrenage en haut de l'écran pour ouvrir les **paramètres du tableau de bord**.

1. Sélectionnez **Liens**, puis **Ajouter un lien au tableau de bord** ou **Nouveau**.

1. Dans **Type**, sélectionnez **Lien**.

1. Sélectionnez les options de lien parmi les options suivantes.
   + **URL** — Entrez l'URL vers laquelle vous souhaitez créer un lien. En fonction de la cible, vous souhaiterez peut-être inclure des valeurs de champ.
   + **Titre** — Entrez le titre que le lien doit afficher.
   + **Info-bulle** — Entrez l'infobulle que le lien doit afficher.
   + **Icône** — Choisissez l'icône que vous souhaitez afficher avec le lien.
   + **Plage de temps** : sélectionnez cette option pour inclure la plage horaire du tableau de bord dans le lien. Lorsque l'utilisateur clique sur le lien, le tableau de bord associé s'ouvre avec la plage de temps spécifiée définie.
     + `from`— Définit la limite inférieure de l'intervalle de temps, spécifiée en ms epoch.
     + `to`— Définit la limite supérieure de la plage de temps, spécifiée en ms epoch.
     + `time`et `time.window` — Définissez une plage de temps allant de `time-time.window/2` à`time+time.window/2`. Les deux paramètres doivent être spécifiés en ms. Par exemple, `?time=1500000000000&time.window=10000` cela donnera une plage de temps de 10 s comprise entre 1499999995000 et 1500000005000.
   + **Valeurs des variables** : sélectionnez cette option pour inclure dans le lien les variables de modèle actuellement utilisées comme paramètres de requête. Lorsque l'utilisateur clique sur le lien, tous les modèles correspondants du tableau de bord lié sont définis selon les valeurs du lien.

     Le format de la variable est le suivant :

     ```
     https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2
     ```
   + **Ouvrir dans un nouvel onglet** : sélectionnez cette option si vous souhaitez que le lien du tableau de bord s'ouvre dans un nouvel onglet ou une nouvelle fenêtre

1. Sélectionnez **Ajouter**.

**Mettre à jour un lien de tableau de bord**

Pour modifier ou mettre à jour un lien de tableau de bord existant, suivez cette procédure.

**Pour mettre à jour le lien d'un tableau de bord**

1. Dans **les paramètres du tableau de bord**, sous l'onglet **Liens**, sélectionnez le lien existant que vous souhaitez modifier.

1. Modifiez les paramètres, puis choisissez **Mettre à jour**.

**Dupliquer le lien d'un tableau de bord**

Pour dupliquer un lien de tableau de bord existant, sélectionnez l'icône de duplication à côté du lien existant que vous souhaitez dupliquer.

**Supprimer un lien vers un tableau de bord**

Pour supprimer un lien de tableau de bord existant, sélectionnez l'icône de corbeille à côté du lien que vous souhaitez supprimer.

**Liens vers le panneau**

Chaque panneau peut avoir son propre ensemble de liens qui sont affichés dans le coin supérieur gauche du panneau. Vous pouvez créer un lien vers n'importe quelle URL disponible, y compris les tableaux de bord, les panneaux ou les sites externes. Vous pouvez même contrôler la plage horaire pour vous assurer que l'utilisateur est concentré sur les bonnes données dans Grafana.

Pour voir les liens vers les panneaux disponibles, sélectionnez l'icône située à droite du titre du panneau.
+ **Ajout d'un lien vers** un panneau : Chaque panneau peut avoir son propre ensemble de liens qui sont affichés dans le coin supérieur gauche du panneau. Vous pouvez créer un lien vers n'importe quelle URL disponible, y compris les tableaux de bord, les panneaux ou les sites externes. Vous pouvez même contrôler la plage horaire pour vous assurer que l'utilisateur est concentré sur les bonnes données dans Grafana. Cliquez sur l'icône située dans le coin supérieur gauche d'un panneau pour voir les liens vers les panneaux disponibles.

  1. Passez le curseur sur le panneau auquel vous souhaitez ajouter un lien.

  1. Sélectionnez le menu, puis choisissez **Modifier**, ou vous pouvez utiliser le raccourci clavier`e`.

  1. Développez la section des **options du panneau** et faites défiler la page vers le bas jusqu'aux **liens du panneau**.

  1. Sélectionnez **Ajouter un lien**.

  1. Entrez un **titre**. Il s'agit d'une étiquette lisible par l'homme pour le lien qui sera affiché dans l'interface utilisateur.

  1. Entrez l'**URL** vers laquelle vous souhaitez créer un lien. Appuyez sur `Ctrl+Space` (ou`Cmd+Space`) et sélectionnez le champ URL pour voir les variables disponibles. En ajoutant des variables de modèle au lien de votre panneau, le lien renvoie l'utilisateur vers le bon contexte, les variables pertinentes étant déjà définies.

     Vous pouvez également utiliser des variables temporelles.
     + `from`définit la limite inférieure de la plage de temps, spécifiée en ms epoch.
     + `to`définit la limite supérieure de la plage de temps, spécifiée en ms epoch.
     + `time`et `time.window` définit une plage de temps allant de `time-time.window/2` à`time+time.window/2`. Les deux paramètres doivent être spécifiés en ms. Par exemple, les `?time=1500000000000&time.window=10000` résultats indiquent une plage de temps de 10 s comprise entre 1499999995000 et 1500000005000.
+ **Mettre à jour le lien d'un panneau**

  1. Sélectionnez un panneau (ou placez le curseur sur le panneau) pour afficher un menu d'actions en haut à droite du panneau.

  1. Dans le menu, sélectionnez **Modifier**.

     Vous pouvez également utiliser le raccourci clavier,`e`.

  1. Développez la section des **options du panneau** et faites défiler la page vers le bas jusqu'aux **liens du panneau**.

  1. Recherchez le lien que vous souhaitez modifier, puis sélectionnez l'icône **Modifier** (crayon) à côté de celui-ci.

  1. Apportez toutes les modifications nécessaires.

  1. Sélectionnez **Enregistrer** pour enregistrer les modifications et fermer la fenêtre.

  1. Enregistrez les modifications apportées à votre tableau de bord en sélectionnant **Enregistrer** dans le coin supérieur droit.
+ **Supprimer un lien vers un panneau**

  1. Sélectionnez un panneau (ou placez le curseur sur le panneau) pour afficher un menu d'actions en haut à droite du panneau.

  1. Dans le menu, sélectionnez **Modifier**.

     Vous pouvez également utiliser le raccourci clavier,`e`.

  1. Développez la section des **options du panneau** et faites défiler la page vers le bas jusqu'aux **liens du panneau**.

  1. Recherchez le lien que vous souhaitez supprimer, puis sélectionnez l'icône **X** à côté de celui-ci.

  1. Sélectionnez **Enregistrer** dans le coin supérieur droit pour enregistrer les modifications apportées au tableau de bord.

# Annotez les visualisations
<a name="v10-dash-annotations"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Les annotations permettent de marquer des points sur une visualisation à l'aide d'événements riches. Ils sont visualisés sous forme de lignes verticales et d'icônes sur tous les panneaux graphiques. Lorsque vous survolez une annotation, vous pouvez obtenir la description de l'événement et les balises de l'événement. Le champ de texte peut inclure des liens vers d'autres systèmes plus détaillés.

Vous pouvez annoter les visualisations de trois manières :
+ Directement dans le panneau, à l'aide de la [requête d'annotations intégrée](#v10-dash-built-in-query).
+ Utilisation de l'API HTTP de Grafana.
+ Configuration des requêtes d'annotation dans les paramètres du tableau de bord.

Dans les deux premiers cas, vous créez de nouvelles annotations, tandis que dans le dernier, vous interrogez des annotations existantes à partir de sources de données. La requête d'annotation intégrée prend également cela en charge.

Cette section explique les première et troisième options ; pour plus d'informations sur l'utilisation de l'API HTTP Grafana, reportez-vous à. [API d'annotations](Grafana-API-Annotations.md)

Les annotations sont prises en charge pour les types de visualisation suivants :
+ Séries chronologiques 
+ Chronologie de l'État
+ Candlestick (Chandelier)

## Création d'annotations dans des panneaux
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana permet d'ajouter des événements d'annotation directement à partir d'un panneau à l'aide de la [requête d'annotations intégrée](#v10-dash-built-in-query) qui existe sur tous les tableaux de bord. Les annotations que vous créez de cette manière sont stockées dans Grafana.

Pour ajouter des annotations directement dans le panneau :
+ Le tableau de bord doit déjà être enregistré.
+ La requête intégrée doit être activée.

**Pour ajouter une annotation**

1. Dans le tableau de bord, sélectionnez le panneau dans lequel vous souhaitez ajouter l'annotation. Un menu contextuel s'affichera. 

1. Dans le menu contextuel, sélectionnez **Ajouter une annotation**.

1. (Facultatif) Ajoutez une description de l'annotation et des balises.

1. Cliquez sur **Enregistrer**.

Sinon, pour ajouter une annotation, appuyez sur `Ctrl` (ou`Cmd`) pendant que vous sélectionnez le panneau, et la fenêtre **contextuelle Ajouter une annotation** apparaîtra.

**Annotations régionales**

Vous pouvez également créer des annotations qui couvrent une région ou une période dans une visualisation.

**Pour ajouter une annotation de région**

1. Dans le tableau de bord, appuyez sur `Ctrl` (ou`Cmd`) tout en sélectionnant une zone du panneau.

1.  Ajoutez une description de l'annotation et des balises (facultatif). 

1.  Cliquez sur **Sauvegarder** 

**Pour modifier une annotation**

1. Dans le tableau de bord, survolez un indicateur d'annotation sur un panneau.

1. Sélectionnez l'icône **Modifier** (crayon) dans l'infobulle d'annotation.

1. Modifiez les and/or balises de description.

1. Cliquez sur **Enregistrer**.

**Pour supprimer une annotation**

1. Dans le tableau de bord, survolez un indicateur d'annotation sur un panneau.

1. Sélectionnez l'icône **Supprimer** (corbeille) dans l'infobulle d'annotation.

## Récupérez les annotations via les paramètres du tableau de bord
<a name="v10-dash-fetch-annotations"></a>

Dans les paramètres du tableau de bord, sous **Annotations**, vous pouvez ajouter de nouvelles requêtes pour récupérer des annotations à l'aide de n'importe quelle source de données, y compris la source de données d'annotation de données intégrée. Les requêtes d'annotation renvoient des événements qui peuvent être visualisés sous forme de marqueurs d'événements dans les graphiques du tableau de bord. 

**Pour ajouter une nouvelle requête d'annotation**

1. Sélectionnez l'icône **Paramètres** (engrenage) dans l'en-tête du tableau de bord pour ouvrir le menu des paramètres.

1. Sélectionnez **Annotations.**

1. Cliquez sur **Ajouter une requête d'annotation**.

1. Entrez le nom de la requête d'annotation.

   Ce nom est donné au bouton (case à cocher) qui vous permettra d'activer l'affichage des événements d'annotation issus de cette requête. 

1. Sélectionnez la source de données pour les annotations.

   Vous pouvez également choisir **Ouvrir le sélecteur de source de données avancé** pour voir d'autres options, notamment l'ajout d'une nouvelle source de données (disponible uniquement pour les administrateurs).

1. Si vous ne souhaitez pas utiliser la requête d'annotation immédiatement, décochez la case **Activé**.

1. Si vous ne souhaitez pas que le bouton de requête d'annotation soit affiché dans le tableau de bord, cochez la case **Masqué**.

1. Sélectionnez une couleur pour les marqueurs d'événements.

1. Dans le menu déroulant **Afficher dans**, choisissez l'une des options suivantes :
   + **Tous les panneaux — Les** annotations sont affichées sur tous les panneaux qui prennent en charge les annotations.
   + **Panneaux sélectionnés** : les annotations sont affichées sur tous les panneaux que vous sélectionnez.
   + **Tous les panneaux sauf** : les annotations sont affichées sur tous les panneaux sauf ceux que vous sélectionnez.

1. Configurez la requête.

   Les options de requête d'annotation sont différentes pour chaque source de données. Pour plus d'informations sur les annotations dans une source de données spécifique, consultez[Connexion aux sources de données](AMG-data-sources.md).

## Requête intégrée
<a name="v10-dash-built-in-query"></a>

Une fois que vous avez ajouté une annotation, elle sera toujours visible. Cela est dû à la requête d'annotation intégrée qui existe sur tous les tableaux de bord. Cette requête d'annotation récupérera tous les événements d'annotation provenant du tableau de bord actuel, qui sont stockés dans Grafana, et les affichera sur le panneau où ils ont été créés. Cela inclut les annotations de l'historique de l'état des alertes.

Par défaut, la requête d'annotation intégrée utilise la source de données `Grafana` spéciale, et les annotations manuelles ne sont prises en charge qu'avec cette source de données. Vous pouvez utiliser une autre source de données dans la requête d'annotation intégrée, mais vous ne pourrez créer des annotations automatisées qu'à l'aide de l'éditeur de requêtes correspondant à cette source de données.

Pour ajouter des annotations directement au tableau de bord, cette requête doit être activée.

**Pour confirmer que la requête intégrée est activée**

1. Sélectionnez l'icône des **paramètres** du tableau de bord (engrenage) dans l'en-tête du tableau de bord pour ouvrir le menu des paramètres du tableau de bord.

1. Sélectionnez **Annotations.** 

1. Trouvez la requête **Annotations et alertes (intégrée)**.

   S'il est **indiqué Désactivé** avant le nom de la requête, vous devrez sélectionner le nom de la requête pour l'ouvrir et mettre à jour le paramètre.

**Pour empêcher les annotations d'être extraites et dessinées**

1. Sélectionnez l'icône des **paramètres** du tableau de bord (engrenage) dans l'en-tête du tableau de bord pour ouvrir le menu des paramètres du tableau de bord.

1. Sélectionnez **Annotations.** 

1. Sélectionnez la requête **Annotations et alertes (intégrée)**.

1. Sélectionnez le bouton **Activé** pour le désactiver.

Lorsque vous copiez un tableau de bord à l'aide de la fonctionnalité **Enregistrer sous**, il obtient un nouvel identifiant de tableau de bord, de sorte que les annotations créées sur le tableau de bord source ne seront plus visibles sur la copie. Vous pouvez toujours les afficher si vous ajoutez une nouvelle **requête d'annotation** et que vous filtrez par balises. Toutefois, cela ne fonctionne que si les annotations du tableau de bord source contenaient des balises à filtrer.

**Filtrer les requêtes par tag**

Vous pouvez créer de nouvelles requêtes pour récupérer des annotations à partir de la requête d'annotation intégrée à l'aide de la source de `Grafana` données en définissant **Filter by** sur. `Tags`

Par exemple, créez un nom de requête d'annotation `outages` et spécifiez une balise`outage`. Cette requête affichera toutes les annotations (depuis n'importe quel tableau de bord ou via une API) avec le `outage` tag. Si plusieurs balises sont définies dans une requête d'annotation, Grafana n'affichera que les annotations correspondant à toutes les balises. Pour modifier le comportement, activez **Match any**, et Grafana affichera les annotations contenant l'une des balises que vous avez fournies.

 Vous pouvez également utiliser des variables de modèle dans la requête de balise. Cela signifie que si vous disposez d'un tableau de bord affichant les statistiques de différents services et d'une variable de modèle qui indique les services à afficher, vous pouvez utiliser la même variable de modèle dans votre requête d'annotation pour n'afficher que les annotations relatives à ces services. 

# Modèle JSON du tableau de bord
<a name="v10-dash-dashboard-json-model"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Un tableau de bord dans Grafana est représenté par un objet JSON, qui stocke les métadonnées de son tableau de bord. Les métadonnées du tableau de bord incluent les propriétés du tableau de bord, les métadonnées des panneaux, les variables de modèle et les requêtes des panneaux.

**Pour afficher le JSON d'un tableau de bord**

1. Accédez à un tableau de bord.

1. Dans le menu de navigation supérieur, sélectionnez l'icône des **paramètres du tableau** de bord (engrenage).

1. Sélectionnez le **modèle JSON**.

## champs JSON
<a name="v10-dash-json-fields"></a>

Lorsqu'un utilisateur crée un nouveau tableau de bord, un nouvel objet JSON de tableau de bord est initialisé avec les champs suivants.

**Note**  
Dans le JSON suivant, id est affiché sous la forme null, qui est la valeur par défaut qui lui est attribuée jusqu'à ce qu'un tableau de bord soit enregistré. Une fois le tableau de bord enregistré, une valeur entière est attribuée au `id` champ.

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

Ce qui suit décrit chaque champ du JSON du tableau de bord.


| Name | Usage | 
| --- | --- | 
| `id` | identifiant numérique unique pour le tableau de bord (généré par la base de données) | 
| `uid` | identifiant de tableau de bord unique pouvant être généré par n'importe qui. String (8-40) | 
| `title` | titre actuel du tableau de bord | 
| `tags` | balises associées au tableau de bord, un tableau de chaînes | 
| `style` | thème du tableau de bord, tel que `dark` ou `light` | 
| `timezone` | fuseau horaire du tableau de bord, tel que `utc` ou `browser` | 
| `editable` | si un tableau de bord est modifiable ou non | 
| `graphTooltip` | 0 pour aucun réticule ou infobulle partagé (par défaut), 1 pour un réticule partagé, 2 pour un réticule partagé et une infobulle partagée | 
| `time` | plage de temps pour le tableau de bord, telle que `last 6 hours` ou `last 7 days` | 
| `timepicker` | métadonnées du timepicker, voir la section [timepicker](#v10-dash-json-panels) pour plus de détails | 
| `templating` | modélisation des métadonnées, voir la [section relative aux modèles pour plus de détails](#v10-dash-json-panels) | 
| `annotations` | métadonnées des annotations, voir les [annotations](v10-dash-annotations.md) pour savoir comment les ajouter | 
| `refresh` | intervalle de rafraîchissement automatique | 
| `schemaVersion` | version du schéma JSON (entier), incrémentée chaque fois qu'une mise à jour de Grafana apporte des modifications à ce schéma | 
| `version` | version du tableau de bord (entier), incrémentée à chaque mise à jour du tableau de bord | 
| `panels` | matrice de panneaux (voir la section suivante pour plus de détails) | 

## Panneaux
<a name="v10-dash-json-panels"></a>

Les panneaux sont les éléments de base d'un tableau de bord. Il comprend des requêtes de source de données, des types de graphes, des alias, etc. Le panneau JSON se compose d'un tableau d'objets JSON, chacun représentant un panneau différent. La plupart des champs sont communs à tous les panneaux, mais certains champs dépendent du type de panneau. Voici un exemple de panneau JSON d'un panneau de texte.

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**Taille et position du panneau**

La propriété GridPos décrit la taille et la position du panneau en coordonnées de la grille.
+ `w`— 1 à 24 (la largeur du tableau de bord est divisée en 24 colonnes)
+ `h`— En unités de hauteur de grille, chacune représente 30 pixels.
+ `x`— La position x, dans la même unité que`w`.
+ `y`— La position y, dans la même unité que`h`.

La grille a une gravité négative qui déplace les panneaux vers le haut s'il y a un espace vide au-dessus d'un panneau.

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**Création de modèles**

Le `templating` champ contient un tableau de variables de modèle avec leurs valeurs enregistrées ainsi que d'autres métadonnées.

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

Le tableau suivant décrit l'utilisation des champs de création de modèles.


| Name | Usage | 
| --- | --- | 
|  `enable`  |  si la création de modèles est activée ou non  | 
|  `list`  |  un tableau d'objets représentant chacun une variable de modèle  | 
|  `allFormat`  |  format à utiliser lors de la récupération de toutes les valeurs de la source de données, y compris`wildcard`,`glob`,`regex`,`pipe`.  | 
|  `current`  |  affiche la variable actuellement sélectionnée text/value sur le tableau de bord  | 
|  `datasource`  |  affiche la source de données pour les variables  | 
|  `includeAll`  |  si toutes les options de valeur sont disponibles ou non  | 
|  `multi`  |  si plusieurs valeurs peuvent être sélectionnées ou non dans la liste des valeurs variables  | 
|  `multiFormat`  |  format à utiliser lors de la récupération de séries temporelles à partir d'une source de données  | 
|  `name`  |  nom de la variable  | 
|  `options`  |  tableau de text/value paires de variables disponibles à la sélection sur le tableau de bord  | 
|  `query`  |  requête de source de données utilisée pour récupérer les valeurs d'une variable  | 
|  `refresh`  |  configure quand actualiser une variable  | 
|  `regex`  |  extrait une partie d'un nom de série ou d'un segment de nœud métrique  | 
|  `type`  |  type de variable `custom``query`, ou `interval`  | 

# Bonnes pratiques pour les tableaux de bord
<a name="v10-dash-bestpractices"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Cette section fournit des informations sur les meilleures pratiques pour les administrateurs et les utilisateurs de Grafana concernant la création et la maintenance des tableaux de bord Grafana.

Pour plus d'informations sur les différents types de tableaux de bord que vous pouvez créer, consultez les [tableaux de bord Grafana : un guide complet des différents types d'articles de blog que vous pouvez créer sur le](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) site Web de Grafana Labs.

**Note**  
Cette section peut vous aider à créer une stratégie pour la surveillance et la maintenance de votre tableau de bord. C'est vous qui connaissez le mieux vos systèmes et vous devriez utiliser cette section pour vous aider à mieux comprendre. En fin de compte, il est de votre responsabilité de créer la meilleure stratégie pour votre système.

## Stratégies d'observabilité communes
<a name="v10-dash-common-observability-strategies"></a>

Lorsque vous avez beaucoup de choses à surveiller, comme un parc de serveurs, vous avez besoin d'une stratégie pour déterminer ce qui est suffisamment important à surveiller. Cette page décrit plusieurs méthodes courantes pour choisir les éléments à surveiller.

Une stratégie logique vous permet de créer des tableaux de bord uniformes et de faire évoluer votre plateforme d'observabilité plus facilement.

**Lignes directrices pour les stratégies**
+ La méthode USE vous indique dans quelle mesure vos machines sont satisfaites, la méthode RED vous indique dans quelle mesure vos utilisateurs sont satisfaits.
+ Utilisez des rapports sur les causes des problèmes.
+ RED rend compte de l'expérience utilisateur et est plus susceptible de signaler des symptômes de problèmes.
+ Il est important de surveiller les deux pour comprendre votre système. La meilleure pratique consiste à attirer l'attention sur les symptômes plutôt que sur les causes. Généralement, les alertes sont configurées sur les tableaux de bord RED.

**Méthode USE**

USE est l'abréviation de :
+ **Utilisation** : pourcentage de temps pendant lequel la ressource est occupée, tel que l'utilisation du processeur du nœud.
+ **Saturation** : quantité de travail qu'une ressource doit effectuer, souvent la longueur de la file d'attente ou la charge des nœuds.
+ **Erreurs** — Nombre d'événements d'erreur.

Cette méthode est idéale pour les ressources matérielles de l'infrastructure, telles que le processeur, la mémoire et les périphériques réseau. Pour plus d'informations, consultez le billet de blog de Brendan Gregg, [The](http://www.brendangregg.com/usemethod.html) USE Method.

**Méthode RED**

RED est l'abréviation de :
+ **Taux** — Demandes par seconde
+ **Erreurs** : nombre de demandes qui ont échoué.
+ **Durée — Durée** de ces demandes, distribution des mesures de latence.

Cette méthode est particulièrement applicable aux services, en particulier à un environnement de microservices. Pour chacun de vos services, instrumentez le code pour exposer ces métriques pour chaque composant. Les tableaux de bord RED sont bons pour alerter et. SLAs Un tableau de bord RED bien conçu est un indicateur de l'expérience utilisateur.

Pour plus d'informations, consultez le billet de blog de Tom Wilkie [The RED method : How to instrument your services](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services).

**Les quatre signaux d'or**

Selon le [manuel SRE de Google](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals), si vous ne pouvez mesurer que quatre indicateurs de votre système orienté utilisateur, concentrez-vous sur ces quatre indicateurs.

Cette méthode est similaire à la méthode RED, mais elle inclut la saturation.
+ **Latence** : temps nécessaire pour répondre à une demande.
+ **Trafic** : niveau de demande imposé à votre système.
+ **Erreurs** : taux de demandes qui échouent.
+ **Saturation** — Le niveau de « saturation » de votre système,

## Modèle de maturité de gestion des tableaux de bord
<a name="v10-dash-management-maturity-model"></a>

*La maturité de la gestion des tableaux de bord* fait référence à la qualité de la conception et à l'efficacité de votre écosystème de tableaux de bord. Nous vous recommandons de revoir régulièrement la configuration de votre tableau de bord pour évaluer où vous en êtes et comment vous pouvez vous améliorer.

D'une manière générale, la maturité du tableau de bord peut être définie comme faible, moyenne ou élevée. 

 Une grande partie du contenu de ce sujet est tirée de la conférence [Fool-Proof Kubernetes](https://www.youtube.com/watch?v=YE2aQFiMGfY) Dashboards for Sleep-Privated Oncalls de KubeCon 2019. 

**Faible — état par défaut**

À ce stade, vous ne disposez d'aucune stratégie cohérente de gestion des tableaux de bord. Presque tout le monde commence ici.

Comment peux-tu savoir que tu es là ?
+ Tout le monde peut modifier vos tableaux de bord.
+ Beaucoup de tableaux de bord copiés, peu ou pas de réutilisation des tableaux de bord.
+ Des tableaux de bord uniques qui traînent pour toujours.
+ Aucun contrôle de version (tableau de bord JSON dans le contrôle de version).
+ Beaucoup de recherches de tableaux de bord, de recherche du bon tableau de bord. Cela signifie beaucoup de temps perdu à essayer de trouver le tableau de bord dont vous avez besoin.
+ Ne pas avoir d'alertes pour vous diriger vers le bon tableau de bord.

**Tableaux de bord moyens et méthodiques**

À ce stade, vous commencez à gérer l'utilisation de votre tableau de bord à l'aide de tableaux de bord méthodiques. Vous avez peut-être élaboré une stratégie, mais il y a certaines choses que vous pourriez améliorer.

 Comment peux-tu savoir que tu es là ? 
+ Empêchez l'étalement en utilisant des variables de modèle. Par exemple, vous n'avez pas besoin d'un tableau de bord distinct pour chaque nœud, vous pouvez utiliser des variables de requête. Mieux encore, vous pouvez également faire de la source de données une variable de modèle, afin de pouvoir réutiliser le même tableau de bord sur différents clusters et backends de surveillance.

  Reportez-vous à la liste d'exemples présentée dans[Variables](v10-dash-variables.md), pour des idées.
+ Tableaux de bord méthodiques selon une stratégie d'[observabilité](#v10-dash-common-observability-strategies).
+ Tableaux de bord hiérarchiques avec accès au niveau suivant.
+ La conception du tableau de bord reflète les hiérarchies de services. Par exemple, vous pouvez utiliser la méthode RED avec une ligne par service. L'ordre des lignes peut refléter le flux de données lorsque vous faites défiler le tableau de bord vers le bas.
+ Comparez comme par exemple : divisez les tableaux de bord des services lorsque l'ampleur diffère. Assurez-vous que les statistiques agrégées ne masquent pas les informations importantes.
+ Des graphiques expressifs avec une utilisation significative des couleurs et des axes normalisés là où vous le pouvez.
  + Exemple de couleur significative : le bleu signifie que c'est bon, le rouge signifie que c'est mauvais. [Les seuils](v10-panels-configure-thresholds.md) peuvent y contribuer.
  + Exemple d'axes de normalisation : lorsque vous comparez l'utilisation du processeur, mesurez en pourcentage plutôt qu'en nombre brut, car les machines peuvent avoir un nombre de cœurs différent. La normalisation de l'utilisation du processeur en fonction du nombre de cœurs réduit la charge cognitive, car le spectateur peut être sûr qu'à 100 %, tous les cœurs sont utilisés, sans avoir à connaître le nombre de CPUs cœurs.
+ La navigation dirigée permet de réduire le nombre de devinettes.
  + Les variables du modèle compliquent la navigation aléatoire ou sans but.
  + La plupart des tableaux de bord doivent être liés par des alertes.
  + La navigation est dirigée par des liens. Pour de plus amples informations, veuillez consulter [Gestion des liens du tableau de bord](v10-dash-manage-dashboard-links.md).
+  Tableau de bord JSON contrôlé par version. 

**Utilisation hautement optimisée**

À ce stade, vous avez optimisé l'utilisation de la gestion de votre tableau de bord grâce à une stratégie cohérente et réfléchie. Cela demande de la maintenance, mais les résultats en valent la peine.
+ Réduire activement l'étalement.
  + Passez régulièrement en revue les tableaux de bord existants pour vous assurer qu'ils sont toujours pertinents.
  + Seuls les tableaux de bord approuvés sont ajoutés à la liste des tableaux de bord principaux.
  + Suivi de l'utilisation du tableau de bord. Vous pouvez tirer parti des [informations sur l'utilisation](v10-dash-assess-dashboard-usage.md).
+ Cohérence dès le design.
+ Utilisez des bibliothèques de scripts pour générer des tableaux de bord et garantir la cohérence du modèle et du style.
  + grafonnet (Jsonnet)
  + grafanalib (Python)
+ Aucune modification dans le navigateur. Les utilisateurs du tableau de bord changent de vue à l'aide de variables.
+ La recherche de tableaux de bord est l'exception, pas la règle.
+ Effectuez des expérimentations et des tests dans une instance Grafana distincte dédiée à cet effet, et non dans votre instance de production. Lorsqu'un tableau de bord dans l'environnement de test s'avère utile, ajoutez-le à votre instance Grafana principale.

## Bonnes pratiques pour créer des tableaux de bord
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

Cette section décrit certaines des meilleures pratiques à suivre lors de la création de tableaux de bord Grafana.

**Avant de commencer**

 Voici quelques principes à prendre en compte avant de créer un tableau de bord. 

**Un tableau de bord doit raconter une histoire ou répondre à une question**

Quelle histoire essayez-vous de raconter avec votre tableau de bord ? Essayez de créer une progression logique des données, par exemple de grandes à petites ou de générales à spécifiques. Quel est l'objectif de ce tableau de bord ? (Conseil : si le tableau de bord n'a pas d'objectif, demandez-vous si vous en avez vraiment besoin.)

Utilisez des graphiques simples et concentrez-vous sur la réponse à la question que vous vous posez. Par exemple, si votre question est « Quels sont les serveurs en difficulté ? » , alors vous n'avez peut-être pas besoin d'afficher toutes les données du serveur. Il suffit d'afficher les données des personnes en difficulté.

**Les tableaux de bord devraient réduire la charge cognitive, et non l'augmenter**

La *charge cognitive* est essentiellement la difficulté avec laquelle vous devez réfléchir à quelque chose pour le comprendre. Facilitez l'interprétation de votre tableau de bord. Les autres utilisateurs et vous futurs (lorsque vous essaierez de découvrir ce qui s'est cassé à 2 heures du matin) l'apprécieront.

 Demandez-vous : 
+ Puis-je savoir ce que représente exactement chaque graphique ? Est-ce évident ou dois-je y réfléchir ?
+ Si je le montre à quelqu'un d'autre, combien de temps lui faudra-t-il pour le découvrir ? Vont-ils se perdre ?

**Disposer d'une stratégie de surveillance**

Il est facile de créer de nouveaux tableaux de bord. Il est plus difficile d'optimiser la création de tableaux de bord et de respecter un plan, mais cela en vaut la peine. Cette stratégie doit régir à la fois le schéma global de votre tableau de bord et garantir la cohérence dans la conception de chaque tableau de bord individuel.

Reportez-vous aux [sections Stratégies d'observabilité communes](#v10-dash-common-observability-strategies) et [Niveaux de maturité de la gestion des tableaux de bord](#v10-dash-management-maturity-model) pour plus d'informations.

**Ecrivez-le**

Une fois que vous avez une stratégie ou des directives de conception, notez-les pour maintenir la cohérence au fil du temps.

**Les meilleures pratiques à suivre**
+ Lorsque vous créez un nouveau tableau de bord, assurez-vous qu'il porte un nom significatif.
  + Si vous créez un tableau de bord pour jouer ou expérimenter, inscrivez le mot `TEST` ou `TMP` le nom.
  + Pensez à inclure votre nom ou vos initiales dans le nom du tableau de bord ou sous forme de tag afin que les utilisateurs sachent à qui appartient le tableau de bord.
  + Supprimez les tableaux de bord d'expériences temporaires lorsque vous en avez terminé avec eux.
+ Si vous créez de nombreux tableaux de bord connexes, réfléchissez à la manière de les croiser pour faciliter la navigation. Pour plus d'informations, consultez la section [Meilleures pratiques pour la gestion des tableaux](#v10-dash-best-practices-for-managing-dashboards) de bord, plus loin dans cette section.
+ Grafana récupère les données d'une source de données. Une compréhension de base des sources de données [Connexion aux sources de données](AMG-data-sources.md) en général et de vos sources de données spécifiques est importante.
+ Évitez d'actualiser inutilement le tableau de bord afin de réduire la charge sur le réseau ou le backend. Par exemple, si vos données changent toutes les heures, il n'est pas nécessaire de régler le taux de rafraîchissement du tableau de bord à 30 secondes.
+ Utilisez les axes Y gauche et droit pour afficher des séries chronologiques avec différentes unités ou plages.
+ Ajoutez de la documentation aux tableaux de bord et aux panneaux.
  + Pour ajouter de la documentation à un tableau de bord, ajoutez une [visualisation du panneau de texte](v10-panels-text.md) au tableau de bord. Enregistrez des éléments tels que l'objectif du tableau de bord, les liens vers des ressources utiles et les instructions dont les utilisateurs peuvent avoir besoin pour interagir avec le tableau de bord.
  + Pour ajouter de la documentation à un panneau, modifiez les paramètres du panneau et ajoutez une description. Le texte que vous ajoutez apparaîtra si vous passez le curseur sur le petit `i` coin supérieur gauche du panneau.
+ Réutilisez vos tableaux de bord et renforcez la cohérence en utilisant des [modèles et des variables](v10-dash-variables.md).
+ Soyez prudent lorsque vous empilez des données graphiques. Les visualisations peuvent être trompeuses et masquer des données importantes. Nous recommandons de le désactiver dans la plupart des cas.

## Bonnes pratiques en matière de gestion des tableaux de bord
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 Cette page décrit certaines des meilleures pratiques à suivre lors de la gestion des tableaux de bord Grafana. 

**Avant de commencer**

Voici quelques principes à prendre en compte avant de commencer à gérer des tableaux de bord.

**Observabilité stratégique**

Il existe plusieurs [stratégies d'observabilité courantes](#v10-dash-common-observability-strategies). Vous devez les rechercher et décider si l'un d'entre eux vous convient ou si vous souhaitez créer le vôtre. Quoi qu'il en soit, ayez un plan, notez-le et respectez-le.

Adaptez votre stratégie à l'évolution des besoins si nécessaire.

**Niveau de maturité**

Quel est le niveau de maturité de votre tableau de bord ? Analysez la configuration actuelle de votre tableau de bord et comparez-la au [modèle de maturité de gestion du tableau de bord](#v10-dash-management-maturity-model). Comprendre où vous vous trouvez peut vous aider à décider comment vous rendre là où vous voulez être.

**Les meilleures pratiques à suivre**
+ Évitez l'étalement des tableaux de bord, c'est-à-dire la croissance incontrôlée des tableaux de bord. L'étalement des tableaux de bord a un impact négatif sur le temps nécessaire pour trouver le bon tableau de bord. Dupliquer des tableaux de bord et modifier « une seule chose » (pire encore : conserver les balises d'origine) est le type d'étalement le plus simple.
  + Passez régulièrement en revue les tableaux de bord et supprimez ceux qui ne sont pas nécessaires.
  + Si vous créez un tableau de bord temporaire, par exemple pour tester quelque chose, préfixez le nom avec`TEST:`. Supprimez le tableau de bord lorsque vous avez terminé.
+ Copier des tableaux de bord sans modifications importantes n'est pas une bonne idée.
  + Vous passez à côté des mises à jour du tableau de bord d'origine, telles que des modifications de la documentation, des corrections de bogues ou des ajouts aux indicateurs.
  + Dans de nombreux cas, des copies sont effectuées pour simplement personnaliser la vue en définissant les paramètres du modèle. Cela devrait plutôt être fait en maintenant un lien vers le tableau de bord principal et en personnalisant la vue avec des [paramètres d'URL](v10-panels-configure-data-links.md#v10-panels-data-link-variables).
+ Lorsque vous devez copier un tableau de bord, renommez-le clairement et *ne copiez pas* les balises du tableau de bord. Les balises sont des métadonnées importantes pour les tableaux de bord utilisés lors des recherches. La copie de balises peut entraîner de fausses correspondances.
+ Gérez un tableau de bord composé de tableaux de bord ou de tableaux de bord à références croisées. Cela peut se faire de plusieurs manières : 
  + Créez des liens de tableau de bord, des panneaux ou des liens de données. Les liens peuvent mener à d'autres tableaux de bord ou à des systèmes externes. Pour plus d'informations, reportez-vous à la section [Gérer les liens du tableau de bord](v10-dash-manage-dashboard-links.md).
  +  Ajoutez un [panneau de liste de tableau](v10-panels-dashboard-list.md) de bord. Vous pouvez ensuite personnaliser ce que vous voyez en effectuant des recherches par étiquette ou par dossier.
  + Ajoutez un [panneau de texte](v10-panels-dashboard-list.md) et utilisez le Markdown pour personnaliser l'affichage. 

# Gestion des tableaux de bord
<a name="v10-dash-managing-dashboards"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Sur la page **Tableaux** de bord de votre espace de travail (disponible en sélectionnant **Tableaux** de bord dans le menu de gauche), vous pouvez effectuer des tâches de gestion des tableaux de bord, notamment organiser vos tableaux de bord dans des dossiers.

Pour plus d'informations sur la création de tableaux de bord, consultez[Création de tableaux de bord](v10-dash-building-dashboards.md).

## Parcourez les tableaux de bord
<a name="v10-dash-browse-dashboards"></a>

Sur la page **Tableaux** de bord, vous pouvez parcourir et gérer les dossiers et les tableaux de bord. Cela inclut des options pour :
+ Créez des dossiers et des tableaux de bord.
+ Déplacez les tableaux de bord entre les dossiers.
+ Supprimez plusieurs tableaux de bord et dossiers.
+ Accédez à un dossier.
+ Gérez les autorisations des dossiers. Pour de plus amples informations, veuillez consulter [Autorisations du tableau de bord et des dossiers](dashboard-and-folder-permissions.md).

## Création de dossiers de tableau de bord
<a name="v10-dash-create-dashboard-folder"></a>

Les dossiers vous aident à organiser et à regrouper les tableaux de bord, ce qui est utile lorsque plusieurs tableaux de bord ou plusieurs équipes utilisent la même instance de Grafana. Les sous-dossiers vous permettent de créer une hiérarchie imbriquée dans l'organisation de votre tableau de bord.

**Conditions préalables**

Assurez-vous que vous disposez des autorisations d'administrateur Grafana. Pour plus d'informations sur les autorisations du tableau de bord, consultez[Autorisations du tableau de bord et des dossiers](dashboard-and-folder-permissions.md).

**Pour créer un dossier de tableau de bord**

1. Connectez-vous à Grafana. 

1. Dans le menu de gauche, sélectionnez **Tableaux de bord.**

1. Sur la page **Tableaux** de bord, sélectionnez **Nouveau**, puis sélectionnez **Nouveau dossier** dans le menu déroulant.

1. Entrez un nom unique et cliquez sur **Créer**.

**Note**  
Lorsque vous enregistrez un tableau de bord, vous pouvez soit sélectionner un dossier dans lequel le tableau de bord doit être enregistré, soit créer un nouveau dossier.

**Pour modifier le nom d'un dossier**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez le dossier à renommer

1. Sélectionnez l'icône **Modifier le titre** (crayon) dans l'en-tête et mettez à jour le nom du dossier.

   Le nouveau nom du dossier est automatiquement enregistré.

**Autorisations relatives aux dossiers**

Vous pouvez attribuer des autorisations à un dossier. Le tableau de bord du dossier hérite de toutes les autorisations que vous avez attribuées au dossier. Vous pouvez attribuer des autorisations aux rôles, aux équipes et aux utilisateurs de l'organisation.

**Pour modifier les autorisations associées à un dossier**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez le dossier dans la liste.

1. Sur la page de détails du dossier, sélectionnez **Actions du dossier**, puis sélectionnez **Gérer les autorisations** dans la liste déroulante.

1. Mettez à jour les autorisations comme vous le souhaitez.

Les modifications sont enregistrées automatiquement.

# Gestion des playlists
<a name="v10-dash-managing-playlists"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Une *playlist* est une liste de tableaux de bord affichés dans une séquence. Vous pouvez utiliser une playlist pour améliorer votre connaissance de la situation ou pour présenter vos indicateurs à votre équipe ou à vos visiteurs. Grafana adapte automatiquement les tableaux de bord à n'importe quelle résolution, ce qui les rend parfaits pour les grands écrans. Vous pouvez accéder à la fonction de playlist depuis le menu latéral de Grafana dans le sous-menu **Tableaux de bord**.

## Accès, partage et contrôle d'une playlist
<a name="v10-dash-access-share-control-playlist"></a>

Utilisez les informations de cette section pour accéder aux playlists existantes. Démarrez et contrôlez l'affichage d'une liste de lecture à l'aide de l'un des cinq modes disponibles.

**Pour accéder à une playlist**

1. Sélectionnez **Playlists** dans le menu de gauche.

1. Choisissez une playlist dans la liste des playlists existantes.

**Lancer une playlist**

Vous pouvez démarrer une playlist dans cinq modes d'affichage différents. Le mode d'affichage détermine le mode d'affichage des menus et de la barre de navigation sur les tableaux de bord.

Par défaut, chaque tableau de bord est affiché pendant la durée saisie dans le champ **Intervalle**, que vous définissez lorsque vous créez ou modifiez une playlist. Après avoir lancé une playlist, vous pouvez la contrôler à l'aide de la barre de navigation située en haut de la page.

**Pour démarrer une playlist**

1. Accédez à la page des playlists pour voir la liste des playlists existantes.

1. Recherchez la liste de lecture que vous souhaitez démarrer, puis cliquez sur **Démarrer la liste de lecture**.

   La boîte de dialogue de démarrage de la playlist s'ouvre.

1. Sélectionnez l'un des cinq modes de playlist disponibles en fonction des informations du tableau suivant.

1. Cliquez sur **Démarrer**<playlist name>.

La playlist affiche chaque tableau de bord pendant la durée spécifiée dans le `Interval` champ, définie lors de la création ou de la modification d'une playlist. Après le démarrage d'une playlist, vous pouvez la contrôler à l'aide de la barre de navigation en haut de votre écran.


| Mode | Description | 
| --- | --- | 
| Mode normal |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode TV |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode TV (avec panneaux à ajustement automatique) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode kiosque |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Mode kiosque (avec panneaux à ajustement automatique) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 

**Contrôler une playlist**

Vous pouvez contrôler une playlist en mode **Normal** ou **TV** après son lancement, à l'aide de la barre de navigation en haut de votre écran. Appuyez sur la `Esc` touche de votre clavier pour arrêter la playlist.


| Button | Action | 
| --- | --- | 
| Suivant (double flèche droite) | Passe au tableau de bord suivant. | 
| Retour (flèche gauche) | Retourne au tableau de bord précédent. | 
| Stop (carré) | Termine la playlist et passe au tableau de bord actuel. | 
| Mode d'affichage du cycle (icône du moniteur) | Fait pivoter l'affichage des tableaux de bord dans différents modes d'affichage. | 
| Plage horaire | Affiche les données dans un intervalle de temps. Il peut être configuré pour afficher les 5 dernières minutes jusqu'à il y a 5 ans, ou une plage de temps personnalisée à l'aide de la flèche vers le bas. | 
| Actualiser (flèche circulaire) | Recharge le tableau de bord pour afficher les données actuelles. Il peut être configuré pour se recharger automatiquement toutes les 5 secondes à 1 jour, à l'aide de la flèche déroulante. | 

## Création d'une playlist
<a name="v10-dash-create-playlist"></a>

Vous pouvez créer une liste de lecture pour présenter les tableaux de bord dans une séquence avec un ordre et un intervalle de temps définis entre les tableaux de bord.

**Pour créer une playlist**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez **Playlists** sur la page des playlists.

1. Sélectionnez **Nouvelle playlist**.

1. Entrez un nom descriptif dans la zone de texte **Nom**.

1. Entrez un intervalle de temps dans la zone **de texte Intervalle**. Les tableaux de bord que vous ajoutez sont répertoriés dans un ordre séquentiel.

1. Dans **Tableaux de bord, ajoutez des** tableaux de bord existants à la liste de lecture à l'aide des **options déroulantes Ajouter par titre** et **Ajouter par tag**.

1. Facultativement :
   + Recherchez un tableau de bord à l'aide de son nom, d'une expression régulière ou d'une balise.
   + Filtrez vos résultats par statut ou tags marqués d'un astérisque.
   + Réorganisez l'ordre des tableaux de bord que vous avez ajoutés à l'aide des icônes représentant des flèches vers le haut et vers le bas.
   + Supprimez un tableau de bord de la playlist en cliquant sur l'icône **X** à côté du tableau de bord.

1. Sélectionnez **Enregistrer** pour enregistrer vos modifications.

## Enregistrer une playlist
<a name="v10-dash-save-playlist"></a>

Vous pouvez enregistrer une playlist et l'ajouter à votre page **Playlists**, où vous pouvez la démarrer.

**Important**  
Assurez-vous que tous les tableaux de bord que vous souhaitez voir apparaître dans votre playlist ont été ajoutés lors de la création ou de la modification de la playlist avant de l'enregistrer.

**Pour enregistrer une playlist**

1. Sélectionnez **Tableaux de bord** dans le menu de gauche.

1. Sélectionnez **Playlists** pour afficher les playlists disponibles.

1. Choisissez la playlist de votre choix.

1. Modifiez la playlist.

1. Vérifiez qu'un **nom**, un **intervalle** et au moins un **tableau de bord** ont été ajoutés à la playlist.

1. Sélectionnez **Enregistrer** pour enregistrer vos modifications.

## Modifier ou supprimer une playlist
<a name="v10-dash-edit-delete-playlist"></a>

Vous pouvez modifier une playlist en actualisant son nom, sa durée d'intervalle et en ajoutant, en supprimant et en réorganisant l'ordre des tableaux de bord, ou vous pouvez supprimer la playlist.

**Pour modifier une playlist**

1. Sélectionnez **Modifier la playlist** sur la page de la playlist.

1. Mettez à jour le nom et l'intervalle de temps, puis ajoutez ou supprimez des tableaux de bord de la liste de lecture en suivant les instructions de la section Créer une liste de lecture ci-dessus.

1. Sélectionnez **Enregistrer** pour enregistrer vos modifications.

**Pour supprimer une playlist**

1. Sélectionnez **Playlists**.

1. Sélectionnez **Supprimer** à côté de la playlist que vous souhaitez supprimer.

**Pour réorganiser l'ordre du tableau de bord dans une playlist**

1. À côté du tableau de bord que vous souhaitez déplacer, cliquez sur la flèche vers le haut ou vers le bas.

1. Sélectionnez **Enregistrer** pour enregistrer vos modifications.

**Pour supprimer un tableau de bord**

1. Sélectionnez **Supprimer** pour supprimer un tableau de bord de la playlist.

1. Sélectionnez **Enregistrer** pour enregistrer vos modifications.

## Partage d'une playlist en mode affichage
<a name="v10-dash-share-playlist-view-mode"></a>

Vous pouvez partager une playlist en copiant l'adresse du lien dans le mode d'affichage de votre choix et en collant l'URL vers votre destination.

**Pour partager une playlist en mode affichage**

1. Dans le menu de gauche **des tableaux** de bord, sélectionnez **Playlists**.

1. Sélectionnez **Démarrer la playlist** à côté de la playlist que vous souhaitez partager.

1. Dans le menu déroulant, cliquez avec le bouton droit sur le mode d'affichage que vous préférez.

1. Sélectionnez **Copier l'adresse du lien** pour copier l'URL dans votre presse-papiers.

1. Collez l'URL vers votre destination.

# Partage de tableaux de bord et de panneaux
<a name="v10-dash-sharing"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Grafana vous permet de partager des tableaux de bord et des panneaux avec d'autres utilisateurs au sein d'une organisation et, dans certaines situations, publiquement sur le Web. Vous pouvez partager en utilisant :
+ Un lien direct
+ Un instantané
+ Un lien d'exportation (pour les tableaux de bord uniquement)

Vous devez avoir l'autorisation d'un téléspectateur autorisé pour voir une image rendue par un lien direct.

Lorsque vous partagez un panneau ou un tableau de bord sous forme d'instantané, un instantané (il s'agit d'un panneau ou d'un tableau de bord au moment où vous prenez l'instantané) est accessible au public sur le Web. Toute personne disposant d'un lien peut y accéder. Comme les instantanés ne nécessitent aucune autorisation pour être visualisés, Grafana supprime les informations relatives au compte dont ils proviennent, ainsi que toutes les données sensibles de l'instantané.

## Partage d'un tableau de bord
<a name="v10-dash-share-dashboard"></a>

Vous pouvez partager un tableau de bord sous forme de lien direct ou de capture instantanée. Vous pouvez également exporter un tableau de bord.

**Note**  
Si vous modifiez un tableau de bord, assurez-vous d'enregistrer les modifications avant de les partager.

**Pour partager un tableau de bord**

1. Sélectionnez **Tableaux** de bord dans le menu de gauche de votre espace de travail.

1. Choisissez le tableau de bord que vous souhaitez partager.

1. Sélectionnez l'icône de partage en haut de l'écran.

   La boîte de dialogue de partage s'ouvre et affiche l'onglet **Lien**.

**Partage d'un lien direct**

L'onglet **Lien** affiche la plage horaire actuelle, les variables du modèle et le thème par défaut. Vous pouvez également partager une URL raccourcie.

**Pour partager un lien directement**

1. Sélectionnez **Copier**. Cette action copie l'URL par défaut ou raccourcie dans le presse-papiers.

1. Envoyez l'URL copiée à un utilisateur de Grafana autorisé à consulter le lien.

**Publication d'un instantané**

Un instantané de tableau de bord partage publiquement un tableau de bord interactif. Grafana supprime les données sensibles telles que les requêtes (métriques, modèles et annotations) et les liens des panneaux, ne laissant que les données métriques visibles et les noms de séries intégrés dans le tableau de bord. Les instantanés du tableau de bord sont accessibles à toute personne disposant du lien.

Vous pouvez publier des instantanés sur votre instance locale.

**Pour publier un instantané**

1. Sélectionnez l'onglet **Snapshot**.

1. Sélectionnez le **snapshot local**.

1. Grafana génère un lien vers l'instantané. Copiez le lien du cliché et partagez-le au sein de votre organisation ou publiquement sur le Web.

**Exporter un tableau de bord**

Les tableaux de bord Grafana peuvent être facilement exportés et importés. Pour plus d'informations, consultez les sections d'importation et d'exportation dans[Création de tableaux de bord](v10-dash-building-dashboards.md).

## Partage d'un panel
<a name="v10-dash-share-panel"></a>

Vous pouvez partager un panneau sous forme de lien direct ou de capture d'écran. Vous pouvez également créer des panneaux de bibliothèque à l'aide de l'option **Partager** sur n'importe quel panneau.

**Pour partager un panel**

1. Sélectionnez le titre du panneau que vous souhaitez partager. Le menu du panneau s'ouvre.

1. Sélectionnez **Partager**. La boîte de dialogue de partage s'ouvre et affiche l'onglet **Lien**.

**En utilisant un lien direct**

L'onglet **Lien** affiche la plage horaire actuelle, les variables du modèle et le thème par défaut. Vous pouvez éventuellement activer une URL raccourcie à partager.

**Pour utiliser un lien direct**

1. Sélectionnez **Copier** pour copier l'URL par défaut ou l'URL abrégée dans le presse-papiers. 

1. Envoyez l'URL copiée à un utilisateur de Grafana autorisé à consulter le lien.

**Publication d'un instantané d'un panneau**

Un instantané de panel est un partage public d'un panel interactif. Grafana supprime les données sensibles en ne laissant que les données métriques visibles et les noms de séries intégrés dans le tableau de bord. Les instantanés du panneau sont accessibles à toute personne disposant du lien.

Vous pouvez publier des instantanés sur votre instance locale.

**Pour publier un instantané d'un panneau**

1. Dans la boîte de dialogue **Partager le panneau**, sélectionnez l'onglet **Snapshot**.

1. Sélectionnez **Local Snapshot**. Grafana génère le lien de l'instantané.

1. Copiez le lien du cliché et partagez-le au sein de votre organisation ou publiquement sur le Web.

Si vous avez créé un instantané par erreur, cliquez sur **Supprimer l'instantané** pour le supprimer de votre instance Grafana.

**Création d'un panneau de bibliothèque**

Pour créer un panneau de bibliothèque à partir de la boîte de dialogue **Partager le panneau**.

**Pour créer un panneau de bibliothèque**

1. Sélectionnez le **panneau Bibliothèque**.

1. Dans **Nom du panneau Bibliothèque**, entrez le nom.

1. Dans **Enregistrer dans le dossier**, sélectionnez le dossier dans lequel enregistrer le panneau de bibliothèque. Par défaut, le dossier racine est sélectionné.

1. Sélectionnez le **panneau Créer une bibliothèque** pour enregistrer vos modifications.

1. Enregistrez le tableau de bord.

# Variables
<a name="v10-dash-variables"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.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. 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).
+ Les variables présélectionnent par défaut la valeur la plus élevée dans la liste déroulante. Si vous souhaitez plutôt choisir une valeur vide, modifiez les paramètres des variables comme suit :

  1. Cochez la **case Tout inclure**.

  1. Dans le champ **Personnaliser toutes les valeurs**, entrez la valeur`+`.

**Topics**
+ [Ajouter et gérer des variables](v10-dash-variable-add.md)
+ [Inspecter les variables](v10-dash-variable-add-inspect.md)
+ [Syntaxe variable](v10-dash-variable-syntax.md)

# Ajouter et gérer des variables
<a name="v10-dash-variable-add"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Le tableau suivant répertorie les types de variables dans Grafana.


| 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. | 
| Personnalisé | Définissez les options des variables manuellement à l'aide d'une liste séparée par des virgules. | 
| Zone de texte | Afficher un champ de saisie de texte libre avec une valeur par défaut facultative. | 
| Constant | Définissez une constante cachée. | 
| Source de données | Modifiez rapidement la source de données d'un tableau de bord complet. | 
| Interval | Les variables d'intervalle représentent des intervalles de temps. | 
| Filtres ad hoc | Filtres clé-valeur ajoutés automatiquement à toutes les requêtes métriques pour une source de données (Prometheus, Loki, InfluxDB et Elasticsearch uniquement). | 
| Variables globales | Variables intégrées qui peuvent être utilisées dans les expressions de l'éditeur de requêtes. | 
| Variables enchaînées | Les requêtes de variables peuvent contenir d'autres variables. | 

**Topics**
+ [Saisie des options générales](#v10-dash-variable-options)
+ [Ajouter une variable de requête](#v10-dash-variable-add-query)
+ [Ajouter une variable personnalisée](#v10-dash-variable-add-custom)
+ [Ajouter une variable de zone de texte](#v10-dash-variable-add-text)
+ [Ajouter une variable constante](#v10-dash-variable-add-constant)
+ [Ajouter une variable de source de données](#v10-dash-variable-add-datasource)
+ [Ajouter une variable d'intervalle](#v10-dash-variable-add-internal)
+ [Ajouter des filtres ad hoc](#v10-dash-variable-add-adhoc)
+ [Configurer les options de sélection des variables](#v10-dash-variable-add-selection)
+ [Variables globales](#v10-dash-variable-add-global)
+ [Variables enchaînées](#v10-dash-variable-add-chained)
+ [Gérer les variables](#v10-dash-variable-add-manage)
+ [Filtrer les variables avec regex](#v10-dash-variable-add-filter)

## Saisie des options générales
<a name="v10-dash-variable-options"></a>

Vous devez saisir des options générales pour tous les types de variables que vous créez.

**Pour saisir les options générales**

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

1. Dans l'onglet **Variables**, sélectionnez **Nouvelle variable**.

1. Entrez un **nom** pour la variable.

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

1. (Facultatif) Dans **Label**, entrez le nom d'affichage de la liste déroulante des variables.

   Si vous n'entrez pas de nom d'affichage, le nom de la variable est le nom de la variable dans la liste déroulante.

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.
   + **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.

## Ajouter une variable de requête
<a name="v10-dash-variable-add-query"></a>

Les variables de requête vous permettent d'écrire une requête de source de données qui peut renvoyer 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 variables de requête ne sont généralement prises en charge que pour les chaînes. Si votre requête renvoie des nombres ou tout autre type de données, vous devrez peut-être les convertir en chaînes afin de les utiliser comme variables. Pour la source de données Azure, par exemple, vous pouvez utiliser la fonction [tostring à](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) cette fin.

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

**Note**  
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](AMG-data-sources.md).

**Pour ajouter une variable de requête**

1. Entrez les options générales, comme ci-dessus.

1. Dans la liste **des sources de données**, sélectionnez la source de données cible pour la requête.

1. Dans la liste **Actualiser**, sélectionnez le moment où la variable doit mettre à jour les options.
   + **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. N'utilisez cette option que 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.
   + La requête doit renvoyer les valeurs nommées `__text` et`__value`. Par exemple, dans SQL, vous pouvez utiliser une requête telle que`SELECT hostname AS __text, id AS __value from MyTable`. Les requêtes pour d'autres langues varient en fonction de la syntaxe.
   + Si vous avez besoin de plus d'espace dans un éditeur de requêtes pour un seul champ de saisie, passez votre curseur sur les lignes situées dans le coin inférieur droit du champ et faites-le glisser vers le bas pour 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 voir des exemples, reportez-vous à [Filtrer les variables avec regex](#v10-dash-variable-add-filter).

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](#v10-dash-variable-add-selection).

1. 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.

1. Sélectionnez **Ajouter** pour ajouter la variable au tableau de bord.

## Ajouter une variable personnalisée
<a name="v10-dash-variable-add-custom"></a>

Utilisez une variable *personnalisée* pour une valeur qui ne change pas, telle qu'un nombre ou une chaîne.

Par exemple, si vous avez des noms de serveurs ou de régions qui ne changent jamais, vous souhaiterez peut-être les créer sous forme de variables personnalisées plutôt que sous forme de variables de requête. Comme elles ne changent pas, vous pouvez les utiliser dans des [variables chaînées](#v10-dash-variable-add-chained) 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 ajouter une variable personnalisée**

1. Entrez les options générales, comme ci-dessus.

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 ou des paires clé-valeur séparés par un espace et deux points. Par exemple, `key1 : value1,key2 : value2`.

1. (Facultatif) Entrez les [options de sélection](#v10-dash-variable-add-selection).

1. 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.

1. Sélectionnez **Ajouter** pour ajouter la variable au tableau de bord.

## Ajouter une variable de zone de texte
<a name="v10-dash-variable-add-text"></a>

Les variables de *zone de texte* affichent un champ de saisie de texte libre 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.

**Pour ajouter une variable de zone de texte**

1. Entrez les options générales, comme ci-dessus.

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 les utilisateurs peuvent taper du texte.

1. 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.

1. Sélectionnez **Ajouter** pour ajouter la variable au tableau de bord.

## Ajouter une variable constante
<a name="v10-dash-variable-add-constant"></a>

Les variables *constantes* vous permettent de définir une constante cachée. Cela est utile pour les préfixes de chemins métriques des 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, et elle ne peut pas être mise à jour à moins que vous ne mettiez à jour les paramètres de la variable.

Les variables constantes sont utiles lorsque vous avez des valeurs complexes que vous devez inclure dans des requêtes, mais que vous ne souhaitez pas les 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`.

**Pour ajouter une variable constante**

1. Entrez les options générales, comme ci-dessus.

1. Dans le champ **Valeur**, entrez la valeur de la variable. Vous pouvez saisir des lettres, des chiffres et des symboles. Vous pouvez même utiliser des caractères génériques si vous utilisez le [format brut](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

1. 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.

1. Sélectionnez **Ajouter** pour ajouter la variable au tableau de bord.

## Ajouter une variable de source de données
<a name="v10-dash-variable-add-datasource"></a>

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

**Pour ajouter une variable de source de données**

1. Entrez les options générales, comme ci-dessus.

1. Dans la liste **Type**, sélectionnez la source de données cible pour la variable.

   Vous pouvez également choisir **Ouvrir le sélecteur de source de données avancé** pour voir d'autres options, notamment l'ajout d'une source de données (administrateurs uniquement). Pour de plus amples informations, veuillez consulter [Connexion aux sources de données](AMG-data-sources.md).

1. (Facultatif) Dans **Filtre de nom d'instance**, entrez un filtre regex pour choisir 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](#v10-dash-variable-add-selection).

1. 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.

1. Sélectionnez **Ajouter** pour ajouter la variable au tableau de bord.

## Ajouter une variable d'intervalle
<a name="v10-dash-variable-add-internal"></a>

Utilisez une variable d'*intervalle* pour représenter des périodes telles que `1m``1h`, ou`1d`. Vous pouvez les considérer comme un *groupe à l'échelle du tableau de bord par commande temporelle.* 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 Elasticsearch) ou comme paramètre de fonction de synthèse (pour Graphite).

**Pour ajouter une variable d'intervalle**

1. Entrez les options générales, comme ci-dessus.

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. Cette option vous permet de 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 d'étapes** — 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 2 m, Grafana regroupera les données en 15 incréments de deux minutes.

1. 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.

1. Sélectionnez **Ajouter** pour ajouter la variable au tableau de bord.

**Exemples de variables d'intervalle**

L'exemple suivant montre une variable de modèle `myinterval` dans une fonction Graphite :

```
summarize($myinterval, sum, false)
```

## Ajouter des filtres ad hoc
<a name="v10-dash-variable-add-adhoc"></a>

*Les filtres ad hoc* vous permettent d'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 ad hoc dans les requêtes. Vous utilisez plutôt des filtres ad hoc pour écrire des filtres pour les requêtes existantes.

**Note**  
Les variables de filtre ad hoc ne fonctionnent qu'avec les sources de données Prometheus, Loki, InfluxDB et Elasticsearch.

1. Entrez les options générales, comme ci-dessus.

1. Dans la liste **des sources de données**, sélectionnez la source de données cible.

   Vous pouvez également choisir **Ouvrir le sélecteur de source de données avancé** pour voir d'autres options, notamment l'ajout d'une source de données (administrateurs uniquement). Pour de plus amples informations, veuillez consulter [Connexion aux sources de données](AMG-data-sources.md).

1. Sélectionnez **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 vous 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.

## Configurer les options de sélection des variables
<a name="v10-dash-variable-add-selection"></a>

Les *options de sélection* sont une fonctionnalité que vous pouvez utiliser 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.

### Variables à valeurs multiples
<a name="v10-dash-variable-add-selection-multi"></a>

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 ce champ est laissé vide, Grafana concatène (additionne) toutes les valeurs de la requête. Par exemple, `value1,value2,value3`. Si une `all` valeur personnalisée est utilisée, la valeur sera plutôt `*` 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 doit être 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 est interpolée comme. `(host1|host2|host3)` Chaque valeur est également échappée à une regex. Si ce n'était pas le cas, une valeur avec un caractère de contrôle regex briserait l'expression regex.

**Variables à valeurs multiples avec une source de données Elastic**

Elasticsearch utilise la syntaxe de requête Lucene, de sorte que la même variable est formatée comme suit. `("host1" OR "host2" OR "host3")` Dans ce cas, chaque valeur est ignorée, de sorte qu'elle ne contienne que des mots de contrôle lucene et des guillemets.

**Résolution des problèmes liés aux variables à valeurs multiples**

L'échappement et le formatage automatiques peuvent poser des problèmes et il peut être difficile d'en saisir la logique. Surtout pour InfluxDB et Prometheus où l'utilisation de la syntaxe regex nécessite que la variable soit utilisée dans le contexte de l'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 **à valeurs multiples** ou Inclure tout**.
+ Utilisez le [format brut](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw).

### Option Tout inclure
<a name="v10-dash-variable-add-multi-all"></a>

Grafana ajoute une `All` option à la liste déroulante des variables. Si un utilisateur sélectionne cette option, toutes les options variables sont sélectionnées.

### Toutes les valeurs personnalisées
<a name="v10-dash-variable-add-multi-custom"></a>

Cette option n'est visible que si l'**option Tout inclure** est sélectionnée.

Entrez la syntaxe regex, globs ou lucene dans le champ **Personnaliser toutes les valeurs pour définir la valeur** de l'option. `All`

Par défaut, la `All` valeur inclut toutes les options d'une 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 générique.

Pour avoir une syntaxe regex, globs ou lucene **personnalisée dans l'option Personnaliser toutes les valeurs**, elle n'est jamais évitée. Vous devrez donc déterminer quelle est une valeur valide pour votre source de données.

## Variables globales
<a name="v10-dash-variable-add-global"></a>

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` Elles sont actuellement toujours interpolées 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 date personnalisé qui n'inclut pas le caractère :  | 

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

**\$1\$1\$1interval**

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

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, si vous regardez un graphique représentant 3 mois de données, il se peut que vous ne puissiez pas voir les détails à la minute près. Le regroupement par heure ou par jour rend la requête plus efficace sans affecter ce que montre le graphique. Le `$__interval` est calculé en utilisant la plage de temps et la largeur du graphique (le nombre de pixels).

Calcul approximatif : `(to - from) / 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. `$__interval`devrait être utilisé à la place.

Les sources de données InfluxDB et Elasticsearch contiennent des `Group by time interval` champs utilisés pour coder en dur l'intervalle ou pour définir la limite minimale de la `$__interval` variable (en utilisant la `>` syntaxe, par exemple). `>10m`

**\$1\$1\$1interval\$1ms**

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_ms`est le cas`1200000`.

**\$1\$1\$1org**

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

**\$1\$1\$1utilisateur**

`${__user.id}`est l'ID de l'utilisateur actuel. `${__user.login}`est le nom d'utilisateur de connexion de l'utilisateur actuel. `${__user.email}`est l'adresse e-mail de l'utilisateur actuel.

**\$1\$1\$1range**

Compatible uniquement avec les sources de données Prometheus et Loki. Cette variable représente la plage du tableau de bord actuel. Il est calculé par`to - from`. Il comporte une milliseconde et une seconde représentation appelée et. `$__range_ms` `$__range_s`

**\$1\$1\$1rate\$1interval**

Compatible uniquement avec les sources de données Prometheus. La `$__rate_interval` variable est destinée à être utilisée dans la fonction de taux.

**\$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`.

Ceci est utilisé à 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.

**\$1\$1\$1fuseau horaire**

La `$__timezone` variable renvoie le fuseau horaire actuellement sélectionné, `utc` soit une entrée de la base de données de fuseaux horaires de l'IANA (par exemple,`America/New_York`).

Si le fuseau horaire actuellement sélectionné est l'*heure du navigateur*, Grafana essaiera de déterminer le fuseau horaire de votre navigateur.

## Variables enchaînées
<a name="v10-dash-variable-add-chained"></a>

*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.

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 toutes les sources de données qui les autorisent.

Des tableaux de bord modélisés liés extrêmement complexes sont possibles, 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 liées**
+ Le chaînage des variables crée des parent/child dépendances. Vous pouvez les imaginer comme une échelle ou un arbre.
+ Le moyen le plus simple 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 ainsi créées apparaissent en bas de la liste. Vous devrez peut-être le faire glisser vers une autre position dans la liste pour le placer dans un ordre logique.

**Ordre variable**

Vous pouvez modifier l'ordre des variables dans la liste des variables du tableau de bord en cliquant sur les flèches haut et bas à droite de chaque entrée. Grafana répertorie les listes déroulantes variables de gauche à droite selon cette liste, avec la variable en haut à 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.
+ N'oubliez pas que l'interface utilisateur n'indique quelles variables ont des relations de dépendance. Répertoriez les variables dans un ordre logique afin de faciliter la tâche des autres utilisateurs (et de vous-même).

**Considération de complexité**

Plus vous avez de niveaux 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), Grafana doit exécuter des requêtes pour toutes les variables dépendantes avant de mettre à jour les visualisations dans le tableau de bord.

## Gérer les variables
<a name="v10-dash-variable-add-manage"></a>

La page des variables permet d'ajouter des variables et de gérer les variables existantes. Il vous permet également d'[inspecter les](v10-dash-variable-add-inspect.md) variables et de déterminer si une variable est référencée (ou utilisée) dans d'autres variables ou dans le tableau de bord.

**Déplacer** : vous pouvez déplacer une variable vers le haut ou vers le bas de la liste par glisser-déposer.

**Cloner** — Pour cloner une variable, cliquez sur l'icône de clonage dans le jeu d'icônes de droite. Cela crée une copie de la variable avec le nom de la variable d'origine préfixé par`copy_of_`.

**Supprimer** : pour supprimer une variable, cliquez sur l'icône de corbeille dans l'ensemble d'icônes de droite.

## Filtrer les variables avec regex
<a name="v10-dash-variable-add-filter"></a>

À l'aide de l'option Regex Query, vous filtrez la liste des options renvoyées par la variable query ou vous modifiez les options renvoyées.

Cette page montre comment utiliser l'expression régulière pour filter/modify les valeurs de la liste déroulante des variables.

À l'aide de l'option de requête Regex, 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 le guide de Mozilla sur les [expressions régulières](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions).

Les exemples suivants illustrent le 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
```

**Filtrez et modifiez 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 - Prometheus Example**

Pour cette liste d'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
```

Cette regex :

```
/. *instance="
(
[^"]*
)
.*/
```

Renvoie les résultats suivants :

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**Filtrer et modifier à l'aide de groupes de capture de texte et de valeurs nommés**

À 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. Cela permet à la liste déroulante des variables de 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 beaucoup plus `chip_name` conviviale que la valeur. `chip` Le résultat de la requête variable suivant est donc :

```
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
```

Transmis par le Regex suivant :

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

Cela produirait la liste déroulante suivante :

```
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
```

Seuls `text` les noms de groupes de `value` capture et de capture sont pris en charge.

# Inspecter les variables
<a name="v10-dash-variable-add-inspect"></a>

La page des variables vous permet d'identifier facilement si une variable est référencée (ou utilisée) dans d'autres variables ou dans le tableau de bord.

Toute variable référencée ou utilisée est cochée par une coche verte, tandis que les variables non référencées sont accompagnées d'une icône d'avertissement orange. En outre, toutes les variables référencées ont une icône de dépendance à côté de la coche verte. Vous pouvez sélectionner l'icône pour afficher la carte des dépendances. La carte des dépendances peut être déplacée. Vous pouvez zoomer ou dézoomer avec la molette de la souris ou un outil équivalent.

# Syntaxe variable
<a name="v10-dash-variable-syntax"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Les titres des panneaux et les requêtes métriques peuvent faire référence à des variables à l'aide de deux syntaxes différentes.
+ `$varname`— Cette syntaxe est facile à lire, mais elle ne permet pas d'utiliser une variable au milieu d'un mot.

  **Exemple** : `apps.frontend.$server.requests.count`
+ `${var_name}`— Utilisez cette syntaxe lorsque vous souhaitez utiliser une variable au milieu d'une expression.
+ `${var_name:<format>}`— Ce format vous permet de mieux contrôler la façon dont Grafana interprète les valeurs. Pour plus d'informations, consultez la section *Options avancées de format de variable*, à la suite de cette liste.
+ `[[varname]]`— Ne pas utiliser. Cette syntaxe est ancienne et est obsolète. Il sera supprimé dans une future version.

Avant que les requêtes ne soient envoyées à votre source de données, la requête est *interpolée*, 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* afin de 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 regex dans une requête InfluxDB ou Prometheus sera échappée à l'expression régulière.

**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` Vous pouvez y parvenir grâce aux options avancées de mise en forme des variables répertoriées ci-dessous.

**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' default/fallback option.

**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 à valeurs uniques ou multiples 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: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"]'
```

**Lucene - Elasticsearch**

Formate les variables avec plusieurs valeurs au format Lucene pour Elasticsearch.

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**Code en pourcentage**

Formate les variables à valeurs uniques et 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'
```

**Tuyau**

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'
```

**Brut**

Désactive le formatage spécifique à la source de données, tel que les guillemets simples dans une requête SQL.

```
servers = [ 'test.1',  '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 à valeurs uniques ou multiples 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 à valeurs uniques ou multiples 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'"
```

**Text**

Formate les variables à valeurs uniques et 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"
```

**Paramètres Query (Requête)**

Formate les variables à valeurs uniques et multiples dans leur représentation des paramètres de requête. Exemple : `var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# Evaluation de l'utilisation du tableau
<a name="v10-dash-assess-dashboard-usage"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Pour chaque tableau de bord et chaque source de données, vous pouvez accéder aux informations d'utilisation.

**Informations du tableau de bord**

Pour consulter les informations d'utilisation du tableau de **bord, sélectionnez Informations sur** le tableau de bord dans la barre supérieure.

Les informations du tableau de bord présentent les informations suivantes.
+ **Statistiques** : nombre de requêtes et d'erreurs quotidiennes au cours des 30 derniers jours.
+ **Utilisateurs et activité** : nombre de vues quotidiennes des 30 derniers jours, dernières activités sur le tableau de bord et utilisateurs récents (dans la limite de 20).

**Informations sur les sources de données**

Les informations sur les sources de données fournissent des informations sur la manière dont une source de données a été utilisée au cours des 30 derniers jours, telles que :
+ Requêtes par jour
+ Erreurs par jour
+ Temps de chargement des requêtes par jour (moyenne en ms)

**Pour obtenir des informations sur les sources de données**

1. Sélectionnez **Connexions** dans la navigation principale de votre espace de travail.

1. Sélectionnez **Sources de données**.

1. Choisissez une source de données.

1. Sélectionnez l'onglet **Insights**.

## Indicateur de présence
<a name="v10-dash-presence-indicator"></a>

Lorsque vous êtes connecté et que vous consultez un tableau de bord, vous pouvez savoir qui consulte le même tableau de bord que vous grâce à un indicateur de présence, qui affiche les avatars des utilisateurs ayant récemment interagi avec le tableau de bord. Le délai par défaut est de 10 minutes. Pour voir le nom de l'utilisateur, passez la souris sur son avatar. Les avatars proviennent de [Gravatar](https://gravatar.com/) en fonction de l'e-mail de l'utilisateur.

Lorsque le nombre d'utilisateurs actifs sur un tableau de bord est supérieur à ce que peut contenir l'indicateur de présence, cliquez sur l'**icône\$1X**. Cela ouvrira des informations sur le tableau de bord, qui contiennent plus de détails sur l'activité récente des utilisateurs.

## Tri des tableaux de bord à l'aide de données d'information
<a name="v10-dash-sort-dashboards"></a>

Dans la vue de recherche, vous pouvez utiliser les données d'analyse pour vous aider à trouver les tableaux de bord les plus utilisés, les plus cassés et les plus inutilisés. Vous pouvez trier les tableaux de bord comme suit.
+ Vues
+ Erreurs
+ Vues
+ Heure de création
+ Heure mise à jour

# Résoudre les problèmes liés aux tableaux de bord
<a name="v10-dash-troubleshoot"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

 Utilisez les stratégies suivantes pour résoudre les problèmes courants liés aux tableaux de bord. 

## Le tableau de bord est lent
<a name="v10-dash-dashboard-is-slow"></a>
+ Essayez-vous de représenter des dizaines (ou des centaines ou des milliers) de séries chronologiques sur un graphique ? Cela peut entraîner un retard du navigateur. Essayez d'utiliser des fonctions telles que `highestMax` (dans Graphite) pour réduire le nombre de séries renvoyées.
+ Parfois, les noms de séries peuvent être très grands. Cela entraîne des tailles de réponse plus importantes. Essayez d'utiliser `alias` pour réduire la taille des noms de série renvoyés.
+ Vous recherchez de nombreuses séries chronologiques ou une longue période ? Ces deux conditions peuvent amener Grafana ou votre source de données à extraire une grande quantité de données, ce qui peut ralentir le tableau de bord. Essayez de réduire l'un ou les deux.
+ Votre infrastructure réseau peut être très sollicitée. Si la lenteur n'est pas constante, cela peut être le problème.

## Problèmes de taux d'actualisation du tableau de bord
<a name="v10-dash-refresh-rate-issues"></a>

Par défaut, Grafana interroge votre source de données toutes les 30 secondes. Cependant, définir un faible taux de rafraîchissement sur vos tableaux de bord impose un stress inutile au backend. Dans de nombreux cas, il n'est pas nécessaire de le demander fréquemment, car la source de données n'envoie pas de données assez souvent pour que des modifications soient apportées toutes les 30 secondes.

Nous vous recommandons la procédure suivante :
+ Activez l'actualisation automatique sur les tableaux de bord, les panneaux ou les variables uniquement si nécessaire. Les utilisateurs peuvent actualiser leur navigateur manuellement.
+ Si vous avez besoin d'une actualisation automatique, réglez le taux de rafraîchissement sur une période plus longue qui vous convient, par exemple une fois par minute, toutes les 10 minutes ou toutes les heures.
+ Vérifiez la plage horaire de votre tableau de bord. Si la durée de votre tableau de bord est plus longue, par exemple une semaine, vous n'avez pas vraiment besoin d'une actualisation automatique et vous devez la désactiver.

## La manipulation ou le rendu de données nulles est incorrect ou source de confusion
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

Certaines applications publient des données par intermittence ; par exemple, elles ne publient une métrique que lorsqu'un événement se produit. Par défaut, les graphes Grafana relient les lignes entre les points de données, mais cela peut être trompeur.

Les graphiques dont l'option **Connecter les valeurs nulles** est définie sur **Toujours** relieront les lignes où des valeurs sont manquantes.

Une façon de résoudre ce problème consiste à utiliser des barres plutôt que des lignes et à définir l'option **Aucune valeur** (sous **Options standard**) sur`0`. Dans ce cas, les données manquantes apparaîtront sous forme de zones du graphique sans données.

# Recherche dans les tableaux de bord dans la version 10 de Grafana
<a name="v10-search"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
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)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Vous pouvez rechercher des tableaux de bord par nom de tableau de bord et par titre de panneau. Lorsque vous recherchez des tableaux de bord, le système renvoie tous les tableaux de bord disponibles dans l'instance de Grafana, même si vous n'êtes pas autorisé à consulter le contenu du tableau de bord.

## Rechercher des tableaux de bord en utilisant le nom du tableau de bord
<a name="v10-search-by-name"></a>

Entrez n'importe quelle partie du nom du tableau de bord dans la barre de recherche. La recherche renvoie des résultats pour toute correspondance partielle de chaîne en temps réel, au fur et à mesure que vous tapez.

La recherche dans le tableau de bord est :
+ Temps réel
+ *Ne distingue pas* les majuscules
+ Fonctionnel sur les tableaux de bord stockés et basés sur des fichiers.

**Astuce**  
Vous pouvez utiliser les touches fléchées de votre clavier pour parcourir les résultats et appuyer dessus `Enter` pour ouvrir le tableau de bord sélectionné.

## Rechercher des tableaux de bord à l'aide du titre du panneau
<a name="v10-search-by-title"></a>

Vous pouvez rechercher un tableau de bord en fonction du titre d'un panneau qui apparaît dans un tableau de bord. Si le titre d'un panneau correspond à votre requête de recherche, le tableau de bord apparaît dans les résultats de recherche.

## Filtrer les résultats de recherche du tableau de bord par balises
<a name="v10-search-by-tag"></a>

Les balises constituent un excellent moyen d'organiser vos tableaux de bord, en particulier lorsque le nombre de tableaux de bord augmente. Vous pouvez ajouter et gérer des balises dans les **paramètres** du tableau de bord.

Lorsque vous sélectionnez plusieurs balises, Grafana affiche des tableaux de bord qui incluent toutes les balises sélectionnées.

Pour filtrer les résultats de recherche du tableau de bord en fonction d'une balise, effectuez l'une des étapes suivantes :
+ Pour filtrer les résultats de recherche du tableau de bord par balise, choisissez une balise qui apparaît dans la colonne de droite des résultats de recherche.

  Vous pouvez poursuivre le filtrage en choisissant des balises supplémentaires.
+ Pour voir la liste de tous les tags disponibles, cliquez sur le menu déroulant **Filtrer par tags** et sélectionnez un tag.

  Toutes les balises seront affichées, et lorsque vous en sélectionnez une, la recherche dans le tableau de bord sera instantanément filtrée.

**Astuce**  
Lorsque vous utilisez uniquement un clavier, appuyez sur la `tab` touche et accédez au menu déroulant **Filtrer par étiquette**, appuyez sur la flèche vers le bas pour activer le menu et localiser une balise, puis appuyez `Enter` pour sélectionner la balise.

## Palette de commandes
<a name="v10-search-palette"></a>

Vous pouvez utiliser la palette de commandes pour effectuer les opérations suivantes :
+ Recherchez et ouvrez des tableaux de bord et des dossiers.
+ Créez des tableaux de bord et des règles d'alerte.
+ Localisez des pages dans Grafana.
+ Changez le thème en foncé ou en clair.

Ouvrez la palette de commandes en haut, entrez `ctrl+k` (`cmd+k`sous macOS). Vous pouvez également sélectionner l'entrée de recherche dans la barre de navigation de Grafana.

**Note**  
Pour passer à l'étape précédente, appuyez `backspace` avec la palette de commandes vide.