

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.

# Travailler dans la version 10 de Grafana
<a name="using-grafana-v10"></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)

Lorsque vous créez votre espace de travail Grafana, vous pouvez choisir la version de Grafana à utiliser. Les rubriques suivantes décrivent l'utilisation d'un espace de travail Grafana qui utilise la version 10 de Grafana.

**Topics**
+ [Tableaux de bord dans Grafana version 10](v10-dashboards.md)
+ [Panneaux et visualisations dans Grafana version 10](v10-panels.md)
+ [Explorez dans la version 10 de Grafana](v10-explore.md)
+ [Corrélations dans Grafana version 10](v10-correlations.md)
+ [Alertes dans la version 10 de Grafana](v10-alerts.md)

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

# Panneaux et visualisations dans Grafana version 10
<a name="v10-panels"></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 *panneau* est l'élément de base de la visualisation dans Grafana. Chaque panneau possède un éditeur de requêtes spécifique à la source de données sélectionnée dans le panneau. L'éditeur de requêtes vous permet de créer une requête qui renvoie les données que vous souhaitez visualiser.

Il existe une grande variété d'options de style et de mise en forme pour chaque panneau. Les panneaux peuvent être glissés, déposés et redimensionnés pour les réorganiser sur le tableau de bord.

Avant d'ajouter un panneau, assurez-vous d'avoir configuré une source de données.

Des types de panneaux supplémentaires peuvent être disponibles en installant des [plug-ins](grafana-plugins.md) supplémentaires dans votre espace de travail.

Pour plus de détails sur l'utilisation de sources de données spécifiques, consultez[Connexion aux sources de données](AMG-data-sources.md).

**Topics**
+ [Présentation de l'éditeur de panneaux](v10-panels-editor-overview.md)
+ [Vue d'inspection du panneau](v10-panels-panel-inspector.md)
+ [Interrogez et transformez les données](v10-panels-query-xform.md)
+ [Configurer les options du panneau](v10-panels-configure-panel-options.md)
+ [Configuration des options standard](v10-panels-configure-standard-options.md)
+ [Configuration d'une légende](v10-panels-configure-legend.md)
+ [Configuration des liaisons de données](v10-panels-configure-data-links.md)
+ [Configurer les mappages de valeurs](v10-panels-configure-value-mappings.md)
+ [Configuration des seuils](v10-panels-configure-thresholds.md)
+ [Configurer les remplacements de champs](v10-panels-configure-overrides.md)
+ [Visualisations disponibles dans la version 10 de Grafana](v10-panels-viz.md)

# Présentation de l'éditeur de panneaux
<a name="v10-panels-editor-overview"></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)

Dans l'éditeur de panneaux, vous pouvez mettre à jour tous les éléments d'une visualisation, notamment la source de données, les requêtes, la plage de temps et les options d'affichage.

Pour ajouter un panneau à un nouveau tableau de bord, sélectionnez **\$1 Ajouter une visualisation** au milieu du tableau de bord. Pour ajouter un panneau à un tableau de bord existant, sélectionnez **Ajouter** dans l'en-tête du tableau de bord et sélectionnez **Visualisation** dans le menu déroulant. Vous pouvez également copier-coller un panneau existant à partir du même tableau de bord ou d'un autre tableau de bord.

## Menu du panneau
<a name="v10-panels-editor-menu"></a>

Pour accéder à l'éditeur de panneaux, survolez le coin supérieur droit de n'importe quel panneau. Sélectionnez l'icône du menu du panneau qui apparaît, puis sélectionnez **Modifier**.

Le menu du panneau vous permet également d'accéder aux actions suivantes :
+ **Afficher** — Affichez le panneau en plein écran.
+ **Modifier** : ouvrez l'éditeur de panneaux pour modifier le panneau et les options de visualisation.
+ **Partager** : partagez le panneau sous forme de lien ou de panneau de bibliothèque.
+ **Explorer** : ouvrez le panneau dans **Explore**, dans lequel vous pouvez vous concentrer sur votre requête.
+ **Inspecter** — Ouvrez le tiroir d'**inspection**, dans lequel vous pouvez consulter les données du panneau, les statistiques, les métadonnées, le JSON et la requête.
  + **Données** — Ouvrez le tiroir **d'inspection** dans l'onglet **Données**.
  + **Requête** — Ouvrez le tiroir **d'inspection** dans l'onglet **Requête**.
  + **Panel JSON** — Ouvrez le tiroir **Inspect** dans l'onglet **JSON**.
+ **Extensions** : accédez à d'autres actions fournies par les applications installées, telles que la déclaration d'un incident. Cette option n'apparaît que si vous avez installé des plugins d'application qui apportent une extension au menu du panneau.
+ **Plus** : accédez aux autres actions du panneau.
  + **Dupliquer** — Créez une copie du panneau. Les panneaux dupliqués interrogent les données séparément du panneau d'origine. Si vous souhaitez utiliser les mêmes résultats de requête, vous pouvez utiliser la source de `Dashboard` données dans le deuxième panneau.
  + **Copier** — Copiez le panneau dans le presse-papiers.
  + **Créer un panneau de bibliothèque** : créez un panneau qui peut être importé dans d'autres tableaux de bord.
  + **Créer une alerte** : ouvrez la page de configuration des règles d'**alerte dans Alerting**, où vous pouvez créer une [alerte gérée par Grafana en](v10-alerts.md) fonction des requêtes du panneau.
  + **Masquer la légende** : masque la légende du panneau.
  + **Obtenir de l'aide** — Envoyez un instantané ou des données de panel au Support technique de Grafana Labs.
+ **Supprimer** — Supprimez le panneau du tableau de bord.

## Éditeur de panneaux
<a name="v10-panels-editor-view"></a>

Cette section décrit les zones de l'éditeur de panneaux Grafana.
+ En-tête du panneau — La section d'en-tête répertorie le tableau de bord dans lequel le panneau apparaît et les commandes suivantes :
  + **Ignorer** : annule les modifications que vous avez apportées au panneau depuis le dernier enregistrement du tableau de bord.
  + **Enregistrer** : enregistre les modifications que vous avez apportées au panneau.
  + **Appliquer** : applique les modifications que vous avez apportées et ferme l'éditeur de panneaux, vous renvoyant au tableau de bord. Vous devrez enregistrer le tableau de bord pour conserver les modifications appliquées.
+ Aperçu de la visualisation : la section d'aperçu de la visualisation contient les options suivantes :
  + **Affichage sous forme de tableau** : convertissez n'importe quelle visualisation en tableau afin de voir les données. Les vues sous forme de tableau sont utiles pour le dépannage. Cette vue contient uniquement les données brutes. Il n'inclut pas les transformations que vous avez peut-être appliquées aux données ni les options de mise en forme disponibles dans la visualisation de [table](v10-panels-table.md).
  + **Remplissage** : l'aperçu de la visualisation remplit l'espace disponible. Si vous modifiez la largeur du panneau latéral ou la hauteur du panneau inférieur, la visualisation change pour remplir l'espace disponible.
  + **Réel** — L'aperçu de la visualisation aura la même taille que celle du tableau de bord. Si l'espace disponible est insuffisant, la visualisation sera réduite en préservant le rapport hauteur/largeur.
  + **Contrôles de plage horaire** — La **valeur par défaut** est soit le fuseau horaire local du navigateur, soit le fuseau horaire sélectionné à un niveau supérieur.
+ Section des données : la section des données contient des onglets dans lesquels vous pouvez saisir des requêtes, transformer vos données et créer des règles d'alerte (le cas échéant).
  + **Onglet Requête** : sélectionnez votre source de données et saisissez des requêtes ici. Pour de plus amples informations, veuillez consulter [Interrogez et transformez les données](v10-panels-query-xform.md). Lorsque vous créez un tableau de bord pour la première fois, vous êtes invité à sélectionner une source de données. Vous pouvez mettre à jour la source de données ou la requête dans cet onglet.
  + **Onglet Transformation** : appliquez des transformations de données. Pour de plus amples informations, veuillez consulter [Interrogez et transformez les données](v10-panels-query-xform.md).
  + **Onglet Alerte** : écrivez les règles d'alerte. Pour de plus amples informations, veuillez consulter [Alertes dans la version 10 de Grafana](v10-alerts.md).
+ Options d'affichage du panneau : la section des options d'affichage contient des onglets dans lesquels vous pouvez configurer presque tous les aspects de la visualisation des données. Les détails varient en fonction du type de visualisation sélectionné.

## Panneau d'inspection du tiroir
<a name="v10-panels-editor-inspect"></a>

Le tiroir d'inspection vous aide à comprendre et à dépanner vos panneaux. Vous pouvez afficher les données brutes de n'importe quel panneau, exporter ces données vers un fichier de valeurs séparées par des virgules (CSV), consulter les demandes de requête et exporter le panneau et les données au format JSON.

**Note**  
Tous les types de panneaux n'incluent pas tous les onglets. Par exemple, les panneaux de liste des tableaux de bord ne contiennent pas de données brutes à inspecter. Ils n'affichent donc pas les onglets Statistiques, Données ou Requête.

L'inspecteur du panneau comprend les options suivantes :
+ Le panneau inspecte les écrans des tiroirs sous la forme d'un tiroir situé sur le côté droit. Sélectionnez la flèche dans le coin supérieur droit pour agrandir ou réduire le volet du tiroir.
+ **Onglet Données** : affiche les données brutes renvoyées par la requête avec les transformations appliquées. Les options de champ telles que les remplacements et les mappages de valeurs ne sont pas appliquées par défaut.
+ **Onglet Statistiques** : indique le temps que prend votre requête et le montant qu'elle renvoie.
+ **Onglet JSON** — Vous permet d'afficher et de copier le JSON du panneau, le JSON des données du panneau et le JSON de la structure du bloc de données. Cela est utile si vous approvisionnez ou administrez Grafana.
+ **Onglet Requête** — Affiche les demandes envoyées au serveur lorsque Grafana interroge la source de données.
+ **Onglet Erreur** : affiche toutes les erreurs renvoyées par une requête. L'onglet n'est visible que lorsqu'une requête renvoie une erreur.

# Vue d'inspection du panneau
<a name="v10-panels-panel-inspector"></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)

La vue d'inspection des panneaux, que vous pouvez ouvrir via le menu du panneau, vous aide à comprendre et à résoudre les problèmes liés à vos panneaux. Vous pouvez inspecter les données brutes de n'importe quel panneau Amazon Managed Grafana, exporter ces données vers un fichier de valeurs séparées par des virgules (CSV), consulter les demandes de requête et exporter le panneau et les données au format JSON.

**Note**  
Tous les types de panneaux n'incluent pas tous les onglets. Par exemple, les panneaux de liste des tableaux de bord ne contiennent pas de données brutes à inspecter. Ils n'affichent donc pas les onglets Statistiques, Données ou Requête.

L'inspecteur du panneau comprend les options suivantes :

1. L'inspecteur du panneau affiche **Inspect :** en haut du volet. Sélectionnez la flèche dans le coin supérieur droit pour agrandir ou réduire le volet.

1. **Onglet Données** : affiche les données brutes renvoyées par la requête avec les transformations appliquées. Les options de champ telles que les remplacements et les mappages de valeurs ne sont pas appliquées par défaut.

1. **Onglet Statistiques** : indique le temps que prend votre requête et le montant qu'elle renvoie.

1. **Onglet JSON** — Vous permet d'afficher et de copier le JSON du panneau, le JSON des données du panneau et le JSON de la structure du bloc de données. Cela est utile si vous approvisionnez ou administrez Grafana.

1. **Onglet Requête** — Affiche les demandes envoyées au serveur lorsque Grafana interroge la source de données.

1. **Onglet Erreur** : affiche toutes les erreurs. Visible uniquement lorsqu'une requête renvoie une erreur.

## Téléchargement des résultats de requête bruts
<a name="v10-panels-raw-query-results"></a>

Amazon Managed Grafana génère un fichier CSV contenant vos données, y compris les transformations apportées à ces données. Vous pouvez choisir d'afficher les données avant ou après que le panneau applique des options de champ ou des remplacements d'options de champ.

**Pour télécharger les résultats bruts des requêtes**

1. Modifiez le panneau qui contient les données de requête que vous souhaitez télécharger.

1. Dans l'éditeur de requêtes, sélectionnez **Query Inspector**.

1. Sélectionnez **Données**.

   Si votre panneau contient plusieurs requêtes ou interroge plusieurs nœuds, des options supplémentaires s'offrent à vous.
   + **Sélectionnez le résultat** : choisissez les données du jeu de résultats que vous souhaitez afficher.
   + **Transformez les données**
   + **Inscrivez-vous par heure** : visualisez les données brutes de toutes vos requêtes en une seule fois, un ensemble de résultats par colonne. Sélectionnez un en-tête de colonne pour réorganiser les données.

1. Pour afficher les données avant que le système n'applique des remplacements de champs, sélectionnez le bouton **Données formatées**.

1. Pour télécharger un fichier CSV spécialement formaté pour Excel, sélectionnez le bouton **Télécharger pour Excel**.

1. Sélectionnez **Download CSV (Télécharger le CSV)**.

## Inspection des performances des requêtes
<a name="v10-panels-query-performance"></a>

L'onglet **Statistiques** affiche des statistiques qui indiquent la durée de votre requête, le nombre de requêtes que vous envoyez et le nombre de lignes renvoyées. Ces informations peuvent vous aider à résoudre vos requêtes, en particulier si l'un des chiffres est élevé ou faible de façon inattendue.

**Pour inspecter les performances des requêtes**

1. Modifiez le panneau qui contient la requête avec les performances que vous souhaitez inspecter.

1. Dans l'éditeur de requêtes, sélectionnez **Query Inspector**.

1. Sélectionnez **Stats**.

Les statistiques sont affichées en lecture seule.

## Inspection de la requête, de la demande et de la réponse
<a name="v10-panels-query-request-response"></a>

Vous pouvez inspecter les données relatives aux demandes et aux réponses lorsque vous souhaitez résoudre les problèmes liés à une requête qui renvoie des résultats inattendus ou qui ne renvoie pas les résultats attendus.

1. Modifiez le panneau qui contient la requête que vous souhaitez exporter.

1. Dans l'éditeur de requêtes, sélectionnez **Query Inspector**.

1. Sélectionnez **Rafraîchir**.

   Le panneau est renseigné avec les données de réponse.

1. Apportez les modifications nécessaires et réexécutez la requête.

1. Pour télécharger les données de demande de requête et de réponse, cliquez sur l'icône **Copier dans le presse-papiers** et collez les résultats dans une autre application.

# Interrogez et transformez les données
<a name="v10-panels-query-xform"></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)

Amazon Managed Grafana prend en charge de nombreux types de sources de [données](AMG-data-sources.md). Les *requêtes* de source de données renvoient des données que Grafana peut *transformer et visualiser*. Chaque source de données utilise son propre langage de requête, et les plug-ins de source de données implémentent chacun une interface utilisateur de création de requêtes appelée éditeur de requêtes.

**Topics**
+ [À propos des requêtes](#v10-panels-query-xform-about)
+ [Naviguez dans l'onglet de requête](#v10-panels-query-xform-navigate)
+ [Ajouter une requête](#v10-panels-query-xform-add)
+ [Gérer les requêtes](#v10-panels-query-xform-manage)
+ [Options de requête](#v10-panels-query-xform-options)
+ [Écrire des requêtes d'expression](v10-panels-query-xform-expressions.md)
+ [Partage des résultats de requête avec un autre panneau](v10-panels-query-share.md)
+ [Transformation de données](v10-panels-xform.md)
+ [Résoudre les problèmes liés aux requêtes](v10-panels-query-troubleshoot.md)
+ [Types de calculs](v10-panels-calculation-types.md)

## À propos des requêtes
<a name="v10-panels-query-xform-about"></a>

Les panneaux Grafana communiquent avec les sources de données via des requêtes, qui récupèrent les données pour la visualisation. Une requête est une question rédigée dans le langage de requête utilisé par la source de données.

Vous pouvez configurer la fréquence des requêtes et les limites de collecte de données dans les options de source de données du panneau. Grafana prend en charge jusqu'à 26 requêtes par panel.

Vous trouverez plus d'informations sur le langage de requête de chaque source de données dans la section [Sources de données](AMG-data-sources.md).

**Éditeurs de requêtes**

L'*éditeur de requêtes* de chaque source de données fournit une interface utilisateur personnalisée qui vous permet de rédiger des requêtes qui tirent parti de ses fonctionnalités uniques.

En raison des différences entre les langages de requête, chaque éditeur de requêtes de source de données présente une apparence et un fonctionnement différents. En fonction de votre source de données, l'éditeur de requêtes peut fournir des fonctionnalités de saisie automatique, des noms de métriques, des suggestions de variables ou une interface visuelle de création de requêtes.

Pour plus de détails sur les fonctionnalités uniques de l'éditeur de requêtes d'une source de données spécifique, notamment des informations sur les requêtes et la syntaxe, consultez la documentation de la source de données :
+ Pour les sources de données incluses dans Amazon Managed Grafana, consultez la section Sources de [données intégrées](AMG-data-sources-builtin.md).
+ Pour les sources de données incluses dans Grafana Enterprise, voir. [Connectez-vous aux sources de données de l'entreprise](AMG-data-sources-enterprise.md)
+ Pour les autres plugins de source de données que vous installez via le[Trouvez des plugins avec le catalogue de plugins](grafana-plugins.md#plugin-catalog), la documentation est liée dans la liste du catalogue des plugins.

**Syntaxe de requête**

Les sources de données utilisent différents langages de requête pour demander des données. Pour plus de détails sur le langage de requête unique d'une source de données spécifique, reportez-vous à sa documentation.

**Exemple de PostgreSQL :**

```
SELECT hostname FROM host WHERE region IN($region)
```

**Exemple de ProMQL :**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**Sources de données spéciales**

**Grafana inclut également trois sources de données spéciales : **Grafana**, **Mixed** et Dashboard.** Pour de plus amples informations, veuillez consulter [Connexion aux sources de données](AMG-data-sources.md).

## Naviguez dans l'onglet de requête
<a name="v10-panels-query-xform-navigate"></a>

L'onglet **Requête** d'un panneau comprend les éléments suivants :
+ **Sélecteur de source de données** : sélectionne la source de données à interroger.
+ **Options de requête** : définit les paramètres maximaux de récupération des données et les intervalles d'exécution des requêtes.
+ **Bouton Inspecteur** de requêtes : ouvre le panneau de l'inspecteur de requêtes, dans lequel vous pouvez afficher et optimiser votre requête.
+ **Liste de l'éditeur de requêtes** : répertorie les requêtes que vous avez rédigées.
+ **Expressions** : utilise le générateur d'expressions pour créer des expressions d'alerte. Pour plus d’informations sur les expressions, consultez [Écrire des requêtes d'expression](v10-panels-query-xform-expressions.md).

## Ajouter une requête
<a name="v10-panels-query-xform-add"></a>

Une requête renvoie des données que Grafana visualise dans les panneaux du tableau de bord. Lorsque vous créez un panneau, Grafana sélectionne automatiquement la source de données par défaut.

**Pour ajouter une requête**

1. Modifiez le panneau dans lequel vous ajoutez une requête.

1. Choisissez l'onglet **Query** (Requête).

1. Choisissez le menu déroulant **Source de données** et sélectionnez une source de données.

1. Choisissez **les options de requête** pour configurer le nombre maximum de points de données dont vous avez besoin. Pour plus d'informations sur les options de requête, consultez[Options de requête](#v10-panels-query-xform-options).

1. Rédigez la requête à l'aide de l'éditeur de requêtes.

1. Cliquez sur **Appliquer**.

Grafana interroge la source de données et visualise les données.

## Gérer les requêtes
<a name="v10-panels-query-xform-manage"></a>

Grafana organise les requêtes en lignes de requêtes pliables. Chaque ligne de requête contient un éditeur de requêtes et est identifiée par une lettre (A, B, C, etc.).

Pour gérer vos requêtes, vous pouvez copier des requêtes, masquer des requêtes, supprimer des requêtes, réorganiser les requêtes et activer l'aide de l'éditeur de requêtes.

## Options de requête
<a name="v10-panels-query-xform-options"></a>

Choisissez **Options de requête** à côté du sélecteur de source de données pour voir les paramètres de la source de données sélectionnée. Les modifications que vous apportez ici concernent uniquement les requêtes effectuées dans ce panneau.

Grafana définit les valeurs par défaut qui sont affichées en texte gris foncé. Les modifications sont affichées en blanc. Pour rétablir les paramètres par défaut d'un champ, supprimez le texte blanc du champ.

Les options de requête de source de données du panneau incluent :
+ **Nombre maximal de points de données** : si la source de données le prend en charge, cela définit le nombre maximum de points de données pour chaque série renvoyée. Si la requête renvoie plus de points de données que le paramètre maximum de points de données, la source de données réduit le nombre de points renvoyés en les agrégeant par moyenne, par maximum ou par une autre fonction.

  Vous pouvez limiter le nombre de points pour améliorer les performances des requêtes ou lisser la ligne visualisée. La valeur par défaut est la largeur (ou le nombre de pixels) du graphique, car vous ne pouvez visualiser que le nombre de points de données que le panneau du graphique peut afficher.

  Pour les données en streaming, Grafana utilise la valeur maximale de points de données pour la mémoire tampon mobile. Le streaming est un flux continu de données, et la mise en mémoire tampon divise le flux en plusieurs parties.
+ **Intervalle minimum** : définit une limite minimale pour l'intervalle calculé automatiquement, qui est généralement l'intervalle de capture minimum. Si un point de données est enregistré toutes les 15 secondes, vous n'avez aucun avantage à avoir un intervalle inférieur à ce chiffre. Vous pouvez également définir ce paramètre sur un minimum supérieur à l'intervalle de capture pour récupérer des requêtes plus grossières et plus performantes.
+ **Intervalle** — Définit un intervalle de temps que vous pouvez utiliser pour agréger ou regrouper des points de données par temps.

  Grafana calcule automatiquement un intervalle approprié que vous pouvez utiliser comme variable dans les requêtes modélisées. La variable est mesurée en secondes (`$__interval`) ou en millisecondes (). `$__interval_ms`

  Les intervalles sont généralement utilisés dans les fonctions d'agrégation telles que la somme ou la moyenne. Par exemple, il s'agit d'une requête Prometheus qui utilise la variable d'intervalle :. `rate(http_requests_total[$__interval])`

  Cet intervalle automatique est calculé en fonction de la largeur du graphique. Lorsque l'utilisateur effectue un zoom arrière sur une visualisation, l'intervalle augmente, ce qui donne lieu à une agrégation plus grossière. De même, si l'utilisateur zoome, l'intervalle diminue, ce qui permet une agrégation plus fine.

  Pour de plus amples informations, veuillez consulter [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ **Temps relatif** : remplace la plage de temps relative des différents panneaux, ce qui les rend différents de ceux sélectionnés dans le sélecteur de temps du tableau de bord situé dans le coin supérieur droit du tableau de bord. Vous pouvez l'utiliser pour afficher les statistiques de différentes périodes ou de différents jours sur le même tableau de bord.
**Note**  
Les dérogations temporelles du panneau n'ont aucun effet lorsque la plage de temps du tableau de bord est absolue.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Décalage horaire** : remplace la plage de temps de chaque panneau en décalant son début et sa fin par rapport au sélecteur de temps. Par exemple, vous pouvez modifier la plage horaire du panneau pour qu'elle soit deux heures plus tôt que celle du sélecteur d'heure du tableau de bord.
**Note**  
Les dérogations temporelles du panneau n'ont aucun effet lorsque la plage de temps du tableau de bord est absolue.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-query-xform.html)
+ **Délai d'expiration du cache** — *(visible uniquement s'il est disponible dans la source de données)* Remplace le délai d'expiration du cache par défaut si votre magasin de séries chronologiques possède un cache de requêtes. Spécifiez cette valeur sous forme de valeur numérique en secondes.

# Écrire des requêtes d'expression
<a name="v10-panels-query-xform-expressions"></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)

Les expressions côté serveur vous permettent de manipuler les données renvoyées par des requêtes à l'aide d'opérations mathématiques ou autres. Les expressions créent de nouvelles données et ne manipulent pas les données renvoyées par les sources de données.

## À propos des expressions
<a name="v10-panels-query-about"></a>

Les expressions côté serveur vous permettent de manipuler les données renvoyées par des requêtes à l'aide d'opérations mathématiques ou autres. Les expressions créent de nouvelles données et ne manipulent pas les données renvoyées par les sources de données, à l'exception de quelques restructurations mineures des données afin de rendre les données acceptables en entrée pour les expressions.

**Utilisation d'expressions**

Les expressions sont le plus souvent utilisées par les alertes [Grafana](v10-alerts.md). Le traitement est effectué côté serveur, de sorte que les expressions peuvent fonctionner sans session de navigateur. Toutefois, les expressions peuvent également être utilisées avec les sources de données principales et la visualisation.

**Note**  
Les expressions ne fonctionnent pas avec les anciennes alertes de tableau de bord.

Les expressions sont destinées à augmenter les sources de données en permettant de combiner des requêtes provenant de différentes sources de données ou en fournissant des opérations non disponibles dans une source de données.

**Note**  
Dans la mesure du possible, vous devez effectuer le traitement des données dans la source de données. Copier des données depuis le stockage vers le serveur Grafana à des fins de traitement est inefficace. Les expressions sont donc destinées au traitement léger des données.

Les expressions fonctionnent avec des requêtes de source de données qui renvoient des séries chronologiques ou des données numériques. Ils fonctionnent également sur des données [multidimensionnelles](getting-started-grafanaui.md#time-series-dimensions). Par exemple, une requête qui renvoie plusieurs séries, chaque série étant identifiée par des étiquettes ou des balises.

Une expression individuelle prend une ou plusieurs requêtes ou autres expressions en entrée et ajoute des données au résultat. Chaque expression ou requête individuelle est représentée par une variable qui est un identifiant nommé appelé RefID (par exemple, la lettre par défaut `A` ou`B`).

Pour référencer le résultat d'une expression individuelle ou d'une requête de source de données dans une autre expression, cet identifiant est utilisé comme variable.

**Types d'expressions**

Les expressions fonctionnent avec deux types de données.
+ Une collection de séries chronologiques.
+ Une collection de numéros, où chaque numéro est un élément.

Chaque collection est renvoyée à partir d'une seule requête ou expression de source de données et est représentée par le RefID. Chaque collection est un ensemble, chaque élément de l'ensemble étant identifié de manière unique par ses dimensions, qui sont stockées sous forme d'[étiquettes](getting-started-grafanaui.md#labels) ou de paires clé-valeur.

**Requêtes sur les sources de données**

Les expressions côté serveur prennent uniquement en charge les requêtes de source de données pour les sources de données principales. Les données sont généralement considérées comme des données de séries chronologiques. 

Les requêtes de source de données, lorsqu'elles sont utilisées avec des expressions, sont exécutées par le moteur d'expression. Dans ce cas, il restructure les données pour qu'il s'agisse d'une série chronologique ou d'un nombre par trame de données. Ainsi, par exemple, si vous utilisez une source de données qui renvoie plusieurs séries sur un seul cadre dans la vue tabulaire, vous remarquerez peut-être que son apparence est différente lorsqu'elle est exécutée avec des expressions.

Actuellement, le seul format autre que les séries chronologiques (nombre) est pris en charge lors de l'utilisation de trames de données est que vous avez une réponse tabulaire qui renvoie une trame de données sans heure, des colonnes de chaîne et une colonne numérique :

Le tableau d'exemple suivant produit un nombre qui fonctionne avec les expressions. Les colonnes de chaîne deviennent des étiquettes et la colonne numérique la valeur correspondante. Par exemple, `{"Loc": "MIA", "Host": "A"}` avec une valeur de 1.


| Lock | Host (Hôte) | Processeur AVG | 
| --- | --- | --- | 
| MIA | A | 1 | 
| NYC | B | 2 | 

**Opérations**

Vous pouvez utiliser les opérations suivantes dans les expressions : mathématiques, réduction et rééchantillonnage.

**Math**

Les mathématiques concernent les formules mathématiques de forme libre sur des séries chronologiques ou des données numériques. Les opérations mathématiques prennent des nombres et des séries chronologiques en entrée et les transforment en différents nombres et séries chronologiques.

Les données provenant d'autres requêtes ou expressions sont référencées avec le RefID préfixé par un signe dollar, par exemple. `$A` Si le nom de la variable comporte des espaces, vous pouvez utiliser une syntaxe entre accolades telle que`${my variable}`.

Les constantes numériques peuvent être exprimées en décimal (`2.24`), octal (avec un zéro en tête`072`) ou hexadécimal (avec un 0x en tête). `0x2A` Les exponentielles et les signes sont également pris en charge (par exemple,`-0.8e-2`).

**Opérateurs**

Les opérateurs arithmétiques (`+`, binaires et unaires`-`,`*`,`/`,`%`, exposant`**`), relationnels (,`<`,,, `>` `==``!=`, `>=``<=`) et logiques (, `&&``||`, et unaires`!`) sont pris en charge.

Le comportement de l'opération avec les données varie selon qu'il s'agit d'un nombre ou d'une série chronologique.

Dans le cas d'opérations binaires, telles que `$A + $B` ou`$A || $B`, l'opérateur est appliqué de la manière suivante en fonction du type de données :
+ Si les deux `$A` et `$B` sont des nombres, l'opération est effectuée entre les deux nombres.
+ Si l'une des variables est un nombre et l'autre une série chronologique, l'opération entre la valeur de chaque point de la série chronologique et le nombre est effectuée.
+ Si `$A` les deux `$B` sont des données de séries chronologiques, l'opération entre chaque valeur des deux séries est effectuée pour chaque horodatage existant dans `$A` les deux séries`$B`. L'`Resample`opération peut être utilisée pour aligner les horodatages.

Résumé :
+ Numéro <Operation>numéro = numéro
+ <Operation>Série de numéros = série
+ <Operation>Série = série

Comme les expressions fonctionnent avec plusieurs séries ou nombres représentés par une seule variable, les opérations binaires effectuent également une union (jointure) entre les deux variables. Cela se fait sur la base des étiquettes d'identification associées à chaque série ou numéro individuel.

Ainsi, si vous avez des numéros avec des étiquettes comme `{host=web01}` in `$A` et un autre numéro `$B` avec les mêmes étiquettes, l'opération est effectuée entre ces deux éléments au sein de chaque variable, et le résultat partagera les mêmes étiquettes. Les règles de comportement de ce syndicat sont les suivantes :
+ Un article sans étiquette s'associera à quoi que ce soit.
+ Si `$A` les `$B` deux ne contiennent qu'un seul article (une série ou un numéro), ils se joindront.
+ Si les étiquettes correspondent exactement, elles se joindront.
+ Si les étiquettes sont un sous-ensemble des autres, par exemple si un élément `$A` est étiqueté `{host=A,dc=MIA}` et qu'un élément `$B` est étiqueté, `{host=A}` elles se joindront.
+ Si dans une variable, par exemple, `$A` il existe des clés de balise différentes pour chaque élément, le comportement de jointure n'est pas défini.

Les opérateurs relationnels et logiques renvoient 0 pour faux, 1 pour vrai.

**Fonctions mathématiques**

Bien que la plupart des fonctions existent dans les propres opérations d'expression, l'opération mathématique comporte certaines fonctions similaires aux opérateurs mathématiques ou aux symboles. Lorsque les fonctions peuvent prendre des nombres ou des séries, le même type que l'argument sera renvoyé. Lorsqu'il s'agit d'une série, l'opération est effectuée pour la valeur de chaque point de la série.

*abdos*

abs renvoie la valeur absolue de son argument qui peut être un nombre ou une série. Par exemple, `abs(-1)` ou `abs($A)`.

*is\$1inf*

is\$1inf prend un nombre ou une série et renvoie `1` des `Inf` valeurs (négatives ou positives) et `0` d'autres valeurs. Par exemple `is_inf($A)`.

**Note**  
Si vous devez vérifier spécifiquement l'infini négatif par exemple, vous pouvez effectuer une comparaison comme`$A == infn()`.

*is\$1nan*

is\$1nan prend un nombre ou une série et renvoie `1` des `NaN` valeurs et `0` d'autres valeurs. Par exemple `is_nan($A)`. Cette fonction est requise pour cette vérification car elle n'`NaN`est pas égale à`NaN`.

*est\$1nul*

is\$1null prend un nombre ou une série et renvoie `1` des `null` valeurs et `0` d'autres valeurs. Par exemple `is_null($A)`.

*is\$1number*

is\$1number prend un nombre ou une série et renvoie toutes `1` les valeurs réelles et `0` les autres valeurs (qui sont`null`, `Inf+``Inf-`, et`NaN`). Par exemple `is_number($A)`.

*journal*

Log renvoie le logarithme naturel de son argument, qui peut être un nombre ou une série. Si la valeur est inférieure à 0, `NaN` est renvoyée. Par exemple, `log(-1)` ou `log($A)`.

*inf, infn, nan et null*

Les fonctions inf, infn, nan et null renvoient toutes une seule valeur du nom. Ils existent principalement pour les tests. Exemple: `null()`.

*round*

Round renvoie une valeur entière arrondie. Par exemple, `round(3.123)` ou `round($A)`.

*ceil*

Ceil arrondit le nombre à la valeur entière la plus proche. Par exemple, `ceil(3.123)` renvoie `4`.

*floor*

Floor arrondit le nombre à la valeur entière la plus proche. Par exemple,`floor(3.123`) renvoie`3`.

**Réduire**

Reduce prend une ou plusieurs séries chronologiques renvoyées par une requête ou une expression et transforme chaque série en un seul numéro. Les étiquettes de la série chronologique sont conservées sous forme d'étiquettes sur chaque nombre réduit produit.

*Champs :*
+ **Fonction** — La fonction de réduction à utiliser
+ **Entrée** — La variable (RefID (telle que`A`)) à rééchantillonner
+ **Mode** — Permet de contrôler le comportement de la fonction de réduction lorsqu'une série contient des valeurs non numériques (null, NaN, \$1-Inf)

**Fonctions de réduction**

*Count*

Count renvoie le nombre de points dans chaque série.

*Méchant*

La moyenne renvoie le total de toutes les valeurs de chaque série divisé par le nombre de points de cette série. En `strict` mode, si l'une des valeurs de la série est nulle ou nan, ou si la série est vide, NaN est renvoyé.

*Min et Max*

Min et Max renvoient respectivement la plus petite ou la plus grande valeur de la série. En `strict` mode, si l'une des valeurs de la série est nulle ou nan, ou si la série est vide, NaN est renvoyé.

*Sum*

Sum renvoie le total de toutes les valeurs de la série. Si la série est de longueur nulle, la somme sera égale à 0. En `strict` mode, s'il existe des valeurs NaN ou Null dans la série, NaN est renvoyé.

*Dernier*

Last renvoie le dernier chiffre de la série. Si la série n'a aucune valeur, elle renvoie NaN.

**Modes de réduction**

*Stricte*

En mode strict, la série d'entrées est traitée telle quelle. Si l'une des valeurs de la série n'est pas numérique (null, NaN ou \$1-Inf), NaN est renvoyé.

*Supprimer les données non numériques*

Dans ce mode, toutes les valeurs non numériques (null, NaN ou \$1-Inf) de la série d'entrée sont filtrées avant d'exécuter la fonction de réduction.

*Remplacer les données non numériques*

Dans ce mode, toutes les valeurs non numériques sont remplacées par une valeur prédéfinie.

**Rééchantillonner**

Resample modifie les horodatages de chaque série chronologique afin d'avoir un intervalle de temps constant. Le principal cas d'utilisation est que vous pouvez rééchantillonner des séries chronologiques qui ne partagent pas les mêmes horodatages afin de pouvoir effectuer des calculs entre elles. Cela peut être fait en rééchantillonnant chacune des deux séries, puis en effectuant une opération mathématique faisant référence aux variables rééchantillonnées.

*Champs :*
+ **Entrée** — Variable des données de séries chronologiques (RefID (par exemple`A`)) à rééchantillonner
+ **Rééchantillonner** vers : durée pendant laquelle le rééchantillonnage doit être effectué, par exemple. `10s` Les unités peuvent être `s` des secondes, `m` des minutes, `h` des heures, `d` des jours, `w` des semaines et `y` des années.
+ **Sous-échantillonnage** : fonction de réduction à utiliser lorsqu'il existe plusieurs points de données par échantillon de fenêtre. Voir l'opération de réduction pour plus de détails sur le comportement.
+ **Upsample** — Méthode à utiliser pour remplir un échantillon de fenêtre ne contenant aucun point de données.
  + **le pad** est rempli avec la dernière valeur connue
  + **remblai** avec la prochaine valeur connue
  + **fillna** pour remplir les fenêtres d'exemple vides avec NaNs

## Écrire une expression
<a name="v10-panels-query-write"></a>

Si votre source de données les prend en charge, Grafana affiche le bouton **Expression** et affiche toutes les expressions existantes dans la liste de l'éditeur de requêtes.

**Pour écrire une expression**

1. Ouvrez le panneau.

1. Sous la requête, choisissez **Expression**.

1. Dans le champ **Opération**, sélectionnez le type d'expression que vous souhaitez écrire.

1. Écrivez l'expression.

1. Cliquez sur **Appliquer**.

## Cas spéciaux
<a name="v10-panels-query-special"></a>

Lorsqu'une source de données interrogée ne renvoie aucune série ni aucun chiffre, le moteur d'expression le renvoie. `NoData` Par exemple, si une demande contient deux requêtes de source de données fusionnées par une expression, si elle `NoData` est renvoyée par au moins l'une des requêtes de source de données, le résultat renvoyé pour l'ensemble de la requête est`NoData`. Pour plus d'informations sur la façon dont Grafana Alerting traite les `NoData` résultats, consultez. [Configurer les règles d'alerte gérées par Grafana](v10-alerting-configure-grafanamanaged.md)

Dans le cas de l'utilisation d'une expression sur plusieurs requêtes, le moteur d'expression exige que toutes les requêtes renvoient un horodatage identique. Par exemple, si vous utilisez les mathématiques pour combiner le résultat de plusieurs requêtes SQL utilisées par chacune d'entre elles`SELECT NOW() AS "time"`, l'expression ne fonctionnera que si toutes les requêtes sont évaluées `NOW()` selon un horodatage identique, ce qui n'est pas toujours le cas. Pour résoudre ce problème, vous pouvez `NOW()` remplacer par une heure arbitraire, telle que`SELECT 1 AS "time"`, ou tout autre horodatage UNIX valide.

# Partage des résultats de requête avec un autre panneau
<a name="v10-panels-query-share"></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 d'utiliser le résultat de la requête d'un panneau pour n'importe quel autre panneau du tableau de bord. Le partage des résultats des requêtes entre les panneaux réduit le nombre de requêtes adressées à votre source de données, ce qui peut améliorer les performances de votre tableau de bord.

La source *de données du tableau de bord* vous permet de sélectionner un panneau de votre tableau de bord contenant les requêtes pour lesquelles vous souhaitez partager les résultats. Au lieu d'envoyer une requête distincte pour chaque panneau, Grafana envoie une requête et les autres panneaux utilisent les résultats de la requête pour créer des visualisations.

Cette stratégie permet de réduire considérablement le nombre de requêtes effectuées lorsque vous avez, par exemple, plusieurs panneaux visualisant les mêmes données.

**Pour partager les résultats d'une requête**

1. [Créez un tableau de bord](v10-dash-creating.md).

1. Changez le titre en`Source panel`. Vous allez utiliser ce panneau comme source pour les autres panneaux.

1. Définissez la ou les requêtes que vous souhaitez partager.

   Si aucune source de données n'est disponible, utilisez la source de données **Grafana**, qui renvoie une série chronologique aléatoire que vous pouvez utiliser pour les tests.

1. Ajoutez un deuxième panneau et sélectionnez la source de données du **tableau** de bord dans l'éditeur de requêtes.

1. Dans la **liste Utiliser les résultats du panneau**, sélectionnez le premier panneau que vous avez créé.

Toutes les requêtes définies dans le panneau source sont désormais disponibles dans le nouveau panneau. Les requêtes effectuées dans le panneau source peuvent être partagées avec plusieurs panneaux.

Vous pouvez cliquer sur n'importe laquelle des requêtes pour accéder au panneau où elles sont définies.

# Transformation de données
<a name="v10-panels-xform"></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)

Les transformations constituent un moyen puissant de manipuler les données renvoyées par une requête avant que le système n'applique une visualisation. À l'aide de transformations, vous pouvez :
+ Renommer les champs
+ Joindre les données de séries chronologiques
+ Effectuez des opérations mathématiques sur plusieurs requêtes
+ Utiliser le résultat d'une transformation comme entrée d'une autre transformation

Pour les utilisateurs qui s'appuient sur plusieurs vues du même jeu de données, les transformations constituent une méthode efficace pour créer et gérer de nombreux tableaux de bord.

Vous pouvez également utiliser le résultat d'une transformation comme entrée d'une autre transformation, ce qui se traduit par un gain de performance.

**Note**  
Parfois, le système ne peut pas représenter graphiquement les données transformées. Dans ce cas, cliquez sur le bouton **Vue tabulaire** au-dessus de la visualisation pour passer à une vue tabulaire des données. Cela peut vous aider à comprendre le résultat final de vos transformations.

## Types de transformation
<a name="v10-panels-xform-types"></a>

Grafana propose un certain nombre de méthodes pour transformer les données. Vous trouverez ci-dessous une liste complète des fonctions de transformation.

## Ordre des transformations
<a name="v10-panels-xform-order"></a>

Lorsqu'il y a plusieurs transformations, Grafana les applique dans l'ordre dans lequel elles sont répertoriées. Chaque transformation crée un jeu de résultats qui est ensuite transmis à la transformation suivante dans le pipeline de traitement.

L'ordre dans lequel Grafana applique les transformations a un impact direct sur les résultats. Par exemple, si vous utilisez une transformation Reduce pour condenser tous les résultats d'une colonne en une seule valeur, vous ne pouvez appliquer des transformations qu'à cette valeur unique.

## Ajouter une fonction de transformation aux données
<a name="v10-panels-xform-add"></a>

Les étapes suivantes vous guident dans l'ajout d'une transformation aux données. Cette documentation n'inclut pas les étapes pour chaque type de transformation.

**Pour ajouter une transformation à un panneau**

1. Accédez au panneau dans lequel vous souhaitez ajouter une ou plusieurs transformations.

1. Passez le pointeur de la souris sur n'importe quelle partie du panneau pour afficher le menu d'actions dans le coin supérieur droit.

1. Dans le menu Actions, choisissez **Modifier**.

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

1. Sélectionnez une transformation. Une ligne de transformation apparaît dans laquelle vous configurez les options de transformation.

1. Pour appliquer une autre transformation, choisissez **Ajouter une transformation**. Cette transformation agit sur le jeu de résultats renvoyé par la transformation précédente.

## Déboguer une transformation
<a name="v10-panels-xform-debug"></a>

Pour voir les ensembles de résultats d'entrée et de sortie de la transformation, cliquez sur l'icône de débogage (bogue) sur le côté droit de la ligne de transformation. Cela affichera les données d'entrée et le résultat de la transformation en sortie.

Les ensembles de résultats en entrée et en sortie peuvent vous aider à déboguer une transformation.

## Désactiver une transformation
<a name="v10-panels-xform-disable"></a>

Vous pouvez désactiver ou masquer une transformation en cliquant sur l'icône Afficher (œil) en haut à droite de la ligne de transformation. Cela désactive les actions appliquées à cette transformation spécifique et peut aider à identifier les problèmes lorsque vous modifiez plusieurs transformations les unes après les autres.

## Filtrer une transformation
<a name="v10-panels-xform-filter"></a>

Si votre transformation utilise plusieurs requêtes, vous pouvez les filtrer et appliquer la transformation sélectionnée à une seule des requêtes. Pour ce faire, cliquez sur l'icône du filtre en haut à droite de la ligne de transformation. Cela ouvre une liste déroulante contenant la liste des requêtes utilisées sur le panneau. À partir de là, vous pouvez sélectionner la requête que vous souhaitez transformer.

Vous pouvez également filtrer par annotations (y compris les exemplaires) pour leur appliquer des transformations. Dans ce cas, la liste des champs change pour refléter ceux de l'annotation ou de l'infobulle exemplaire.

L'icône du filtre est toujours affichée si votre panneau contient plusieurs requêtes ou sources de données (données de panneau ou d'annotation), mais elle risque de ne pas fonctionner si les transformations précédentes visant à fusionner les sorties des requêtes sont appliquées. Cela est dû au fait qu'une transformation prend le résultat de la précédente.

## Supprimer une transformation
<a name="v10-panels-xform-delete"></a>

Nous vous recommandons de supprimer les transformations dont vous n'avez pas besoin. Lorsque vous supprimez une transformation, vous supprimez les données de la visualisation.

Prérequis :

Identifiez tous les tableaux de bord qui reposent sur la transformation et informez les utilisateurs des tableaux de bord concernés.

**Pour supprimer une transformation**

1. Ouvrez un panneau pour le modifier.

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

1. Cliquez sur l'icône de corbeille à côté de la transformation que vous souhaitez supprimer.

# Fonctions de transformation
<a name="v10-panels-xform-functions"></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 effectuer les transformations suivantes sur vos données.

## Ajouter un champ à partir du calcul
<a name="v10-panels-xform-funcs-add"></a>

Utilisez cette transformation pour ajouter un nouveau champ calculé à partir de deux autres champs. Chaque transformation permet d'ajouter un nouveau champ.
+ **Mode** - Sélectionnez un mode :
  + **Réduire la ligne** — Appliquez le calcul sélectionné sur chaque ligne des champs sélectionnés indépendamment.
  + **Opération binaire** : appliquez des opérations binaires de base (par exemple, additionnez ou multipliez) sur les valeurs d'une seule ligne à partir de deux champs sélectionnés.
  + **Opération unaire** — Appliquez des opérations unaires de base sur les valeurs d'une seule ligne à partir d'un champ sélectionné. Les opérations disponibles sont les suivantes :
    + **Valeur absolue (abs)** — Renvoie la valeur absolue d'une expression donnée. Il représente la distance à partir de zéro sous forme de nombre positif.
    + **Exponentiel naturel (exp)** — Renvoie *e* élevé à la puissance d'une expression donnée.
    + **Logarithme naturel (ln)** — Renvoie le logarithme naturel d'une expression donnée.
    + **Floor (floor)** — Renvoie le plus grand entier inférieur ou égal à une expression donnée.
    + **Plafond (ceil)** : renvoie le plus petit entier supérieur ou égal à une expression donnée.
  + **Fonctions cumulatives** — Appliquez des fonctions à la ligne actuelle et à toutes les lignes précédentes.
    + **Total** — Calcule le total cumulé jusqu'à la ligne actuelle incluse.
    + **Moyenne** — Calcule la moyenne jusqu'à la ligne actuelle incluse.
  + **Fonctions de fenêtre** — Appliquez des fonctions de fenêtre. La fenêtre peut être *inclinée ou* *centrée*. Dans le cas d'une fenêtre de fin, la ligne actuelle sera la dernière ligne de la fenêtre. Avec une fenêtre centrée, la fenêtre sera centrée sur la ligne actuelle. Pour des fenêtres de tailles égales, la fenêtre sera centrée entre la ligne actuelle et la ligne précédente.
    + **Moyenne** — Calcule la moyenne mobile ou la moyenne courante.
    + ****— Calcule l'écart type mobile.
    + **Variance** : calculez la variance mobile.
  + **Index de ligne** — Insérez un champ avec l'index de ligne.
+ **Nom du champ** — Sélectionnez les noms des champs que vous souhaitez utiliser dans le calcul du nouveau champ.
+ **Calcul** : si vous sélectionnez **le mode Réduire les lignes**, le champ **Calcul** apparaît. Sélectionnez le champ pour voir la liste des choix de calcul que vous pouvez utiliser pour créer le nouveau champ. Pour plus d'informations sur les calculs disponibles, reportez-vous à la section [Types de calculs](v10-panels-calculation-types.md).
+ **Fonctionnement** : si vous sélectionnez le mode de **fonctionnement binaire** ou le mode de **fonctionnement unaire**, les champs **Opération** apparaissent. Ces champs vous permettent d'effectuer des opérations mathématiques de base sur les valeurs d'une seule ligne à partir de deux champs sélectionnés. Vous pouvez également utiliser des valeurs numériques pour les opérations binaires.
+ **En tant que percentile** : si vous sélectionnez le mode **index des lignes**, le commutateur **En tant que percentile** apparaît. Ce commutateur vous permet de transformer l'indice de ligne en pourcentage du nombre total de lignes.
+ **Alias** — (Facultatif) Entrez le nom de votre nouveau champ. Si vous laissez ce champ vide, le nom du champ correspondra au calcul.
+ **Remplacer tous les champs** — (Facultatif) Sélectionnez cette option si vous souhaitez masquer tous les autres champs et afficher uniquement votre champ calculé dans la visualisation.

**Note**  
**Les fonctions cumulatives** et **les fonctions de fenêtre** sont actuellement disponibles dans l'aperçu public. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.

## Concaténer des champs
<a name="v10-panels-xform-funcs-concat"></a>

**Concaténer des champs**

Utilisez cette transformation pour combiner tous les champs de tous les cadres en un seul résultat.

Par exemple, si vous avez des requêtes distinctes pour récupérer des données de température et de disponibilité (requête A) ainsi que des informations sur l'indice de qualité de l'air et les erreurs (requête b), l'application de la transformation concaténée produit un bloc de données consolidé contenant toutes les informations pertinentes dans une seule vue.

Considérez les deux suivants.

*Requête A :*


| Temp | Temps de disponibilité | 
| --- | --- | 
| 15,4 | 1230233 | 

*Requête B :*


| IQA | Erreurs | 
| --- | --- | 
| 3.2 | 5 | 

Après avoir concaténé les champs, le bloc de données serait le suivant :


| Temp | Temps de disponibilité | IQA | Erreurs | 
| --- | --- | --- | --- | 
| 15,4 | 1230233 | 3.2 | 5 | 

Cette transformation simplifie le processus de fusion de données provenant de différentes sources, fournissant une vue complète pour l'analyse et la visualisation.

## Config à partir des résultats de la requête
<a name="v10-panels-xform-funcs-config"></a>

**Config à partir des résultats de la requête**

Utilisez cette transformation pour sélectionner une requête et extraire les options standard telles que **Min**, **Max**, **Unit** et **Thresholds** et les appliquer aux autres résultats de requête. Cela permet une configuration de visualisation dynamique, basée sur les données renvoyées par une requête spécifique.

**Options**
+ **Requête de configuration** : sélectionnez la requête qui renvoie les données que vous souhaitez utiliser comme configuration.
+ **Appliquer à** : sélectionnez les champs ou les séries auxquels la configuration doit être appliquée.
+ **Appliquer aux options** : spécifiez un type de champ ou utilisez un nom de champ regex, en fonction de votre sélection dans **Appliquer à**.

**Table de mappage des champs**

Sous les options de configuration, vous trouverez le tableau de mappage des champs. Ce tableau répertorie tous les champs présents dans les données renvoyées par la requête de configuration, ainsi que les options **Utiliser comme** et **Sélectionner**. Il permet de contrôler le mappage des champs avec les propriétés de configuration, et pour plusieurs lignes, il vous permet de choisir la valeur à sélectionner.

L'exemple suivant montre une requête d'entrée et une requête utilisée comme configuration de champ.

*Requête d'entrée*


| Heure | Value | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

*Requête de configuration*


| Heure | Value | 
| --- | --- | 
| 1626178119127 | 100 | 
| 1626178119129 | 100 | 

*Requête de sortie (identique à l'entrée, mais maintenant avec config sur le champ de valeur)*


| Heure | Valeur (configuration : Max=100) | 
| --- | --- | 
| 1626178119127 | 10 | 
| 1626178119129 | 30 | 

Chaque champ possède désormais un ensemble d'options de configuration maximal. Des options telles que **Min**, **Max**, **Unit** et **Thresholds** font partie de la configuration du champ. Si elles sont définies, elles sont utilisées par la visualisation à la place des options configurées manuellement dans le volet d'options de l'éditeur de panneaux.

**Mappages de valeurs**

Vous pouvez également transformer le résultat d'une requête en mappages de valeurs. Avec cette option, chaque ligne du résultat de la requête de configuration définit une seule ligne de mappage de valeurs. Consultez l'exemple suivant.

*Résultat de la requête de configuration*


| Value | Texte | Couleur | 
| --- | --- | --- | 
|  L | Faible | blue | 
| M | Moyenne | green | 
| H | Élevée | red | 

*Dans le mappage des champs, spécifiez :*


| Champ | Utiliser comme | Select | 
| --- | --- | --- | 
| Value | Mappages de valeurs/Valeur | Toutes les valeurs | 
| Texte | Mappages de valeurs/Texte | Toutes les valeurs | 
| Couleur | Mappages de valeurs//Couleur | Toutes les valeurs | 

Grafana crée des mappages de valeurs à partir du résultat de votre requête et les applique aux résultats réels des requêtes de données. Vous devriez voir les valeurs mappées et colorées en fonction des résultats de la requête de configuration.

## Convertir le type de champ
<a name="v10-panels-xform-funcs-convert"></a>

Utilisez cette transformation pour modifier le type de champ du champ spécifié.

Cette transformation comporte les options suivantes :
+ **Champ** : sélectionnez l'un des champs disponibles.
+ **as** — Sélectionnez le FieldType vers lequel convertir.
  + **Numérique** : tente de numéroter les valeurs.
  + **Chaîne** — transformera les valeurs en chaînes.
  + **Heure** : tente d'analyser les valeurs en fonction du temps.
    + Affiche une option permettant de spécifier un DateFormat comme entrée par une chaîne, comme `yyyy-mm-dd` ou`DD MM YYYY hh:mm:ss`.
  + **Boolean** — rendra les valeurs booléennes.
  + **Enum** — fera en sorte que les valeurs s'énumèrent.
    + Affiche un tableau pour gérer les énumérations.
  + **Autre** — tente d'analyser les valeurs au format json.

Par exemple, considérez la requête suivante qui pourrait être modifiée en sélectionnant le champ horaire, comme **Heure**, et le format de date comme`YYYY`.


| Heure | Mark | Value | 
| --- | --- | --- | 
| 01/07/2017 | ci-dessus | 25 | 
| 02/08/2018 | ci-dessous | 22 | 
| 02/09/2019 | ci-dessous | 29 | 
| 04/10/2020 | ci-dessus | 22 | 

Le résultat :


| Heure | Mark | Value | 
| --- | --- | --- | 
| 01/01/2017 00:00:00 | ci-dessus | 25 | 
| 01/01/2018 00:00:00 | ci-dessous | 22 | 
| 01/01/2019 00:00:00 | ci-dessous | 29 | 
| 01/01/2020 00:00:00 | ci-dessus | 22 | 

Cette transformation vous permet d'adapter de manière flexible vos types de données, garantissant ainsi la compatibilité et la cohérence de vos visualisations.

## Extraire les champs
<a name="v10-panels-xform-funcs-extract"></a>

Utilisez cette transformation pour sélectionner une source de données et en extraire le contenu sous différents formats. Cette transformation comporte les champs suivants :
+ **Source** : sélectionnez le champ correspondant à la source des données.
+ **Format** — Choisissez l'une des options suivantes :
  + **JSON** — Analyse le contenu JSON à partir de la source.
  + **Paires clé\$1valeur** : analyse le contenu au format `a=b` ou à `c:d` partir de la source.
  + **Auto** — Découvrez les champs automatiquement.
+ **Remplacer tous les champs** — (Facultatif) Sélectionnez cette option pour masquer tous les autres champs et afficher uniquement votre champ calculé dans la visualisation.
+ **Keep Time** - (Facultatif) Disponible uniquement si **Remplacer tous les champs** est vrai. Conserve le champ horaire dans la sortie.

Considérez le jeu de données suivant :

**Exemple de jeu de données**


| Horodatage | données\$1json | 
| --- | --- | 
| 1636678740000000000 | \$1« valeur » : 1\$1 | 
| 1636678680000000000 | \$1« valeur » : 5\$1 | 
| 1636678620000000000 | \$1« valeur » : 12\$1 | 

Vous pouvez préparer les données à utiliser par un [panneau de séries chronologiques](v10-panels-time-series.md) avec cette configuration :
+ Source : json\$1data
+ Format : JSON
  + Champ : valeur
  + Alias : my\$1value
+ Remplacer tous les champs : vrai
+ Keep Time : vrai

Cela générera le résultat suivant :

**Données transformées**


| Horodatage | ma\$1valeur | 
| --- | --- | 
| 1636678740000000000 | 1 | 
| 1636678680000000000 | 5 | 
| 1636678620000000000 | 12 | 

Cette transformation vous permet d'extraire et de formater des données de différentes manières. Vous pouvez personnaliser le format d'extraction en fonction de vos besoins spécifiques en matière de données.

## Champs de recherche à partir de la ressource
<a name="v10-panels-xform-funcs-lookup"></a>

Utilisez cette transformation pour enrichir la valeur d'un champ en recherchant des champs supplémentaires à partir d'une source externe.

Cette transformation comporte les champs suivants :
+ **Champ** : sélectionnez un champ de texte dans votre jeu de données.
+ **Recherche** — Choisissez parmi **les pays**, **les États américains** et les **aéroports**.

**Note**  
Cette transformation prend uniquement en charge les données spatiales.

Par exemple, si vous disposez de ces données :

**Exemple de jeu de données**


| Location | Valeurs | 
| --- | --- | 
| AL | 0 | 
| CHÊNE | 10 | 
| Arizona | 5 | 
| Arkansas | 1 | 
| Quelque part | 5 | 

Avec cette configuration :
+ Domaine : localisation
+ Rechercher : États-Unis

Vous obtiendrez le résultat suivant :

**Données transformées**


| Location | ID | Nom | Lng | Lat | Valeurs | 
| --- | --- | --- | --- | --- | --- | 
| AL | AL | Alabama | -80,891064 | 12,448457 | 0 | 
| CHÊNE | CHÊNE | Arkansas | -100,891064 | 24,448457 | 10 | 
| Arizona |  |  |  |  | 5 | 
| Arkansas |  |  |  |  | 1 | 
| Quelque part |  |  |  |  | 5 | 

Cette transformation vous permet d'augmenter vos données en récupérant des informations supplémentaires auprès de sources externes, fournissant ainsi un ensemble de données plus complet pour l'analyse et la visualisation.

## Filtrer les données par requête RefID
<a name="v10-panels-xform-funcs-queryrefid"></a>

Utilisez cette transformation pour masquer une ou plusieurs requêtes dans les panneaux contenant plusieurs requêtes.

Grafana affiche les lettres d'identification de la requête en texte gris foncé. Choisissez un identifiant de requête pour activer le filtrage. Si la lettre de requête est blanche, les résultats sont affichés. Si la lettre de requête est foncée, les résultats sont masqués.

**Note**  
Cette transformation n'est pas disponible pour Graphite car cette source de données ne permet pas de corréler les données renvoyées avec les requêtes.

## Filtrer les données par valeurs
<a name="v10-panels-xform-funcs-values"></a>

Utilisez cette transformation pour filtrer de manière sélective les points de données directement dans votre visualisation. Cette transformation fournit des options permettant d'inclure ou d'exclure des données en fonction d'une ou de plusieurs conditions appliquées à un champ sélectionné.

Cette transformation est très utile si votre source de données ne filtre pas nativement par valeurs. Vous pouvez également l'utiliser pour affiner les valeurs à afficher si vous utilisez une requête partagée.

Les conditions disponibles pour tous les champs sont les suivantes :
+ **Regex** — Correspond à une expression regex.
+ **Est nul** — Correspond si la valeur est nulle.
+ **N'est pas nulle** — Correspond si la valeur n'est pas nulle.
+ **Égal** — Correspond si la valeur est égale à la valeur spécifiée.
+ **Différent** — Correspond si la valeur est différente de la valeur spécifiée.

Les conditions supplémentaires disponibles pour les champs numériques sont les suivantes :
+ **Plus grand** — Correspond si la valeur est supérieure à la valeur spécifiée.
+ **Inférieur** — Correspond si la valeur est inférieure à la valeur spécifiée.
+ **Supérieur ou égal** — Correspond si la valeur est supérieure ou égale.
+ **Inférieur ou égal** — Correspond si la valeur est inférieure ou égale.
+ **Plage** : correspond à une plage comprise entre un minimum et un maximum spécifiés, un minimum et un maximum inclus.

Considérez le jeu de données suivant :


| Heure | Température | Altitude | 
| --- | --- | --- | 
| 2020-07-07 11:34:23 | 32 | 101 | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:32:24 | 31 | 95 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

Si vous **incluez** les points de données dont la température est inférieure à 30 °C, la configuration se présentera comme suit :
+ Type de filtre : « Inclure »
+ Condition : lignes où « Température » correspond à « Inférieure à » 30 »

Et vous obtiendrez le résultat suivant, où seules les températures inférieures à 30 °C sont incluses :

**Données transformées**


| Heure | Température | Altitude | 
| --- | --- | --- | 
| 2020-07-07 11:34:22 | 28 | 125 | 
| 2020-07-07 11:34:21 | 26 | 110 | 
| 2020-07-07 11:34:20 | 23 | 98 | 
| 2020-07-07 10:31:22 | 20 | 85 | 
| 2020-07-07 09:30:57 | 19 | 101 | 

Vous pouvez ajouter plusieurs conditions au filtre. Par exemple, vous souhaiterez peut-être inclure les données uniquement si l'altitude est supérieure à 100. Pour ce faire, ajoutez cette condition à la configuration suivante :
+ Type de filtre : « Inclure » les lignes qui « répondent à toutes les conditions »
+ Condition 1 : Lignes où « Température » correspond à « Inférieur » à « 30 »
+ Condition 2 : Lignes où « Altitude » correspond à « Supérieur » à « 100 »

**Lorsque vous avez plusieurs conditions, vous pouvez choisir si vous souhaitez que l'action (inclusion/exclusion) soit appliquée aux lignes qui **correspondent à toutes les** conditions ou à l'une des conditions que vous avez ajoutées.**

Dans l'exemple ci-dessus, nous avons choisi **Match all** parce que nous voulions inclure les lignes dont la température est inférieure à 30 °C *ET* dont l'altitude est supérieure à 100. Si nous voulions plutôt inclure les lignes dont la température est inférieure à 30 °C *OU* dont l'altitude est supérieure à 100 °C, nous sélectionnerions **Match any**. Cela inclurait la première ligne des données d'origine, qui a une température de 32 °C (ne correspond pas à la première condition) mais une altitude de 101 (ce qui correspond à la deuxième condition), elle est donc incluse.

Les conditions non valides ou incomplètement configurées sont ignorées.

Cette transformation polyvalente de filtrage des données vous permet d'inclure ou d'exclure de manière sélective des points de données en fonction de conditions spécifiques. Personnalisez les critères pour adapter la présentation de vos données à vos besoins analytiques uniques.

## Filtrer les champs par nom
<a name="v10-panels-xform-funcs-name"></a>

Utilisez cette transformation pour supprimer des parties des résultats de votre requête. Il existe trois méthodes pour filtrer les noms de champs :
+ Entrez une expression régulière.
+ Sélectionnez manuellement les champs inclus.
+ Utilisez une variable de tableau de bord.

*Utiliser une expression régulière*

Lorsque vous filtrez à l'aide d'une expression régulière, les noms de champs correspondant à l'expression régulière sont inclus. Par exemple, l'utilisation de l'expression régulière `'prod.*'` renverrait uniquement les champs commençant par `prod`

L'expression régulière peut inclure une variable de tableau de bord interpolée à l'aide de la `${variableName}` syntaxe.

*Sélectionnez manuellement les champs inclus*

Sélectionnez ou désélectionnez les noms de champs pour les supprimer du résultat. Si une expression régulière est également incluse, les champs auxquels l'expression correspond sont inclus, même s'ils ne sont pas cochés.

*Utiliser une variable de tableau de bord*

Sélectionnez **À partir de la variable** pour sélectionner une variable de tableau de bord utilisée pour inclure des champs. En configurant une variable de tableau de bord à choix multiples, les mêmes champs peuvent être affichés dans plusieurs visualisations.

Cette transformation offre la flexibilité nécessaire pour personnaliser les résultats de vos requêtes afin de vous concentrer sur les champs spécifiques dont vous avez besoin pour une analyse et une visualisation efficaces.

## Chaîne de format
<a name="v10-panels-xform-funcs-string"></a>

Utilisez cette transformation pour personnaliser la sortie d'un champ de chaîne. Cette transformation comporte les champs suivants :
+ **Majuscules** — Formate la chaîne entière en majuscules.
+ **Minuscules** : met en forme la chaîne entière en minuscules.
+ **Phrase** majuscule — Formate le premier caractère de la chaîne en majuscules.
+ **Titre en majuscules** : met en majuscules le premier caractère de chaque mot de la chaîne.
+ **Cas Pascal** — Formate le premier caractère de chaque mot de la chaîne en majuscules et n'inclut pas d'espaces entre les mots.
+ **Camel case** — Formate le premier caractère de chaque mot de la chaîne en majuscules, à l'exception du premier mot, et n'inclut pas d'espaces entre les mots.
+ **Snake case** — Formate tous les caractères de la chaîne en minuscules et utilise des traits de soulignement au lieu d'espaces entre les mots.
+ **Étui pour kebab** : met en forme tous les caractères de la chaîne en minuscules et utilise des tirets au lieu d'espaces entre les mots.
+ **Découper** — Supprime tous les espaces de début et de fin de la chaîne.
+ **Sous-chaîne** — Renvoie une sous-chaîne de la chaîne, en utilisant les positions de début et de fin spécifiées.

Cette transformation constitue un moyen pratique de standardiser et d'adapter la présentation des données de chaîne pour une meilleure visualisation et une meilleure analyse.

**Note**  
Cette transformation est actuellement en avant-première publique. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.

## Heure du formatage
<a name="v10-panels-xform-funcs-time"></a>

Utilisez cette transformation pour personnaliser le résultat d'un champ temporel. La sortie peut être formatée à l'aide des [chaînes de format Moment.js](https://momentjs.com/docs/#/displaying/). Par exemple, si vous souhaitez afficher uniquement l'année d'un champ horaire, la chaîne de format « YYYY » peut être utilisée pour afficher l'année civile (par exemple, 1999 ou 2012).

**Avant la transformation :**


| Horodatage | Événement | 
| --- | --- | 
| 1636678740000000000 | Démarrage du système | 
| 1636678680000000000 | Login utilisateur | 
| 1636678620000000000 | Données mises à jour | 

**Après avoir appliqué « YYYY-MM-DD  HH:MM:SS » :**


| Horodatage | Événement | 
| --- | --- | 
| 2021-11-12 14:25:40 | Démarrage du système | 
| 2021-11-12 14:24:40 | Login utilisateur | 
| 2021-11-12 14:23:40 | Données mises à jour | 

Cette transformation vous permet d'adapter la représentation temporelle dans vos visualisations, offrant ainsi flexibilité et précision lors de l'affichage des données temporelles.

**Note**  
Cette transformation est disponible dans les espaces de travail compatibles avec Grafana v10 en tant que fonctionnalité alpha.

## Regrouper par
<a name="v10-panels-xform-funcs-group"></a>

Cette transformation regroupe les données selon une valeur de champ (colonne) spécifiée et traite les calculs pour chaque groupe. Sélectionnez pour afficher la liste des choix de calcul.

Voici un exemple de données d'origine.


| Heure | ID serveur | Température du processeur | État du serveur | 
| --- | --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 80 | Fermeture | 
| 07/07/2020 11 H 34 MIN 20 S | serveur 3 | 62 | OK | 
| 07/07/2020 10 H 32 MIN 20 S | serveur 2 | 90 | Surcharge | 
| 07/07/2020 10 H 31 H 22 | serveur 3 | 55 | OK | 
| 07/07/2020 9 H 30 : 57 | serveur 3 | 62 | Rebooting | 
| 07/07/2020 9 H 30 : 05 | serveur 2 | 88 | OK | 
| 07/07/2020 9 H 28 : 06 | serveur 1 | 80 | OK | 
| 07/07/2020 9 H 25 MIN 05 S | serveur 2 | 88 | OK | 
| 07/07/2020 9 H 23 H 07 | serveur 1 | 86 | OK | 

Cette transformation s'effectue en deux étapes. Vous devez d'abord spécifier un ou plusieurs champs pour regrouper les données. Cela regroupera les mêmes valeurs de ces champs, comme si vous les aviez triées. Par exemple, si nous groupons par le champ ID du serveur, les données seront regroupées de la façon suivante :


| Heure | ID serveur | Température du processeur | État du serveur | 
| --- | --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 80 | Fermeture | 
| 07/07/2020 9 H 28 : 06 | serveur 1 | 80 | OK | 
| 07/07/2020 9 H 23 H 07 | serveur 1 | 86 | OK | 
| 07/07/2020 10 H 32 MIN 20 S | serveur 2 | 90 | Surcharge | 
| 07/07/2020 9 H 30 : 05 | serveur 2 | 88 | OK | 
| 07/07/2020 9 H 25 MIN 05 S | serveur 2 | 88 | OK | 
| 07/07/2020 11 H 34 MIN 20 S | serveur 3 | 62 | OK | 
| 07/07/2020 10 H 31 H 22 | serveur 3 | 55 | OK | 
| 07/07/2020 9 H 30 : 57 | serveur 3 | 62 | Rebooting | 

Toutes les lignes ayant la même valeur d'ID de serveur sont regroupées.

Après avoir choisi le champ par lequel vous souhaitez regrouper vos données, vous pouvez ajouter différents calculs sur les autres champs et appliquer le calcul à chaque groupe de lignes. Par exemple, nous pourrions vouloir calculer la température moyenne du processeur pour chacun de ces serveurs. Nous pouvons donc ajouter le calcul *moyen* appliqué sur le champ de température du processeur pour obtenir ce qui suit :


| ID serveur | Température du processeur (moyenne) | 
| --- | --- | 
| serveur 1 | 82 | 
| serveur 2 | 88,6 | 
| serveur 3 | 59,6 | 

Et nous pouvons ajouter plusieurs calculs. Par exemple :
+ Pour le champ Time, nous pouvons calculer la *dernière* valeur, afin de savoir quand le dernier point de données a été reçu pour chaque serveur
+ Pour le champ État du serveur, nous pouvons calculer la *dernière* valeur pour savoir quelle est la dernière valeur d'état pour chaque serveur
+ Pour la température du terrain, nous pouvons également calculer la *dernière* valeur pour savoir quelle est la dernière température surveillée pour chaque serveur

Nous obtiendrions alors :


| ID serveur | Température du processeur (moyenne) | Température du processeur (dernière) | Heure (dernière) | État du serveur (dernier) | 
| --- | --- | --- | --- | --- | 
| serveur 1 | 82 | 80 | 07/07/2020 11 H 34 MIN 20 S | Fermeture | 
| serveur 2 | 88,6 | 90 | 07/07/2020 10 H 32 MIN 20 S | Surcharge | 
| serveur 3 | 59,6 | 62 | 07/07/2020 11 H 34 MIN 20 S | OK | 

Cette transformation vous permet d'extraire des informations clés de vos séries chronologiques et de les afficher de manière pratique.

## Regroupement dans une matrice
<a name="v10-panels-xform-funcs-groupmatrix"></a>

Utilisez cette transformation pour combiner trois champs, qui sont utilisés comme entrée pour les champs de **valeur de **colonne**, de **ligne** et de cellule** à partir de la sortie de la requête, et pour générer une matrice. La matrice est calculée comme suit :

**Données d'origine**


| ID serveur | Température du processeur | État du serveur | 
| --- | --- | --- | 
| serveur 1 | 82 | OK | 
| serveur 2 | 88,6 | OK | 
| serveur 3 | 59,6 | Fermeture | 

Nous pouvons générer une matrice en utilisant les valeurs `Server Status` des noms de colonnes, des `Server ID` valeurs des noms de lignes et du `CPU Temperature` contenu de chaque cellule. Le contenu de chaque cellule apparaîtra pour la combinaison de colonnes (`Server Status`) et de lignes (`Server ID`) existante. Pour le reste des cellules, vous pouvez sélectionner la valeur à afficher : **Null**, **True**, **False** ou **Empty**.

**Sortie**


|  IDServer État du serveur | OK | Fermeture | 
| --- | --- | --- | 
| serveur 1 | 82 |  | 
| serveur 2 | 88,6 |  | 
| serveur 3 |  | 59,6 | 

Utilisez cette transformation pour créer une matrice en spécifiant des champs à partir des résultats de votre requête. La sortie de la matrice reflète les relations entre les valeurs uniques de ces champs. Cela vous permet de présenter des relations complexes dans un format matriciel clair et structuré.

## Grouper vers une table imbriquée
<a name="v10-panels-xform-funcs-grouptable"></a>

Utilisez cette transformation pour regrouper les données selon une valeur de champ (colonne) spécifiée et effectuer le calcul sur chaque groupe. Les enregistrements générés partagent la même valeur de champ groupée, à afficher dans une table imbriquée.

Pour calculer une statistique pour un champ, cochez la case à côté du champ et choisissez l'option **Calculer**. Cela ajoutera une autre boîte de sélection avec les statistiques à sélectionner.

Le tableau suivant présente des exemples de données.


| Heure | ID serveur | Température du processeur | État du serveur | 
| --- | --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 80 | Fermeture | 
| 07/07/2020 11 H 34 MIN 20 S | serveur 3 | 62 | OK | 
| 07/07/2020 10 H 32 MIN 20 S | serveur 2 | 90 | Surcharge | 
| 07/07/2020 10 H 31 H 22 | serveur 3 | 55 | OK | 
| 07/07/2020 9 H 30 : 57 | serveur 3 | 62 | Rebooting | 
| 07/07/2020 9 H 30 : 05 | serveur 2 | 88 | OK | 
| 07/07/2020 9 H 28 : 06 | serveur 1 | 80 | OK | 
| 07/07/2020 9 H 25 MIN 05 S | serveur 2 | 88 | OK | 
| 07/07/2020 9 H 23 H 07 | serveur 1 | 86 | OK | 

Cette transformation comporte deux étapes. Spécifiez d'abord un ou plusieurs champs selon lesquels vous souhaitez regrouper les données. Cela regroupe toutes les mêmes valeurs de ces champs, comme si vous les triiez. Par exemple, si vous regroupez par `Server ID` champ, Grafana regroupe les données de la façon suivante :


| ID serveur | Données | 
| --- | --- | 
| Heure | Température du processeur | État du serveur | 
| --- | --- | --- | 
| Heure | Température du processeur | État du serveur | 
| --- | --- | --- | 
| Heure | Température du processeur | État du serveur | 
| --- | --- | --- | 
| serveur 1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| serveur 2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| serveur 3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 07/07/2020 11 H 34 MIN 20 S | 80 | Fermeture | 
| 07/07/2020 9 H 28 : 06 | 80 | OK | 
| 07/07/2020 9 H 23 H 07 | 86 | OK | 
| 07/07/2020 10 H 32 MIN 20 S | 90 | Surcharge | 
| 07/07/2020 9 H 30 : 05 | 88 | OK | 
| 07/07/2020 9 H 25 MIN 05 S | 88 | OK | 
| 07/07/2020 11 H 34 MIN 20 S | 62 | OK | 
| 07/07/2020 10 H 31 H 22 | 55 | OK | 
| 07/07/2020 9 H 30 : 57 | 62 | Rebooting | 

Après avoir choisi le champ selon lequel vous souhaitez regrouper vos données, vous pouvez ajouter différents calculs sur les autres champs et appliquer le calcul à chaque groupe de lignes. Par exemple, vous souhaiterez peut-être calculer la température moyenne du processeur pour chacun de ces serveurs. Pour ce faire, ajoutez le calcul moyen appliqué dans le champ Température du processeur pour obtenir le résultat suivant :


| ID serveur | Température du processeur (moyenne) |  | 
| --- | --- | --- | 
| Heure | État du serveur | 
| --- | --- | 
| Heure | État du serveur | 
| --- | --- | 
| Heure | État du serveur | 
| --- | --- | 
| serveur 1 | 82 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| serveur 2 | 88,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| serveur 3 | 59,6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/v10-panels-xform-functions.html) | 
| 07/07/2020 11 H 34 MIN 20 S | Fermeture | 
| 07/07/2020 9 H 28 : 06 | OK | 
| 07/07/2020 9 H 23 H 07 | OK | 
| 07/07/2020 10 H 32 MIN 20 S | Surcharge | 
| 07/07/2020 9 H 30 : 05 | OK | 
| 07/07/2020 9 H 25 MIN 05 S | OK | 
| 07/07/2020 11 H 34 MIN 20 S | OK | 
| 07/07/2020 10 H 31 H 22 | OK | 
| 07/07/2020 9 H 30 : 57 | Rebooting | 

## Création d'une carte thermique
<a name="v10-panels-xform-funcs-heatmap"></a>

Utilisez cette transformation pour préparer les données d'histogramme afin de visualiser les tendances au fil du temps. À l'instar de la visualisation par carte thermique, cette transformation convertit les métriques de l'histogramme en compartiments temporels.

**Seau X**

Ce paramètre détermine la façon dont l'axe X est divisé en compartiments.
+ **Taille** — Spécifiez un intervalle de temps dans le champ de saisie. Par exemple, une plage de temps de `1h` crée des cellules d'une heure de large sur l'axe X.
+ **Nombre** — Pour les non-time-related séries, utilisez cette option pour définir le nombre d'éléments dans un compartiment.

**Seau Y**

Ce paramètre détermine la façon dont l'axe Y est divisé en compartiments.
+ **Linear (Linéaire)**
+ **Logarithmique** — Choisissez entre log base 2 ou log base 10.
+ **Symlog** — Utilise une échelle logarithmique symétrique. Choisissez entre le log base 2 ou le log base 10, en tenant compte des valeurs négatives.

Supposons que vous disposiez du jeu de données suivant :


| Horodatage | Value | 
| --- | --- | 
| 01/01/2023 12:00:00 | 5 | 
| 01/01/2023 12:15:00 | 10 | 
| 01/01/2023 12:30:00 | 15 | 
| 01/01/2023 12:45:00 | 8 | 
+ Lorsque X Bucket est défini sur `Size: 15m` et Y Bucket sur tel`Linear`, l'histogramme organise les valeurs en intervalles de temps de 15 minutes sur l'axe X et de manière linéaire sur l'axe Y.
+ Pour X Bucket as `Count: 2` et Y Bucket as`Logarithmic (base 10)`, l'histogramme regroupe les valeurs en tranches de deux sur l'axe X et utilise une échelle logarithmique sur l'axe Y.

## Histogramme
<a name="v10-panels-xform-funcs-histogram"></a>

Utilisez cette transformation pour générer un histogramme basé sur les données d'entrée, afin de visualiser la distribution des valeurs.
+ **Taille du compartiment** : plage entre les éléments les plus bas et les plus élevés d'un compartiment (XMin à XMax).
+ **Décalage du godet** — Le décalage pour les non-zero-based godets.
+ **Combiner des séries** : créez un histogramme unifié à l'aide de toutes les séries disponibles.

**Données d'origine**

Série 1 :


| A |  B |  C | 
| --- | --- | --- | 
| 1 | 3 | 5 | 
| 2 | 4 | 6 | 
| 3 | 5 | 7 | 
| 4 | 6 | 8 | 
| 5 | 7 | 9 | 

Série 2 :


| C | 
| --- | 
| 5  | 
| 6 | 
| 7 | 
| 8 | 
| 9 | 

**Sortie**


| X min | X Max | A |  B |  C | C | 
| --- | --- | --- | --- | --- | --- | 
| 1 | 2 | 1 | 0 | 0 | 0 | 
| 2 | 3 | 1 | 0 | 0 | 0 | 
| 3 | 4 | 1 | 1 | 0 | 0 | 
| 4 | 5 | 1 | 1 | 0 | 0 | 
| 5  | 6 | 1 | 1 | 1 | 1 | 
| 6 | 7 | 0 | 1 | 1 | 1 | 
| 7 | 8 | 0 | 1 | 1 | 1 | 
| 8 | 9 | 0 | 0 | 1 | 1 | 
| 9 | 10 | 0 | 0 | 1 | 1 | 

Visualisez la distribution des valeurs à l'aide de l'histogramme généré, qui fournit des informations sur la répartition et la densité des données.

## Inscrivez-vous par domaine
<a name="v10-panels-xform-funcs-joinfield"></a>

Utilisez cette transformation pour fusionner plusieurs résultats dans une seule table, ce qui permet de consolider les données issues de différentes requêtes.

Cela est particulièrement utile pour convertir plusieurs résultats de séries chronologiques en une seule table large avec un champ horaire partagé.

**Jointure intérieure**

Une jointure interne fusionne les données de plusieurs tables où toutes les tables partagent la même valeur que le champ sélectionné. Ce type de jointure exclut les données dont les valeurs ne correspondent pas dans tous les résultats.

Utilisez cette transformation pour combiner les résultats de plusieurs requêtes (combinaison sur un champ de jointure passé ou sur la première colonne chronologique) en un seul résultat, et supprimez les lignes où une jointure réussie ne peut pas avoir lieu.

Dans l'exemple suivant, deux requêtes renvoient des données de table. Il est visualisé sous la forme de deux tables distinctes avant d'appliquer la transformation de jointure interne.

Requête A :


| Heure | Tâche | Temps de disponibilité | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 | 
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 | 
| 07/07/2020 11 H 14 H 20 | postgre | 345001233 | 

Requête B :


| Heure | Serveur | Erreurs | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 15 | 
| 07/07/2020 11 H 24 H 20 | serveur 2 | 5 | 
| 07/07/2020 11 H 04 : 20 | serveur 3 | 10 | 

Le résultat obtenu après l'application de la transformation de jointure interne est le suivant :


| Heure | Tâche | Temps de disponibilité | Serveur | Erreurs | 
| --- | --- | --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 | serveur 1 | 15 | 
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 | serveur 2 | 5 | 

*Jointure extérieure*

Une jointure externe inclut toutes les données d'une jointure interne et les lignes dont les valeurs ne correspondent pas dans toutes les entrées. Alors que la jointure interne joint la requête A et la requête B dans le champ temporel, la jointure externe inclut toutes les lignes qui ne correspondent pas dans le champ temporel.

Dans l'exemple suivant, deux requêtes renvoient des données de table. Il est visualisé sous la forme de deux tables avant d'appliquer la transformation de jointure externe.

Requête A :


| Heure | Tâche | Temps de disponibilité | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 | 
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 | 
| 07/07/2020 11 H 14 H 20 | postgre | 345001233 | 

Requête B :


| Heure | Serveur | Erreurs | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | serveur 1 | 15 | 
| 07/07/2020 11 H 24 H 20 | serveur 2 | 5 | 
| 07/07/2020 11 H 04 : 20 | serveur 3 | 10 | 

Le résultat obtenu après l'application de la transformation de jointure externe est le suivant :


| Heure | Tâche | Temps de disponibilité | Serveur | Erreurs | 
| --- | --- | --- | --- | --- | 
| 07/07/2020 11 H 04 : 20 |  |  | serveur 3 | 10 | 
| 07/07/2020 11 H 14 H 20 | postgre | 345001233 |  |  | 
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 | serveur 1 | 15 | 
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 | serveur 2 | 5 | 

## Adhérer par labels
<a name="v10-panels-xform-funcs-joinlabel"></a>

Utilisez cette transformation pour joindre plusieurs résultats dans un seul tableau.

Cela est particulièrement utile pour convertir plusieurs résultats de séries chronologiques en une seule table large avec un champ **Label** partagé.
+ **Joindre** : sélectionnez l'étiquette à joindre entre les étiquettes disponibles ou communes à toutes les séries chronologiques.
+ **Valeur** — Nom du résultat de sortie.

**Exemple**

Entrée 1 : `series1{what='Temp', cluster='A', job='J1'}`


| Heure | Value | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Entrée 2 : `series2{what='Temp', cluster='B', job='J1'}`


| Heure | Value | 
| --- | --- | 
| 1 | 10 | 
| 2 | 200 | 

Entrée 3 : `series3{what='Speed', cluster='B', job='J1'}`


| Heure | Value | 
| --- | --- | 
| 22 | 22 | 
| 28 | 77 | 

Config :

```
value: 'what'
```

Sortie :


| cluster | tâche | Temp | Vitesse | 
| --- | --- | --- | --- | 
| A | J1 | 10 |  | 
| A | J1 | 200 |  | 
| B | J1 | 10 | 22 | 
| B | J1 | 200 | 77 | 

Combinez et organisez efficacement les données de séries chronologiques grâce à cette transformation pour obtenir des informations complètes.

## Étiquettes pour les champs
<a name="v10-panels-xform-funcs-labelstofields"></a>

Utilisez cette transformation pour convertir les résultats de séries chronologiques contenant des étiquettes ou des balises dans un tableau, en incluant les clés et les valeurs de chaque étiquette dans le résultat. Affichez les étiquettes sous forme de colonnes ou de valeurs de ligne pour une meilleure visualisation des données.

Étant donné le résultat d'une requête de deux séries chronologiques :
+ Série 1 — étiquettes`Server=Server A`, `Datacenter=EU`
+ Série 2 — étiquettes`Server=Server B`, `Datacenter=EU`

En mode **Colonnes**, le résultat est le suivant :


| Heure | Serveur | Centre de données | Value | 
| --- | --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | Serveur A | UE | 1 | 
| 07/07/2020 11 H 34 MIN 20 S | Serveur B | UE | 2 | 

En mode « Lignes », le résultat comporte un tableau pour chaque série et affiche chaque valeur d'étiquette comme suit :


| étiquette | value | 
| --- | --- | 
| Serveur | Serveur A | 
| Centre de données | UE | 


| étiquette | value | 
| --- | --- | 
| Serveur | Serveur B | 
| Centre de données | UE | 

**Nom du champ de valeur**

Si vous avez sélectionné Serveur comme **nom du champ Valeur**, vous obtiendrez un champ pour chaque valeur de l'étiquette Serveur.


| Heure | Centre de données | Serveur A | Serveur B | 
| --- | --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | UE | 1 | 2 | 

**Comportement de fusion**

Le transformateur des étiquettes en champs est constitué en interne de deux transformations distinctes. Le premier agit sur des séries individuelles et extrait les étiquettes des champs. La seconde est la transformation de fusion qui réunit tous les résultats dans une seule table. La transformation de fusion essaie de joindre tous les champs correspondants. Cette étape de fusion est obligatoire et ne peut pas être désactivée.

Pour illustrer cela, voici un exemple dans lequel deux requêtes renvoient des séries chronologiques sans que les libellés ne se chevauchent.
+ Série 1 — étiquettes `Server=ServerA`
+ Série 2 — étiquettes `Datacenter=EU`

Cela donnera d'abord ces deux tableaux :


| Heure | Serveur | Value | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | Serveur A | 10 | 


| Heure | Centre de données | Value | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | UE | 20 | 

Après la fusion :


| Heure | Serveur | Value | Centre de données | 
| --- | --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | Serveur A | 10 |  | 
| 07/07/2020 11 H 34 MIN 20 S |  | 20 | UE | 

## Limite
<a name="v10-panels-xform-funcs-limit"></a>

Utilisez cette transformation pour limiter le nombre de lignes affichées, offrant ainsi une vue plus précise de vos données. Cela est particulièrement utile lorsqu'il s'agit de grands ensembles de données.

Voici un exemple illustrant l'impact de la transformation **Limit** sur une réponse provenant d'une source de données :


| Heure | Métrique | Value | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | Température | 25 | 
| 07/07/2020 11 H 34 MIN 20 S | Humidité | 22 | 
| 07/07/2020 10 H 32 MIN 20 S | Humidité | 29 | 
| 07/07/2020 10 H 31 H 22 | Température | 22 | 
| 07/07/2020 9 H 30 : 57 | Humidité | 33 | 
| 07/07/2020 9 H 30 : 05 | Température | 19 | 

Voici le résultat après avoir ajouté une transformation Limit avec une valeur de « 3 » :


| Heure | Métrique | Value | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | Température | 25 | 
| 07/07/2020 11 H 34 MIN 20 S | Humidité | 22 | 
| 07/07/2020 10 H 32 MIN 20 S | Humidité | 29 | 

Cette transformation vous permet d'adapter la présentation visuelle de vos données afin de vous concentrer sur les données les plus pertinentes.

## Fusionner les séries et les tableaux
<a name="v10-panels-xform-funcs-merge"></a>

Utilisez cette transformation pour combiner le résultat de plusieurs requêtes en un seul résultat, ce qui est particulièrement utile lorsque vous utilisez la visualisation du panneau de tableau. La transformation fusionne les valeurs dans la même ligne si les champs partagés contiennent les mêmes données.

Voici un exemple illustrant l'impact de la transformation des **séries et des tables Merge** sur deux requêtes renvoyant des données de table :

*Requête A :*


| Heure | Tâche | Temps de disponibilité | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | nœud | 25260122 | 
| 07/07/2020 11 H 24 H 20 | postgre | 123001233 | 

Requête B :


| Heure | Tâche | Erreurs | 
| --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | nœud | 15 | 
| 07/07/2020 11 H 24 H 20 | postgre | 5 | 

Voici le résultat après avoir appliqué la transformation Merge :


| Heure | Tâche | Erreurs | Temps de disponibilité | 
| --- | --- | --- | --- | 
| 07/07/2020 11 H 34 MIN 20 S | nœud | 15 | 25260122 | 
| 07/07/2020 11 H 24 H 20 | postgre | 5 | 123001233 | 

Cette transformation combine les valeurs de la requête A et de la requête B dans une table unifiée, améliorant ainsi la présentation pour de meilleures informations.

## Organiser les champs par nom
<a name="v10-panels-xform-funcs-organize"></a>

Utilisez cette transformation pour renommer, réorganiser ou masquer les champs renvoyés par une seule requête dans votre panneau. Cette transformation ne fonctionne que dans les panneaux contenant une seule requête. Si votre panneau contient plusieurs requêtes, vous devez soit appliquer une transformation de *jointure externe*, soit supprimer les requêtes supplémentaires.

**Des champs de transformation**

Grafana affiche une liste des champs renvoyés par la requête. Vous pouvez effectuer les actions suivantes :
+ **Modifier l'ordre des champs** : faites glisser un champ vers un nouvel emplacement dans la liste.
+ **Masquer ou afficher un champ** : utilisez l'icône en forme d'œil à côté du nom du champ pour activer ou désactiver la visibilité d'un champ.
+ **Renommer les champs** : saisissez un nouveau nom dans la zone **Renommer**.

**Exemple**

Compte tenu du résultat initial de la requête :


| Heure | Métrique | Value | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Température | 25 | 
| 2020-07-07 11:34:20 | Humidité | 22 | 
| 2020-07-07 10:32:20 | Humidité | 29 | 

Vous pouvez appliquer une modification du nom du champ pour créer :


| Heure | Sensor | Lecture | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Température | 25 | 
| 2020-07-07 11:34:20 | Humidité | 22 | 
| 2020-07-07 10:32:20 | Humidité | 29 | 

Cette transformation vous permet de personnaliser l'affichage des résultats des requêtes, garantissant ainsi une représentation claire et pertinente de vos données dans Grafana.

## Partition par valeurs
<a name="v10-panels-xform-funcs-partition"></a>

Utilisez cette transformation pour rationaliser le processus de représentation graphique de plusieurs séries sans avoir besoin de plusieurs requêtes avec des `WHERE` clauses différentes.

**Note**  
Cette fonction est disponible dans les espaces de travail compatibles avec Grafana version 9 et supérieure.

Cela est particulièrement utile lorsque vous utilisez une table SQL de métriques, comme dans cet exemple :


| Heure | Région | Value | 
| --- | --- | --- | 
| 20/10/2022 12 H 00 | ETATS-UNIS | 1520 | 
| 20/10/2022 12 H 00 | UE | 2936 | 
| 20/10/2022 1 H 00 | ETATS-UNIS | 1327 | 
| 20/10/2022 1 H 00 | UE | 912 | 

Avec le transformateur *Partition par valeurs*, vous pouvez émettre une seule requête et diviser les résultats par valeurs uniques dans une ou plusieurs colonnes (champs) de votre choix. L’exemple suivant utilise `Region`.

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| Heure | Région | Value | 
| --- | --- | --- | 
| 20/10/2022 12 H 00 | ETATS-UNIS | 1520 | 
| 20/10/2022 1 H 00 | ETATS-UNIS | 1327 | 


| Heure | Région | Value | 
| --- | --- | --- | 
| 20/10/2022 12 H 00 | UE | 2936 | 
| 20/10/2022 1 H 00 | UE | 912 | 

Cette transformation simplifie le processus et améliore la flexibilité de visualisation de plusieurs séries au sein d'une même visualisation de séries chronologiques.

## Préparer des séries chronologiques
<a name="v10-panels-xform-funcs-preparetimeseries"></a>

Utilisez cette transformation pour résoudre les problèmes lorsqu'une source de données renvoie des séries chronologiques dans un format incompatible avec la visualisation souhaitée. Cette transformation vous permet de convertir des données de séries chronologiques entre des formats larges et longs.

**Séries chronologiques multicadres**

Utilisez cette option pour transformer le bloc de données de séries chronologiques du format large au format long. Cela est particulièrement utile lorsque votre source de données fournit des informations de séries chronologiques dans un format qui doit être remodelé pour une compatibilité optimale avec votre visualisation.

*Exemple*

Cette entrée :


| Horodatage | Value1 | Value2 | 
| --- | --- | --- | 
| 01/01/2023 00:00:00 | 10 | 20 | 
| 01/01/2023 01:00:00 | 15 | 25 | 

Peut être transformé en :


| Horodatage | Variable | Value | 
| --- | --- | --- | 
| 01/01/2023 00:00:00 | Value1 | 10 | 
| 01/01/2023 00:00:00 | Value2 | 20 | 
| 01/01/2023 01:00:00 | Value1 | 15 | 
| 01/01/2023 01:00:00 | Value2 | 25 | 

**Séries chronologiques étendues**

Utilisez cette option pour transformer le bloc de données de séries chronologiques du format long au format large. Cela est particulièrement utile lorsque votre source de données fournit des séries chronologiques dans un format long et que votre visualisation nécessite un format large.

*Exemple*

Cette entrée :


| Horodatage | Variable | Value | 
| --- | --- | --- | 
| 01/01/2023 00:00:00 | Value1 | 10 | 
| 01/01/2023 00:00:00 | Value2 | 20 | 
| 01/01/2023 01:00:00 | Value1 | 15 | 
| 01/01/2023 01:00:00 | Value2 | 25 | 

Peut être transformé en :


| Horodatage | Value1 | Value2 | 
| --- | --- | --- | 
| 01/01/2023 00:00:00 | 10 | 20 | 
| 01/01/2023 01:00:00 | 15 | 25 | 

## Réduire
<a name="v10-panels-xform-funcs-reduce"></a>

Utilisez cette transformation pour appliquer un calcul à chaque champ du bloc de données et renvoyer une valeur unique. Cette transformation est particulièrement utile pour consolider plusieurs séries chronologiques dans un format résumé plus compact. Les champs temporels sont supprimés lors de l'application de cette transformation.

Tenez compte de l'entrée :

Requête A :


| Heure | Temp | Temps de disponibilité | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 12.3 | 256122 | 
| 2020-07-07 11:24:20 | 15,4 | 1230233 | 

Requête B :


| Heure | IQA | Erreurs | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | 6,5 | 15 | 
| 2020-07-07 11:24:20 | 3.2 | 5 | 

Le transformateur de réduction possède deux modes :
+ **Série en lignes** : crée une ligne pour chaque champ et une colonne pour chaque calcul.
+ **Réduire les champs** : conserve la structure de cadre existante, mais réduit chaque champ en une seule valeur.

Par exemple, si vous avez utilisé le **premier** et le **dernier** calcul avec une transformation **de séries en lignes**, le résultat serait le suivant :


| Champ | La première | La dernière | 
| --- | --- | --- | 
| Temp | 12.3 | 15,4 | 
| Temps de disponibilité | 256122 | 1230233 | 
| IQA | 6,5 | 3.2 | 
| Erreurs | 15 | 5 | 

L'**option Réduire les champs** avec le **dernier** calcul donne lieu à deux cadres, chacun comportant une ligne :

Requête A :


| Temp | Temps de disponibilité | 
| --- | --- | 
| 15,4 | 1230233 | 

Requête B :


| IQA | Erreurs | 
| --- | --- | 
| 3.2 | 5 | 

## Renommer par regex
<a name="v10-panels-xform-funcs-rename"></a>

Utilisez cette transformation pour renommer certaines parties des résultats de la requête à l'aide d'une expression régulière et d'un modèle de remplacement.

Vous pouvez spécifier une expression régulière, qui ne s'applique qu'aux correspondances, ainsi qu'un modèle de remplacement prenant en charge les références arrières. Imaginons par exemple que vous visualisez l'utilisation du processeur par hôte et que vous souhaitiez supprimer le nom de domaine. Vous pouvez définir l'expression régulière sur `([^\.]+)\..+` et le modèle de remplacement sur`$1`, `web-01.example.com` `web-01` deviendrait.

Cette transformation vous permet d'adapter vos données pour répondre à vos besoins de visualisation, rendant ainsi vos tableaux de bord plus informatifs et plus conviviaux.

## Lignes vers champs
<a name="v10-panels-xform-funcs-row"></a>

Utilisez cette transformation pour convertir les lignes en champs distincts. Cela peut être utile car les champs peuvent être stylisés et configurés individuellement. Il peut également utiliser des champs supplémentaires comme sources pour la configuration dynamique des champs ou les mapper aux étiquettes des champs. Les étiquettes supplémentaires peuvent ensuite être utilisées pour définir de meilleurs noms d'affichage pour les champs résultants.

Cette transformation inclut une table de champs répertoriant tous les champs des données renvoyées par la requête de configuration. Ce tableau vous permet de contrôler le champ qui doit être mappé à chaque propriété de configuration (option **Utiliser comme**). Vous pouvez également choisir la valeur à sélectionner si les données renvoyées comportent plusieurs lignes.

Cette transformation nécessite :
+ Un champ à utiliser comme source des noms de champs.

  Par défaut, la transformation utilise le premier champ de chaîne comme source. Vous pouvez remplacer ce paramètre par défaut en sélectionnant **Nom du champ** dans la colonne **Utiliser comme** champ pour le champ que vous souhaitez utiliser à la place.
+ Un champ à utiliser comme source de valeurs.

  Par défaut, la transformation utilise le premier champ numérique comme source. Vous pouvez toutefois annuler ce paramètre par défaut en sélectionnant **Valeur du champ** dans la colonne **Utiliser comme** champ pour le champ que vous souhaitez utiliser à la place.

Utile lors de la visualisation de données dans :
+ Jauge
+ Stat
+ Graphique à secteurs 

**Associez des champs supplémentaires à des étiquettes**

Si un champ ne correspond pas à la propriété de configuration, Grafana l'utilisera automatiquement comme source pour une étiquette sur le champ de sortie.

Exemple :


| Nom | DataCenter | Value | 
| --- | --- | --- | 
| Serveur A | ETATS-UNIS | 100 | 
| Serveur B | UE | 200 | 

Sortie :


| ServerA (étiquettes DataCenter : États-Unis) | ServerB (étiquettes DataCenter : EU) | 
| --- | --- | 
| 100 | 200 | 

Les libellés supplémentaires peuvent désormais être utilisés dans le nom d'affichage des champs pour fournir des noms de champs plus complets.

Si vous souhaitez extraire la configuration d'une requête et l'appliquer à une autre, vous devez utiliser la *configuration issue de la transformation des résultats de la requête*.

**Exemple**

Entrée :


| Nom | Value | Max | 
| --- | --- | --- | 
| Serveur A | 10 | 100 | 
| Serveur B | 20 | 200 | 
| Serveur C | 30 | 300 | 

Sortie :


| Serveur A (configuration : max = 100) | Serveur B (configuration : max = 200) | ServerC (configuration : max = 300) | 
| --- | --- | --- | 
| 10 | 20 | 30 | 

Comme vous pouvez le constater, chaque ligne des données source devient un champ distinct. Chaque champ possède désormais également une option de configuration maximale définie. Les options telles que **Min**, **Max**, **Unit** et **Threshold** font toutes partie de la configuration des champs et, si elles sont définies de cette manière, elles seront utilisées par la visualisation au lieu des options configurées manuellement dans le volet d'options de l'éditeur de panneaux.

Cette transformation permet de convertir des lignes en champs individuels, facilite la configuration dynamique des champs et associe des champs supplémentaires à des étiquettes.

## De la série aux rangées
<a name="v10-panels-xform-funcs-series"></a>

Utilisez cette transformation pour combiner le résultat de plusieurs requêtes de données de séries chronologiques en un seul résultat. Cela est utile lorsque vous utilisez la visualisation du panneau de tableau.

Le résultat de cette transformation contiendra trois colonnes : heure, métrique et valeur. La colonne Métrique est ajoutée afin que vous puissiez facilement voir de quelle requête provient la métrique. Personnalisez cette valeur en définissant Label dans la requête source.

Dans l'exemple ci-dessous, deux requêtes renvoient des données de séries chronologiques. Il est visualisé sous forme de deux tableaux distincts avant d'appliquer la transformation.

*Requête A :*


| Heure | Température | 
| --- | --- | 
| 2020-07-07 11:34:20 | 25 | 
| 2020-07-07 10:31:22 | 22 | 
| 2020-07-07 09:30:05 | 19 | 

*Requête B :*


| Heure | Humidité | 
| --- | --- | 
| 2020-07-07 11:34:20 | 24 | 
| 2020-07-07 10:32:20 | 29 | 
| 2020-07-07 09:30:57 | 33 | 

Voici le résultat après avoir appliqué la transformation Série aux lignes.


| Heure | Métrique | Value | 
| --- | --- | --- | 
| 2020-07-07 11:34:20 | Température | 25 | 
| 2020-07-07 11:34:20 | Humidité | 22 | 
| 2020-07-07 10:32:20 | Humidité | 29 | 
| 2020-07-07 10:31:22 | Température | 22 | 
| 2020-07-07 09:30:57 | Humidité | 33 | 
| 2020-07-07 09:30:05 | Température | 19 | 

Cette transformation facilite la consolidation des résultats de plusieurs requêtes de séries chronologiques, fournissant un ensemble de données rationalisé et unifié pour une analyse et une visualisation efficaces sous forme de tableau.

## Trier par
<a name="v10-panels-xform-funcs-sort"></a>

Utilisez cette transformation pour trier chaque cadre d'un résultat de requête en fonction d'un champ spécifique, afin de faciliter la compréhension et l'analyse de vos données. En configurant le champ souhaité pour le tri, vous pouvez contrôler l'ordre dans lequel les données sont présentées dans le tableau ou dans la visualisation.

Utilisez le commutateur **inverse** pour ordonner inversement les valeurs dans le champ spécifié. Cette fonctionnalité est particulièrement utile lorsque vous souhaitez passer rapidement de l'ordre croissant à l'ordre décroissant pour répondre à vos besoins analytiques.

Par exemple, dans un scénario où les données de séries chronologiques sont extraites d'une source de données, la transformation **Trier par** peut être appliquée pour organiser les blocs de données en fonction de l'horodatage, par ordre croissant ou décroissant, en fonction des exigences analytiques. Cette fonctionnalité vous permet de naviguer et d'interpréter facilement les données de séries chronologiques, en obtenant des informations précieuses grâce à une présentation organisée et visuellement cohérente.

## Spatial
<a name="v10-panels-xform-funcs-spatial"></a>

Utilisez cette transformation pour appliquer des opérations spatiales aux résultats des requêtes.
+ **Action** — Sélectionnez une action :
  + **Préparer le champ spatial** : définissez un champ de géométrie en fonction des résultats d'autres champs.
    + **Mode de localisation** — Sélectionnez un mode de localisation (ces options sont partagées par les modes **Calculer la valeur** et **Transformer**) :
      + **Auto** : identifie automatiquement les données de localisation en fonction des noms de champs par défaut.
      + **Coordonnées — Spécifiez les** champs de latitude et de longitude.
      + **Geohash** — Spécifiez un champ Geohash.
      + **Recherche** — Spécifiez les champs de localisation du répertoire géographique.
  + **Calculer la valeur** — Utilisez la géométrie pour définir un nouveau champ (heading/distance/area).
    + **Fonction** — Choisissez une opération mathématique à appliquer à la géométrie :
      + **Titre** — Calculez le cap (direction) entre deux points.
      + **Surface** : calculez la zone délimitée par un polygone défini par la géométrie.
      + **Distance** — Calculez la distance entre deux points.
  + **Transformer** — Appliquez des opérations spatiales à la géométrie.
    + **Opération** — Choisissez une opération à appliquer à la géométrie :
      + **En tant que ligne** : créez une entité linéaire unique avec un sommet sur chaque ligne.
      + **Générateur de lignes** : créez une ligne entre deux points.

Cette transformation vous permet de manipuler et d'analyser des données géospatiales, en permettant des opérations telles que la création de lignes entre des points, le calcul de propriétés spatiales, etc.

## Transformation d'une série chronologique en table
<a name="v10-panels-xform-funcs-seriestotable"></a>

Utilisez cette transformation pour convertir les résultats de séries chronologiques en table, transformant ainsi un bloc de données de séries chronologiques en champ de **tendance**. Le champ **Trend** peut ensuite être rendu à l'aide du [type de cellule sparkline](v10-panels-table.md#v10-panels-table-cell-type), générant une ligne sparkline intégrée pour chaque ligne du tableau. S'il existe plusieurs requêtes de séries chronologiques, chacune aboutira à un bloc de données de table distinct. Ils peuvent être joints à l'aide de transformations de jointure ou de fusion pour produire un seul tableau avec plusieurs sparklines par ligne.

Pour chaque valeur de champ de **tendance** générée, une fonction de calcul peut être sélectionnée. La valeur par défaut est **Dernière valeur non nulle**. Cette valeur est affichée à côté du sparkline et est utilisée pour trier les lignes du tableau.

## Analyse de régression
<a name="v10-panels-xform-funcs-regression"></a>

Utilisez cette transformation pour créer un nouveau bloc de données contenant des valeurs prédites par un modèle statistique. Cela est utile pour trouver une tendance dans des données chaotiques. Il fonctionne en ajustant une fonction mathématique aux données, en utilisant une régression linéaire ou polynomiale. Le bloc de données peut ensuite être utilisé dans une visualisation pour afficher une courbe de tendance.

Il existe deux modèles différents :
+  **Régression linéaire** — Ajuste une fonction linéaire aux données.
+  **Régression polynomiale** : adapte une fonction polynomiale aux données.

**Note**  
Cette transformation est actuellement en avant-première publique. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.

# Résoudre les problèmes liés aux requêtes
<a name="v10-panels-query-troubleshoot"></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)

Cette page fournit des informations permettant de résoudre les problèmes courants liés aux tableaux de bord.

**J'obtiens des résultats différents lorsque je réorganise mes fonctions**

L'ordre des fonctions est très important. Tout comme en mathématiques, l'ordre dans lequel vous placez vos fonctions peut affecter le résultat.

**Vérifiez votre requête, votre demande et votre réponse**

Les problèmes les plus courants sont liés à la requête et à la réponse provenant de votre source de données. Même s'il s'agit d'un bogue ou d'un problème de visualisation dans Grafana, il s'agit presque toujours d'un problème lié à la requête de source de données ou à la réponse de la source de données. Commencez par inspecter la requête et la réponse de votre panel.

Pour plus d'informations, reportez-vous à la section [Inspecter les données de demande et de réponse](v10-panels-panel-inspector.md).

**Ma requête est lente**

Combien de points de données votre requête renvoie-t-elle ? Une requête qui renvoie un grand nombre de points de données sera lente. Essayez ceci :
+ Dans les **options de requête**, limitez le nombre **maximum de points de données** renvoyés.
+ Dans les **options de requête**, augmentez le temps **d'intervalle minimal**.
+ Dans votre requête, utilisez une `group by` fonction.

# Types de calculs
<a name="v10-panels-calculation-types"></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)

Le tableau suivant contient une liste des calculs que vous pouvez effectuer dans Grafana. Vous pouvez trouver ces calculs dans l'onglet **Transformation** et dans les visualisations des jauges à barres, des jauges et des statistiques.


| Calculs | Description | 
| --- | --- | 
| Toutes les valeurs nulles | Vrai lorsque toutes les valeurs sont nulles | 
| Toutes les valeurs | Tableau avec toutes les valeurs | 
| Toutes les valeurs uniques | Tableau avec toutes les valeurs uniques | 
| Tous les zéros | Vrai lorsque toutes les valeurs sont égales à 0 | 
| Nombre de modifications | Nombre de fois que la valeur du champ change | 
| Nombre | Nombre de valeurs dans un champ | 
| Delta | Changement de valeur cumulé, ne compte que les incréments | 
| Différence | Différence entre la première et la dernière valeur d'un champ | 
| Pourcentage de différence | Variation en pourcentage entre la première et la dernière valeur d'un champ | 
| Nombre distinct | Nombre de valeurs uniques dans un champ | 
| La première | Première valeur d'un champ | 
| Premier\$1 (non nul) | Tout d'abord, aucune valeur nulle dans un champ (exclut également NaNs) | 
| La dernière | Dernière valeur d'un champ | 
| Last\$1 (non nul) | Enfin, valeur non nulle dans un champ (exclut également NaNs) | 
| Max | Valeur maximale d'un champ | 
| Mean | Valeur moyenne de toutes les valeurs d'un champ | 
| Variance | Variance de toutes les valeurs d'un champ | 
| StdDev | Écart type de toutes les valeurs d'un champ | 
| Min | Valeur minimale d'un champ | 
| Minimum (supérieur à zéro) | Valeur positive minimale d'un champ | 
| Range | Différence entre les valeurs maximales et minimales d'un champ | 
| Step (Étape) | Intervalle minimal entre les valeurs d'un champ | 
| Total | Somme de toutes les valeurs d'un champ | 

# Configurer les options du panneau
<a name="v10-panels-configure-panel-options"></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 panneau Grafana est une représentation visuelle des données que vous pouvez personnaliser en définissant une requête de source de données, en transformant et en formatant les données et en configurant les paramètres de visualisation.

Un éditeur de panneaux inclut un générateur de requêtes et une série d'options que vous pouvez utiliser pour transformer des données et ajouter des informations à vos panneaux.

Cette rubrique explique comment :
+ Ouvrez un panneau pour le modifier
+ Ajouter un titre et une description au panneau
+ Afficher un modèle JSON de panneau
+ Configuration de lignes et de panneaux répétitifs

## Modification d'un panneau
<a name="v10-panels-edit-a-panel"></a>

Après avoir ajouté un panneau à un tableau de bord, vous pouvez l'ouvrir à tout moment pour modifier ou mettre à jour des requêtes, ajouter une transformation de données et modifier les paramètres de visualisation.

**Pour modifier un panneau**

1. Ouvrez le tableau de bord qui contient le panneau que vous souhaitez modifier.

1. Passez le pointeur de la souris sur n'importe quelle partie du panneau pour afficher le menu d'actions dans le coin supérieur droit.

1. Choisissez le menu, puis sélectionnez **Modifier**.

   Pour ouvrir le panneau à l'aide d'un raccourci clavier, survolez le panneau avec le pointeur de la souris et appuyez sur`e`.

   Le panneau s'ouvre en mode édition.

## Ajouter un titre et une description à un panneau
<a name="v10-panels-add-title-description"></a>

Ajoutez un titre et une description à un panneau pour partager avec les utilisateurs toute information importante concernant la visualisation. Par exemple, utilisez la description pour documenter l'objectif de la visualisation.

1. Modifiez un panneau.

1. Dans le volet des options d'affichage du panneau, recherchez la section des **options du panneau**.

1. Entrez un **titre**.

   Le texte saisi dans ce champ apparaît dans une infobulle dans l'éditeur de panneaux et dans le tableau de bord.

1. Rédigez une description du panneau et des données que vous affichez.

   Le texte saisi dans ce champ apparaît dans une infobulle dans le coin supérieur gauche du panneau.

   Vous pouvez utiliser [les variables que vous avez définies](v10-dash-variables.md) dans les champs **Titre** et **Description**, mais pas [les variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).

## Affichage d'un modèle JSON de panneau
<a name="v10-panels-json-model"></a>

Explorez et exportez des modèles JSON de panneau, de données de panneau et de trame de données.

**Pour afficher un modèle JSON de panneau**

1. Ouvrez le tableau de bord qui contient le panneau.

1. Passez le pointeur de la souris sur n'importe quelle partie du panneau pour afficher le menu d'actions dans le coin supérieur droit.

1. Dans le menu, sélectionnez **Inspecter > Panel JSON**.

1. Dans le champ **Sélectionner la source**, choisissez l'une des options suivantes :
   + **Panneau JSON** — Affiche un objet JSON représentant le panneau.
   + **Données du panneau** : affiche un objet JSON représentant les données transmises au panneau.
   + **DataFrame structure** : affiche la structure de données du panneau, y compris les transformations, les configurations de champs et les configurations de remplacement qui ont été appliquées.

1. Pour explorer le JSON, choisissez **>** pour développer ou réduire des parties du modèle JSON.

## Configuration de panneaux récurrents
<a name="v10-panels-configure-repeating-panels"></a>

Vous pouvez configurer Grafana pour ajouter dynamiquement des panneaux ou des lignes à un tableau de bord. Un panneau dynamique est un panneau créé par le système en fonction de la valeur d'une variable. Les variables modifient dynamiquement vos requêtes dans tous les panneaux d'un tableau de bord. Pour plus d'informations sur les panneaux répétitifs, consultez[Création de tableaux de bord](v10-dash-creating.md).

**Note**  
Les panneaux qui se répètent nécessitent des variables pour sélectionner un ou plusieurs éléments ; vous ne pouvez pas répéter un panneau zéro fois pour le masquer.

*Prérequis*
+ Assurez-vous que la requête inclut une variable à valeurs multiples.

**Pour configurer des panneaux récurrents**

1. Modifiez le panneau que vous souhaitez répéter.

1. Dans le volet des options d'affichage, choisissez **Options du panneau > Options de répétition**.

1. Sélectionnez une **direction**.
   + Choisissez l'**horizontale** pour disposer les panneaux side-by-side. Grafana ajuste la largeur d'un panneau répété. Vous ne pouvez pas mélanger d'autres panneaux d'une ligne avec un panneau répété.
   + Choisissez la **verticale** pour disposer les panneaux dans une colonne. La largeur des panneaux répétés est la même que celle du panneau répété d'origine.

1. Pour appliquer les modifications à tous les panneaux, rechargez le tableau de bord.

# Configuration des options standard
<a name="v10-panels-configure-standard-options"></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 modèle de données utilisé dans Grafana est une structure de table orientée en colonnes qui unifie à la fois les résultats des séries chronologiques et des requêtes de table. Chaque colonne de cette structure est appelée *champ*. Un champ peut représenter une seule série chronologique ou une colonne de table.

Les options de champ vous permettent de modifier le mode d'affichage des données dans vos visualisations. Les options et les dérogations que vous appliquez ne modifient pas les données, elles modifient la façon dont Grafana affiche les données. Lorsque vous modifiez une option, elle est appliquée à tous les champs, c'est-à-dire à toutes les séries ou colonnes. Par exemple, si vous remplacez l'unité par un pourcentage, tous les champs contenant des valeurs numériques sont affichés en pourcentages.

Une liste complète des options de formatage des champs est incluse plus loin dans cette rubrique.

**Note**  
Vous pouvez appliquer des options standard à la plupart des panneaux Grafana intégrés. Certains anciens panels et panels communautaires qui n'ont pas été mis à jour avec le nouveau panneau et le nouveau modèle de données manqueront de toutes ces options de champ ou de certaines d'entre elles.

**Pour configurer les options standard**

1. Ouvrez un tableau de bord. Passez le curseur sur n'importe quelle partie du panneau pour afficher le menu d'actions dans le coin supérieur droit du tableau de bord.

1. Dans le menu Actions, choisissez **Modifier**.

1. Dans le volet des options d'affichage du panneau, recherchez la section **Options standard**.

1. Sélectionnez les options standard que vous souhaitez appliquer.

1. Pour prévisualiser votre modification, sélectionnez en dehors de la zone d'option du champ que vous modifiez ou appuyez sur **Entrée**.

**Définitions des options standard**

Cette section explique toutes les options standard disponibles.

Vous pouvez appliquer des options standard à la plupart des panneaux Grafana intégrés. Certains anciens panels et panels communautaires qui n'ont pas été mis à jour avec le nouveau panneau et le nouveau modèle de données manqueront de toutes ces options de champ ou de certaines d'entre elles.

La plupart des options de champ n'affectent pas la visualisation tant que vous n'avez pas cliqué en dehors de la zone d'options de champ que vous êtes en train de modifier ou que vous n'avez pas appuyé sur **Entrée**.

**Note**  
Grafana Labs s'efforce constamment d'ajouter et de développer des options pour toutes les visualisations, de sorte que toutes les options peuvent ne pas être disponibles pour toutes les visualisations.

## Unit
<a name="v10-panels-standard-options-unit"></a>

Permet de choisir l'unité qu'un champ doit utiliser. Choisissez le champ **Unité**, puis naviguez vers le bas jusqu'à ce que vous trouviez l'unité souhaitée. L'unité que vous sélectionnez est appliquée à tous les champs sauf le temps.

### Unités personnalisées
<a name="v10-panels-standard-options-custom-units"></a>

Vous pouvez également utiliser la liste déroulante des unités pour spécifier des unités personnalisées, un préfixe ou un suffixe personnalisé et des formats de date et d'heure.

Pour sélectionner une unité personnalisée, entrez l'unité et sélectionnez la dernière option **Personnalisée : xxx** dans le menu déroulant.
+ **suffixe :** <suffix>pour une unité personnalisée qui doit suivre la valeur.
+ **préfixe :** <prefix>pour une unité personnalisée qui doit précéder la valeur.
+ **heure :** <format>pour les formats de date et d'heure personnalisés, tapez par exemple`time:YYYY-MM-DD`. Voir [format](https://momentjs.com/docs/#/displaying/) dans la *documentation Moment.js* pour la syntaxe et les options de format.
+ **si :** <base scale><unit characters>pour les unités SI personnalisées. Par exemple : `si: mF`. C'est un peu plus avancé car vous pouvez spécifier à la fois une unité et l'échelle des données source. Donc, si vos données sources sont représentées sous forme de milli (milliers de), préfixez l'unité avec ce caractère d'échelle SI.
+ **nombre :** <unit>pour une unité de comptage personnalisée.
+ **devise :** <unit>pour personnaliser une unité monétaire.

Vous pouvez également coller un emoji natif dans le sélecteur d'unités et le choisir comme unité personnalisée.

### Unités de chaînes
<a name="v10-panels-standard-options-string-units"></a>

Grafana peut parfois être trop agressif lorsqu'il s'agit d'analyser des chaînes et de les afficher sous forme de nombres. **Pour configurer Grafana afin qu'il affiche la valeur de chaîne d'origine, créez un remplacement de champ et ajoutez une propriété d'unité avec l'unité String.**

### Unités d'échelle
<a name="v10-panels-standard-options-scale-units"></a>

Par défaut, Grafana redimensionne automatiquement l'unité en fonction de l'amplitude de la valeur. Par exemple, si vous avez une valeur de 0,14 kW, Grafana l'affichera sous la forme 140 W. Un autre exemple est que 3 000 kW seront affichés sous la forme de trois MW. Si vous souhaitez désactiver ce comportement, vous pouvez désactiver le commutateur **Unités d'échelle**.

## Min
<a name="v10-panels-standard-options-min"></a>

Permet de définir la valeur minimale utilisée dans le calcul du seuil de pourcentage. Laissez ce champ vide pour calculer automatiquement le minimum.

## Max
<a name="v10-panels-standard-options-max"></a>

Permet de définir la valeur maximale utilisée dans le calcul du seuil de pourcentage. Laissez ce champ vide pour calculer automatiquement le maximum.

## Champ min/max
<a name="v10-panels-standard-options-fieldminmax"></a>

Par défaut, le minimum et le maximum calculés seront basés sur le minimum et le maximum, dans toutes les séries et tous les champs. L'activation min/max du champ permet de calculer le minimum ou le maximum de chaque champ individuellement, en fonction du minimum ou du maximum de ce champ.

## Décimales
<a name="v10-panels-standard-options-decimals"></a>

Spécifiez le nombre de décimales que Grafana inclut dans la valeur rendue. Si vous laissez ce champ vide, Grafana tronque automatiquement le nombre de décimales en fonction de la valeur. Par exemple, 1.1234 s'affichera sous la forme 1,12 et 100,456 sous la forme 100.

**Pour afficher toutes les décimales, définissez l'unité sur Chaîne.**

## Nom d’affichage
<a name="v10-panels-standard-options-displayname"></a>

Permet de définir le titre d'affichage de tous les champs. Vous pouvez utiliser [des variables](v10-dash-variables.md) dans le titre du champ.

Lorsque plusieurs statistiques, champs ou séries sont affichés, ce champ contrôle le titre de chaque statistique. Vous pouvez utiliser des expressions telles que **\$1 \$1\$1\$1field.name\$1** pour n'utiliser que le nom de la série ou le nom du champ dans le titre.

Étant donné un champ portant le nom et `Temp` les libellés `{"Loc"="PBI", "Sensor"="3"}` suivants :


| Syntaxe des expressions | Exemple | Effectue des rendus vers | Explication | 
| --- | --- | --- | --- | 
| \$1\$1\$1\$1field.displayName\$1 | Identique à la syntaxe | Temp \$1Loc="PBI", Sensor="3"\$1 | Affiche le nom du champ et les libellés \$1\$1 s'ils sont présents. S'il n'y a qu'une seule clé d'étiquette dans la réponse, Grafana affiche la valeur de l'étiquette sans les accolades. | 
| \$1\$1\$1\$1field.name\$1 | Identique à la syntaxe | Temp | Affiche le nom du champ (sans étiquette). | 
| \$1\$1\$1\$1field.labels\$1 | Identique à la syntaxe | Loc="PBI", Sensor="3" | Affiche les étiquettes sans leur nom. | 
| \$1\$1\$1\$1field.labels.X\$1 | \$1\$1\$1\$1field.labels.Loc\$1 | PBI | Affiche la valeur de la clé d'étiquette spécifiée. | 
| \$1\$1\$1\$1field.labels.\$1\$1values\$1 | Identique à la syntaxe | PBI, 3 | Affiche les valeurs des étiquettes séparées par une virgule (sans les clés d'étiquette). | 

Si la valeur est une chaîne vide après le rendu de l'expression pour un champ particulier, la méthode d'affichage par défaut est utilisée.

## Schéma de couleurs
<a name="v10-panels-standard-options-color-scheme"></a>

Les options de couleur et leur effet sur la visualisation dépendent de la visualisation sur laquelle vous travaillez. Certaines visualisations proposent différentes options de couleur.

Vous pouvez spécifier une seule couleur ou sélectionner un jeu de couleurs continu (dégradé) en fonction d'une valeur. La couleur continue interpole une couleur en utilisant le pourcentage d'une valeur par rapport aux valeurs min et max.

Sélectionnez l'une des palettes suivantes :


| Mode couleur | Description | 
| --- | --- | 
| Couleur unique | Spécifiez une seule couleur, utile dans une règle de remplacement | 
| Nuances d'une couleur | Sélectionne les nuances d'une seule couleur, ce qui est utile dans le cadre d'une règle de dérogation | 
| À partir des seuils | Demande à Grafana de prendre la couleur correspondant au seuil correspondant | 
| Palette classique | Grafana attribuera une couleur en recherchant une couleur dans une palette par index de série. Utile pour les graphiques, les diagrammes à secteurs et autres visualisations de données catégorielles | 
| Palette classique (par nom de série) | Grafana attribuera la couleur en fonction du nom de la série. Utile lorsque les noms de séries à visualiser dépendent des données disponibles. | 
| Green-Yellow-Red (par valeur) | Schéma de couleurs continu | 
| Red-Yellow-Green (par valeur) | Schéma de couleurs continu | 
| Blue-Yellow-Red (par valeur) | Schéma de couleurs continu | 
| Jaune-rouge (par valeur) | Schéma de couleurs continu | 
| Bleu-violet (par valeur) | Schéma de couleurs continu | 
| Jaune-bleu (par valeur) | Schéma de couleurs continu | 
| Blues (par valeur) | Schéma de couleurs continu (fond du panneau en bleu) | 
| Rouges (par valeur) | Schéma de couleurs continu (couleur d'arrière-plan du panneau passant au rouge) | 
| Verts (par valeur) | Schéma de couleurs continu (couleur d'arrière-plan du panneau virant au vert) | 
| Violet (par valeur) | Schéma de couleurs continu (couleur d'arrière-plan du panneau virant au violet) | 

## Aucune valeur
<a name="v10-panels-standard-options-no-value"></a>

Entrez ce que Grafana doit afficher si la valeur du champ est vide ou nulle. La valeur par défaut est un tiret (-).

# Configuration d'une légende
<a name="v10-panels-configure-legend"></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 inclut une légende que vous pouvez utiliser pour interpréter les données affichées dans une visualisation. Chaque option de légende ajoute du contexte et de la clarté aux données illustrées dans une visualisation.

Les légendes sont prises en charge pour les visualisations suivantes :
+ [Graphique à barres](v10-panels-bar-chart.md)
+ [Chandelier](v10-panels-candlestick.md)
+ [Histogramme](v10-panels-histogram.md)
+ [Diagramme circulaire](v10-panels-piechart.md)
+ [Chronologie de l'État](v10-panels-state-timeline.md)
+ [Historique des statuts](v10-panels-status-history.md)
+ [Séries chronologiques](v10-panels-time-series.md)
+ [Tendance](v10-panels-trend.md)

[Les géomaps](v10-panels-geomap.md) et les [heatmaps](v10-panels-heatmap.md) comportent également des légendes, mais elles offrent uniquement le choix d'afficher ou non une légende, et ne prennent pas en charge les autres options de légende.

## Options de légende
<a name="v10-panels-legend-options"></a>

Vous trouverez les options suivantes dans la section **Légende** du volet d'édition du panneau.

**Note**  
Les options répertoriées ne s'appliquent pas toutes à toutes les visualisations comportant des légendes.

**Visibilité**

Définissez si la légende est affichée ou non. Utilisez le commutateur pour activer ou désactiver une légende.

**Mode**

Définissez le format d'affichage de la légende. Choisissez parmi :
+ **List**
+ **Tableau **

Lorsque vous formatez une légende sous forme de tableau, d'autres informations relatives à la légende, telles que les valeurs associées ou son emplacement dans la visualisation, peuvent également être affichées.

**Placement**

Définissez l'endroit où la légende est affichée sur la visualisation. Choisissez parmi :
+ **Bottom (Bas)**
+ **Right (Droite)**

**Width (Largeur)**

Si vous définissez le placement de la légende sur **Droite**, l'option **Largeur** devient disponible. Laissez le champ vide pour permettre à Grafana de définir automatiquement la largeur de la légende, ou entrez une valeur dans le champ.

**Valeurs**

Vous pouvez ajouter du contexte à une visualisation en ajoutant des valeurs de données de série ou [des calculs](v10-panels-calculation-types.md) à une légende. Vous pouvez ajouter autant de valeurs que vous le souhaitez. Après avoir appliqué vos modifications, vous pouvez faire défiler la légende pour voir toutes les valeurs.

## Modification de la couleur d'une série
<a name="v10-panels-legend-change-color"></a>

Par défaut, Grafana définit la couleur des données de votre série, mais vous pouvez les modifier via la légende du panneau.

**Pour modifier la couleur d'une série**

1. Accédez au panneau que vous souhaitez mettre à jour.

1. Dans la légende, sélectionnez la barre de couleur associée à la série.

1. Sélectionnez une couleur prédéfinie dans l'onglet **Couleurs** ou définissez une couleur personnalisée dans l'onglet **Personnalisé**, à l'aide du sélecteur ou des valeurs RGB.

1. Enregistrez le tableau de bord.

## Isolation des données de série dans une visualisation
<a name="v10-panels-legend-isolate"></a>

Les visualisations peuvent souvent être visuellement complexes et inclure de nombreuses séries de données. Vous pouvez simplifier la vue en supprimant les données de série de la visualisation par le biais de la légende, qui isole les données que vous souhaitez consulter. **Lorsque vous faites cela, Grafana crée automatiquement une nouvelle dérogation dans l'onglet Override.**

**Pour isoler les données de série dans une visualisation**

1. Accédez au panneau que vous souhaitez mettre à jour.

1. Dans la légende, sélectionnez l'étiquette de la série que vous souhaitez isoler.

   Le système supprime de la vue toutes les autres données de série.

1. Pour ajouter progressivement des données de série à une série isolée, appuyez sur la touche **Ctrl** ou **Commande** et sélectionnez l'étiquette de la série que vous souhaitez ajouter.

1. Pour enregistrer vos modifications afin qu'elles apparaissent à tous les utilisateurs du panneau, enregistrez le tableau de bord.

Pour revenir à la vue par défaut qui inclut toutes les données, cliquez deux fois sur l'étiquette d'une série.

## Série de tri
<a name="v10-panels-legend-sort"></a>

Lorsque vous formatez une légende sous forme de tableau et que vous y ajoutez des valeurs, vous pouvez trier les séries du tableau en fonction de ces valeurs.

**Pour trier les séries**

1. Accédez au panneau que vous souhaitez mettre à jour.

1. Passez le curseur sur n'importe quelle partie du panneau sur laquelle vous souhaitez travailler pour afficher le menu dans le coin supérieur droit du panneau.

1. Dans le menu, choisissez **Modifier**.

1. Accédez à la section **Légende** du volet d'édition du panneau.

1. Sous **Valeurs**, sélectionnez la valeur ou le calcul que vous souhaitez afficher.

   La légende affiche désormais des valeurs.

1. Choisissez l'en-tête du nom du calcul dans le tableau des légendes pour trier les valeurs du tableau par ordre croissant ou décroissant.

**Note**  
Cette fonctionnalité n'est prise en charge que dans les panneaux suivants : graphique à barres, histogramme, séries chronologiques.

# Configuration des liaisons de données
<a name="v10-panels-configure-data-links"></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 liens de données vous permettent de fournir un contexte plus détaillé à vos liens. Vous pouvez créer des liens qui incluent le nom de la série ou même la valeur située sous le curseur. Par exemple, si votre visualisation montre quatre serveurs, vous pouvez ajouter une liaison de données vers un ou deux d'entre eux. Vous pouvez également lier des panneaux à l'aide de liens de données.

Le lien lui-même est accessible de différentes manières en fonction de la visualisation. Pour la visualisation des séries chronologiques, par exemple, vous choisissez un point de données ou une ligne. Pour les visualisations de grande surface, telles que les statistiques, les jauges ou les jauges à barres, vous pouvez choisir n'importe où dans la visualisation pour ouvrir le menu contextuel.

S'il n'y a qu'un seul lien de données dans la visualisation, le fait de choisir n'importe où dans la visualisation ouvre le lien plutôt que le menu contextuel.

**Visualisations prises en charge**
+ Diagramme à barres
+ Jauge à barres
+ Candlestick (Chandelier)
+ Canvas
+ Jauge
+ Géomap
+ Heatmap
+ Histogramme
+ Graphique à secteurs 
+ Stat
+ Chronologie de l'État
+ Historique des statuts
+ Table
+ Séries chronologiques
+ Tendance

## Variables de liaison de données
<a name="v10-panels-data-link-variables"></a>

Les variables contenues dans les liens de données vous permettent d'envoyer les utilisateurs vers un tableau de bord détaillé avec des filtres de données préservés. Par exemple, vous pouvez utiliser une variable pour spécifier une étiquette, une plage de temps, une série ou une sélection de variables.

Pour voir la liste des variables disponibles, saisissez `$` le champ **URL** du lien de données.

Vous pouvez également utiliser des variables de modèle dans vos liens de données URLs, voir[Variables](v10-dash-variables.md).

### Variables du panneau de plage de temps
<a name="v10-panels-time-range-panel-variables"></a>

Ces variables vous permettent d'inclure la plage horaire actuelle dans l'URL du lien de données.
+ `__url_time_range`— plage horaire du tableau de bord actuel (c'est-à-dire`?from=now-6h&to=now`)
+ `$__from` : pour plus d'informations, veuillez consulter [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).
+ `$__to` : pour plus d'informations, veuillez consulter [Variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global).

### Variables de série
<a name="v10-panels-series-variables"></a>

Les variables spécifiques aux séries sont disponibles dans l'espace `__series` de noms :
+ `__series.name`— nom de la série vers l'URL

### Variables de champ
<a name="v10-panels-field-variables"></a>

Les variables spécifiques aux champs sont disponibles dans l'espace de noms : `__field`
+ `__field.name`— le nom du champ
+ `__field.labels.<LABEL>`— la valeur de l'étiquette par rapport à l'URL. Si votre étiquette contient des points, utilisez `__field.labels["<LABEL>"]` la syntaxe.

### Variables de valeur
<a name="v10-panels-value-variables"></a>

Les variables spécifiques aux valeurs sont disponibles dans l'espace de `__value` noms :
+ `__value.time`— l'horodatage de la valeur (Unix ms epoch) par rapport à l'URL (c'est-à-dire) `?time=1560268814105`
+ `__value.raw`— valeur brute
+ `__value.numeric`— représentation numérique d'une valeur
+ `__value.text`— représentation textuelle d'une valeur
+ `__value.calc`— nom du calcul si la valeur est le résultat du calcul

L'utilisation d'une variable spécifique à une valeur dans les liaisons de données peut donner des résultats différents en fonction de l'option définie du mode Tooltip.

### Variables de données
<a name="v10-panels-data-variables"></a>

Pour accéder aux valeurs d'autres champs, utilisez :
+ `__data.fields[i]`— Valeur du champ `i` (sur la même ligne).
+ `__data.fields["NameOfField"]`— Valeur du champ utilisant le nom au lieu de l'index.
+ `__data.fields[i].labels.cluster`— Accédez aux libellés d'un autre champ.

### Variables du modèle
<a name="v10-panels-template-variables"></a>

Lorsque vous créez un lien vers un autre tableau de bord qui utilise des variables de modèle, sélectionnez des valeurs variables pour la personne qui clique sur le lien.

`${var-myvar:queryparam}`— où `var-myvar` est le nom de la variable de modèle qui correspond à celle du tableau de bord actuel que vous souhaitez utiliser.


| État variable | Résultat : URL créée | 
| --- | --- | 
| valeur sélectionnée | var-myvar=value1 | 
| valeurs multiples sélectionnées | var-myvar=value1&var-myvar=value2 | 
| sélectionné All | var-myvar=All | 

Si vous souhaitez ajouter toutes les variables du tableau de bord actuel à l'URL, utilisez`${__all_variables}`.

## Ajouter un lien de données
<a name="v10-panels-add-a-datalink"></a>

Vous pouvez ajouter des liens de données à vos panneaux.

1. Accédez au panneau auquel vous souhaitez ajouter le lien de données.

1. Passez le curseur sur le panneau pour afficher l'icône du menu dans le coin supérieur droit.

1. Dans le menu, choisissez **Modifier** pour ouvrir l'éditeur de panneaux.

1. Dans le volet **d'édition du panneau**, faites défiler la page jusqu'à la section **Liens de données** et développez-la.

1. Choisissez **Ajouter un lien**.

1. Dans la boîte de dialogue qui s'ouvre, entrez un **titre**. Il s'agit d'une étiquette lisible par l'homme pour le lien, qui sera affichée dans l'interface utilisateur.

1. Entrez l'**URL** ou la variable vers laquelle vous souhaitez créer un lien.

   Pour ajouter une variable de liaison de données, sélectionnez le champ **URL**, puis entrez `$` ou appuyez sur Ctrl\$1Espace ou Cmd\$1Espace pour afficher la liste des variables disponibles.

1. Si vous souhaitez que le lien s'ouvre dans un nouvel onglet, sélectionnez **Ouvrir dans un nouvel onglet**.

1. Choisissez **Enregistrer** pour enregistrer les modifications et fermer la boîte de dialogue.

1. Enregistrez les modifications apportées au tableau de bord.

# Configurer les mappages de valeurs
<a name="v10-panels-configure-value-mappings"></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)

Outre les remplacements de champs, le mappage de valeurs est une technique que vous pouvez utiliser pour modifier la façon dont les données apparaissent dans une visualisation.

Les mappages de valeurs contournent le formatage des unités défini dans les [options standard](v10-panels-configure-standard-options.md) de l'éditeur de panneaux, comme la couleur ou le nombre de décimales affichées. Lorsque des mappages de valeurs sont présents dans un panneau, Grafana en affiche un résumé dans la section Mappages de **valeurs de l'**éditeur de panneaux.

**Visualisations prises en charge**
+ Diagramme à barres
+ Jauge à barres
+ Candlestick (Chandelier)
+ Canvas
+ Jauge
+ Géomap
+ Histogramme
+ Graphique à secteurs 
+ Stat
+ Chronologie de l'État
+ Historique des statuts
+ Table
+ Séries chronologiques
+ Tendance

## Types de mappages de valeurs
<a name="v10-panels-value-mappings-types"></a>

Grafana prend en charge les types de mappage de valeurs suivants :
+ **Valeur** : associe des valeurs spécifiques à un texte et à une couleur. Par exemple, vous pouvez configurer un mappage de valeurs afin que toutes les instances de la valeur `10` apparaissent sous la forme `Perfection!` plutôt que sous la forme d'un nombre. Utilisez un mappage de **valeurs** lorsque vous souhaitez formater une valeur unique.
+ **Plage** : associe les plages numériques au texte et à une couleur. Par exemple, si une valeur se situe dans une certaine plage, vous pouvez configurer un mappage de valeurs de plage pour afficher `Low` ou `High` plutôt que le nombre. Utilisez le mappage de **plage** lorsque vous souhaitez formater plusieurs valeurs continues.
+ **Regex** — Associe les expressions régulières au texte et à une couleur. Par exemple, si une valeur est`www.example.com`, vous pouvez configurer un mappage de valeurs regex afin que Grafana `www` affiche et tronque le domaine. Utilisez le mappage **Regex** lorsque vous souhaitez mettre en forme le texte et la couleur d'une valeur d'expression régulière.
+ **Spécial** — Associe des valeurs spéciales telles que`Null`, `NaN` (pas un nombre), et des valeurs booléennes telles que `true` et `false` à un texte et à une couleur. Par exemple, vous pouvez configurer un mappage de valeurs spécial afin que `null` les valeurs apparaissent sous forme de`N/A`. Utilisez le **mappage spécial** lorsque vous souhaitez formater une valeur inhabituelle, booléenne ou vide.

## Ajouter un mappage de valeurs
<a name="v10-panels-value-mappings-add"></a>

Vous pouvez ajouter des mappages de valeur à vos panneaux.

**Pour ajouter un mappage de valeur**

1. Accédez au panneau que vous souhaitez mettre à jour.

1. Passez le curseur sur n'importe quelle partie du panneau pour afficher un menu dans le coin supérieur droit du panneau.

1. Dans le menu, choisissez **Modifier**.

1. Dans la section **Mappages de valeurs**, choisissez **Ajouter des mappages de valeurs**.

1. Choisissez **Ajouter un nouveau mappage**, puis sélectionnez l'une des options suivantes :
   + **Valeur** — Entrez une seule valeur à faire correspondre.
   + **Plage** — Entrez les valeurs de début et de fin d'une plage à faire correspondre.
   + **Regex** — Entrez un modèle d'expression régulière correspondant.
   + **Spécial** — Choisissez une valeur spéciale à faire correspondre.

1. (Facultatif) Entrez le texte d'affichage.

1. (Facultatif) Définissez la couleur.

1. Choisissez **Mettre à jour** pour enregistrer le mappage des valeurs.

Après avoir ajouté un mappage, le bouton **Modifier les mappages de valeurs** remplace le bouton **Ajouter des mappages de valeur**. Cliquez sur le bouton Modifier pour ajouter ou mettre à jour des mappages.

# Configuration des seuils
<a name="v10-panels-configure-thresholds"></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)

Dans les tableaux de bord, un seuil est une valeur ou une limite que vous définissez pour une métrique qui est reflétée visuellement lorsqu'elle est atteinte ou dépassée. Les seuils vous permettent de personnaliser et de colorer vos visualisations de manière conditionnelle en fonction des résultats des requêtes.

Vous pouvez utiliser des seuils pour :
+ Lignes de quadrillage de couleur ou zones de quadrillage dans une visualisation de séries chronologiques.
+ Colorez l'arrière-plan ou le texte de valeur dans une visualisation de statistiques.
+ Définissez les régions et les couleurs des régions dans la chronologie d'un État.
+ Lignes de couleur dans une visualisation de séries chronologiques.
+ Colorez les marqueurs de jauge et de seuil d'une jauge.
+ Marqueurs de couleur sur une carte géographique.
+ Coloriez le texte ou l'arrière-plan d'une cellule dans un tableau.

**Visualisations prises en charge**
+ Diagramme à barres
+ Jauge à barres
+ Candlestick (Chandelier)
+ Canvas
+ Jauge
+ Géomap
+ Histogramme
+ Stat
+ Chronologie de l'État
+ Historique des statuts
+ Table
+ Séries chronologiques
+ Tendance

## Seuils par défaut
<a name="v10-panels-thresholds-default"></a>

Sur les visualisations qui prennent en charge les seuils, Grafana possède les paramètres de seuil par défaut suivants :
+ 80 = rouge
+ Base = vert
+ Mode = Absolu
+ Afficher les seuils = Désactivé (pour certaines visualisations)

  Pour de plus amples informations, veuillez consulter [Afficher les seuils](#v10-panels-thresholds-show).

## Options de seuils
<a name="v10-panels-thresholds-options"></a>

Vous pouvez définir les options suivantes pour mieux définir l'apparence des seuils.

### Valeur des seuils
<a name="v10-panels-thresholds-value"></a>

Ce nombre est la valeur qui déclenche le seuil. Vous pouvez également définir la couleur associée au seuil dans ce champ.

La valeur **de base** représente moins l'infini. Par défaut, il est réglé sur la couleur verte, qui est généralement la « bonne » couleur.

### Mode seuils
<a name="v10-panels-thresholds-mode"></a>

Il existe deux modes de seuil :
+ Les seuils **absolus** sont définis par un nombre. Par exemple, 80 sur une échelle de 1 à 150.
+ Les seuils de **pourcentage** sont définis par rapport au minimum ou au maximum. Par exemple, 80 %.

### Afficher les seuils
<a name="v10-panels-thresholds-show"></a>

**Note**  
Cette option n'est prise en charge que pour les graphiques à barres, les chandeliers, les séries chronologiques et les visualisations de tendances.

Définissez si et comment les seuils sont affichés sur la visualisation à l'aide des options suivantes.
+ **Désactivé** — Les seuils ne sont pas affichés.
+ **Sous forme de lignes** : les seuils sont représentés sous forme de lignes horizontales sur la visualisation.
+ **Sous forme de lignes (en pointillés)** : les seuils sont représentés sous forme de lignes horizontales en pointillés.
+ **Sous forme de régions remplies** : les seuils sont affichés sous forme de régions horizontales.
+ **Sous forme de régions et de lignes remplies** : les seuils sont représentés sous forme de régions horizontales séparées par des lignes.
+ **Sous forme de régions et de lignes remplies (en pointillés)** : les seuils sont représentés sous forme de régions horizontales séparées par des lignes pointillées.

## Ajouter un seuil
<a name="v10-panels-thresholds-add"></a>

Vous pouvez ajouter autant de seuils que vous le souhaitez à une visualisation. Grafana trie automatiquement les valeurs des seuils du plus élevé au plus bas.

**Pour ajouter un seuil**

1. Accédez au panneau que vous souhaitez mettre à jour.

1. Passez le pointeur de la souris sur n'importe quelle partie du panneau pour afficher le menu dans le coin supérieur droit.

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

1. Accédez à la section **Seuils** ou entrez `Thresholds` dans la barre de recherche en haut du volet d'édition du panneau.

1. Choisissez **\$1 Ajouter un seuil**.

1. Entrez une nouvelle valeur de seuil ou utilisez les flèches vers le haut et vers le bas situées sur le côté droit du champ pour augmenter ou diminuer la valeur progressivement.

1. Cliquez sur le cercle coloré situé à gauche de la valeur de seuil pour ouvrir le sélecteur de couleur, dans lequel vous pouvez mettre à jour la couleur de seuil.

1. En **mode Seuils**, sélectionnez **Absolu** ou **Pourcentage**.

1. Sous **Afficher les seuils**, définissez le mode d'affichage du seuil ou désactivez-le.

Pour supprimer un seuil, accédez au panneau qui contient le seuil et cliquez sur l'icône de corbeille à côté du seuil que vous souhaitez supprimer.

# Configurer les remplacements de champs
<a name="v10-panels-configure-overrides"></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)

Les remplacements vous permettent de personnaliser les paramètres de visualisation pour des champs ou des séries spécifiques. Pour ce faire, il faut ajouter une règle de dérogation qui cible un ensemble particulier de champs et qui peut chacun définir plusieurs options.

Par exemple, vous définissez l'unité pour tous les champs qui incluent le texte en `bytes` ajoutant une dérogation à l'aide du matcher **Fields with name matching regex**, puis en ajoutant l'option Unit à la règle de remplacement.

## Exemple 1 : température du format
<a name="v10-panels-overrides-format-temperature"></a>

Supposons que notre ensemble de résultats soit un bloc de données composé de deux champs : `time` et`temperature`.


| time | temperature | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45.0 | 
| 2020-01-02 03:05:00 | 47,0 | 
| 2020-01-02 03:06:00 | 48,0 | 

Chaque champ (colonne) de cette structure peut être associé à des options de champ qui modifient la façon dont ses valeurs sont affichées. Cela signifie que vous pouvez, par exemple, régler l'unité sur Température > Celsius, ce qui donne le tableau suivant :


| time | temperature | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45,0 °C | 
| 2020-01-02 03:05:00 | 47,0 °C | 
| 2020-01-02 03:06:00 | 48,0 °C | 

De plus, la décimale n'est pas obligatoire, nous pouvons donc la supprimer. Vous pouvez changer les décimales d'**auto** à zéro (**0**), ce qui donne le tableau suivant :


| time | temperature | 
| --- | --- | 
| 2020-01-02 03:04:00 | 45 °C | 
| 2020-01-02 03:05:00 | 47 °C | 
| 2020-01-02 03:06:00 | 48 °C | 

## Exemple 2 : Formater la température et l'humidité
<a name="v10-panels-overrides-format-humidity"></a>

Supposons que notre jeu de résultats soit un bloc de données composé de quatre champs : `time``high temp`,`low temp`, et`humidity`.


| time | haute température | basse température | humidité | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45.0 | 30.0 | 67 | 
| 2020-01-02 03:05:00 | 47,0 | 34,0 | 68 | 
| 2020-01-02 03:06:00 | 48,0 | 31,0 | 68 | 

Ajoutons l'unité Celsius et éliminons la décimale. Cela donne le tableau suivant :


| time | haute température | basse température | humidité | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45 °C | 30 °C | 67 °C | 
| 2020-01-02 03:05:00 | 47 °C | 34 °C | 68 °C | 
| 2020-01-02 03:06:00 | 48 °C | 31 °C | 68 °C | 

Les champs de température semblent bons, mais l'humidité doit maintenant être modifiée. Nous pouvons résoudre ce problème en appliquant une dérogation aux options de champ au champ d'humidité et en modifiant l'unité sur Divers > pourcentage (0-100).


| time | haute température | basse température | humidité | 
| --- | --- | --- | --- | 
| 2020-01-02 03:04:00 | 45 °C | 30 °C | 67 % | 
| 2020-01-02 03:05:00 | 47 °C | 34 °C | 68 % | 
| 2020-01-02 03:06:00 | 48 °C | 31 °C | 68 % | 

## Ajouter une dérogation à un champ
<a name="v10-panels-overrides-add-a-field"></a>

Une règle de remplacement de champ permet de personnaliser les paramètres de visualisation pour un champ ou une série spécifique.

**Pour ajouter un remplacement de champ**

1. Modifiez le panneau auquel vous souhaitez ajouter une dérogation.

1. Dans le volet latéral des options du panneau, choisissez **Ajouter un remplacement de champ en** bas du volet.

1. Sélectionnez les champs auxquels une règle de dérogation sera appliquée :
   + **Champs avec nom** — Sélectionnez un champ dans la liste de tous les champs disponibles. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur ne sont appliquées qu'à ce seul champ.
   + **Champs dont le nom correspond à une expression régulière** : spécifiez les champs à remplacer par une expression régulière. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur sont appliquées à tous les champs dont le nom correspond à l'expression régulière. Cela sélectionne les champs à remplacer, mais ne les renomme pas ; pour ce faire, utilisez la transformation [Rename by](v10-panels-xform-functions.md) regex.
   + **Champs avec type** : sélectionnez les champs par type, par exemple chaîne, numérique, etc. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur sont appliquées à tous les champs correspondant au type sélectionné.
   + **Champs renvoyés par requête** : sélectionnez tous les champs renvoyés par une requête spécifique, par exemple A, B ou C. Les propriétés que vous ajoutez à une règle à l'aide de ce sélecteur sont appliquées à tous les champs renvoyés par la requête sélectionnée.

1. Choisissez **Ajouter une propriété de remplacement.**

1. Sélectionnez l'option de champ que vous souhaitez appliquer.

1. Entrez les options en ajoutant des valeurs dans les champs. Pour rétablir les valeurs par défaut des options, supprimez le texte blanc dans les champs.

1. Continuez à ajouter des remplacements à ce champ en choisissant **Ajouter une propriété de remplacement**, ou vous pouvez choisir **Ajouter un remplacement et sélectionner un autre champ auquel ajouter des remplacements**.

1. Lorsque vous avez terminé, choisissez **Enregistrer** pour enregistrer toutes les modifications du panneau sur le tableau de bord.

## Supprimer une dérogation à un champ
<a name="v10-panels-overrides-delete-a-field"></a>

Supprimez une dérogation de champ lorsque vous n'en avez plus besoin. Lorsque vous supprimez une dérogation, l'apparence de la valeur reprend par défaut son format d'origine. Cette modification a un impact sur les tableaux de bord et les utilisateurs de tableaux de bord qui dépendent d'un panneau concerné.

**Pour supprimer un remplacement de champ**

1. Modifiez le panneau qui contient la dérogation que vous souhaitez supprimer.

1. Dans le volet latéral des options du panneau, faites défiler l'écran vers le bas jusqu'à ce que vous voyiez les dérogations.

1. Choisissez la dérogation que vous souhaitez supprimer, puis choisissez l'icône de corbeille associée.

## Afficher les remplacements de champs
<a name="v10-panels-overrides-view"></a>

Vous pouvez voir les remplacements de champs dans les options d'affichage du panneau.

1. Modifiez le panneau qui contient les remplacements que vous souhaitez afficher.

1. Dans le volet latéral des options du panneau, faites défiler l'écran vers le bas jusqu'à ce que vous voyiez les dérogations.

**Note**  
Les paramètres de remplacement qui apparaissent dans l'onglet **Tous** sont les mêmes que ceux qui apparaissent dans l'onglet **Remplacements**.

## Modification d'un remplacement de champ
<a name="v10-panels-overrides-edit-a-field"></a>

Modifiez une dérogation de champ lorsque vous souhaitez apporter des modifications à un paramètre de dérogation. La modification que vous apportez prend effet immédiatement.

**Pour modifier un remplacement de champ**

1. Modifiez le panneau qui contient les dérogations que vous souhaitez modifier.

1. Dans le volet latéral des options du panneau, faites défiler l'écran vers le bas jusqu'à ce que vous voyiez les dérogations.

1. Localisez la dérogation que vous souhaitez modifier.

1. Effectuez l'une des opérations suivantes :
   + Modifiez les paramètres des remplacements ou des paramètres de sélection de champs existants.
   + Supprimez les propriétés de remplacement existantes en choisissant le **X** à côté de la propriété.
   + Ajoutez une propriété de remplacement en choisissant **Ajouter une propriété de remplacement.**

# Visualisations disponibles dans la version 10 de Grafana
<a name="v10-panels-viz"></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 propose une variété de visualisations adaptées à différents cas d'utilisation. Cette section de la documentation met en évidence les visualisations intégrées, leurs options et leur utilisation typique.

Le panel est un panneau courant pour commencer et pour apprendre les bases de l'utilisation des [Séries chronologiques](v10-panels-time-series.md) panneaux.

**Note**  
Si vous ne savez pas quelle visualisation choisir, Grafana peut fournir des suggestions de visualisation en fonction de la requête du panneau. Lorsque vous sélectionnez une visualisation, Grafana affiche un aperçu avec cette visualisation appliquée.
+ Graphiques et diagrammes
  + Les [séries chronologiques](v10-panels-time-series.md) sont la visualisation graphique par défaut et principale.
  + [Chronologie de l'](v10-panels-state-timeline.md)État pour les changements d'État au fil du temps.
  + [Historique du statut pour l'](v10-panels-status-history.md)état périodique au fil du temps.
  + [Le graphique à barres](v10-panels-bar-chart.md) montre toutes les données catégorielles.
  + [L'histogramme](v10-panels-histogram.md) calcule et montre la distribution des valeurs dans un graphique à barres.
  + La [carte thermique](v10-panels-heatmap.md) permet de visualiser les données en deux dimensions, généralement utilisées pour mesurer l'ampleur d'un phénomène.
  + Le [diagramme circulaire](v10-panels-piechart.md) est généralement utilisé lorsque la proportionnalité est importante.
  + [Candlestick](v10-panels-candlestick.md) est généralement destiné aux données financières où l'accent est price/data mis sur le mouvement.
  + La [jauge](v10-panels-gauge.md) est le visuel arrondi traditionnel qui indique la distance entre une métrique et un seuil.
  + [Tendance](v10-panels-trend.md) pour les ensembles de données dont le x numérique séquentiel n'est pas le temps.
  + Le [graphique XY](v10-panels-xychart.md) permet de visualiser des valeurs x et y arbitraires dans un graphique.
+ Statistiques et chiffres
  + [Stat](v10-panels-stat.md) pour obtenir de grandes statistiques et Sparkline en option.
  + La [jauge à barres](v10-panels-bar-gauge.md) est une jauge à barre horizontale ou verticale.
+ Misc
  + [Le tableau](v10-panels-table.md) est la principale et unique visualisation du tableau.
  + [Les journaux](v10-panels-logs.md) constituent la principale visualisation des journaux.
  + [Graphe de nœuds](v10-panels-node-graph.md) pour les graphes orientés ou les réseaux.
  + [Traces](v10-panels-traces.md) est la principale visualisation des traces.
  + [Le graphe de flammes](v10-panels-flamegraph.md) est la principale visualisation pour le profilage.
  + [Geomap](v10-panels-geomap.md) vous aide à visualiser les données géospatiales.
  + [Datagrid](v10-panels-datagrid.md) vous permet de créer et de manipuler des données, et sert de source de données pour les autres panneaux.
+ Widgets
  + [La liste des tableaux de bord](v10-panels-dashboard-list.md) peut répertorier les tableaux de bord.
  + [La liste d'alertes](v10-panels-alert-list.md) peut répertorier les alertes.
  + [Le texte](v10-panels-text.md) peut afficher le Markdown et le HTML.
  + [Les actualités](v10-panels-news.md) peuvent afficher des flux RSS.

## Obtenez-en plus
<a name="v10-panels-getmore"></a>

Vous pouvez ajouter d'autres types de visualisation en installant des plug-ins de panneau à partir du[Trouvez des plugins avec le catalogue de plugins](grafana-plugins.md#plugin-catalog).

## Exemples
<a name="v10-panels-examples"></a>

Dans les sections suivantes, vous trouverez des exemples de visualisations.

## Graphiques
<a name="v10-panels-ex-graphs"></a>

Pour les graphiques linéaires, en aires et à barres basés sur le temps, nous recommandons la visualisation des [séries chronologiques](v10-panels-time-series.md) par défaut.

![\[Une image montrant des exemples de visualisations de séries chronologiques à Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/time_series_example.png)


Pour les données catégoriques, utilisez un [graphique à barres](v10-panels-bar-chart.md).

![\[Une image présentant des exemples de visualisations de diagrammes à barres dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/barchart_example.png)


## Chiffres et statistiques importants
<a name="v10-panels-ex-numbers"></a>

Une visualisation de [statistiques](v10-panels-stat.md) montre une valeur de statistique importante avec une ligne d'étincelle graphique optionnelle. Vous pouvez contrôler la couleur d'arrière-plan ou la valeur à l'aide de seuils ou d'échelles de couleurs.

![\[Image illustrant un exemple de visualisation de statistiques dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/stat_panel_example.png)


## Jauge
<a name="v10-panels-ex-gauge"></a>

Si vous souhaitez présenter une valeur relative à une valeur minimale et maximale, deux options s'offrent à vous. Tout d'abord une [jauge](v10-panels-gauge.md) radiale standard :

![\[Image montrant un exemple de visualisation d'une jauge dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/gauge_example.png)


Deuxièmement, Grafana dispose également d'une [jauge à barres](v10-panels-bar-gauge.md) horizontale ou verticale avec trois modes d'affichage distincts.

![\[Image montrant un exemple de visualisation d'une jauge dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Table
<a name="v10-panels-ex-table"></a>

Pour afficher les données sous forme de tableau, utilisez une visualisation sous forme de [tableau](v10-panels-table.md).

![\[Image illustrant un exemple de visualisation de table dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/table_example.png)


## Graphique à secteurs
<a name="v10-panels-ex-piechart"></a>

Pour afficher des séries réduites, ou des valeurs d'une série, issues d'une ou de plusieurs requêtes, dans la mesure où elles sont liées les unes aux autres, utilisez une visualisation sous forme de [graphique circulaire](v10-panels-piechart.md).

![\[Image illustrant un exemple de visualisation d'un graphique à secteurs dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/pie_chart_example.png)


## Cartes de chaleur
<a name="v10-panels-ex-heatmaps"></a>

Pour afficher la distribution des valeurs dans le temps, utilisez une visualisation par [carte thermique](v10-panels-heatmap.md).

![\[Image illustrant un exemple de visualisation d'une carte thermique dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Chronologie de l'État
<a name="v10-panels-ex-state"></a>

La [chronologie d'un état](v10-panels-state-timeline.md) montre les changements d'état discrets au fil du temps. Lorsqu'ils sont utilisés avec des séries chronologiques, les seuils sont utilisés pour transformer les valeurs numériques en régions à états discrets.

![\[Image montrant un exemple de visualisation de la chronologie d'un état dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/state_timeline_example.png)


# Liste d'alertes
<a name="v10-panels-alert-list"></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 des listes d'alertes pour afficher vos alertes. Vous pouvez configurer la liste pour afficher l'état actuel. Pour plus d'informations sur les alertes, consultez[Alertes dans la version 10 de Grafana](v10-alerts.md).

Utilisez ces paramètres pour affiner votre visualisation.

## Options
<a name="v10-panels-alert-list-options"></a>
+ **Mode groupe** : choisissez entre le **regroupement par défaut** pour afficher les instances d'alerte regroupées selon leur règle d'alerte et le **regroupement personnalisé pour regrouper** les instances d'alerte selon un ensemble personnalisé d'étiquettes.
+ **Nombre maximum d'éléments** : définissez le nombre maximum d'alertes à répertorier.
+ **Ordre de tri** : sélectionnez le mode d'ordre des alertes affichées.
  + **Alphabétique (asc)** — Ordre alphabétique
  + **Alphabétique (desc)** — Ordre alphabétique inversé
  +  **Importance** — Par importance selon les valeurs suivantes, 1 étant la plus élevée :
    + `alerting`ou `firing` : 1
    + `no_data` : 2
    + `pending`: 3
    + `ok`: 4
    + `paused`ou `inactive` : 5
  + **Heure (asc)** : les instances d'alerte actives les plus récentes sont les premières.
  + **Heure (desc)** : les instances d'alerte actives les plus anciennes sont les premières.
+  **Alertes provenant de ce tableau de bord** : affiche les alertes uniquement à partir du tableau de bord dans lequel se trouve la liste des alertes.

## Filtre
<a name="v10-panels-alert-filter"></a>

Ces options vous permettent de limiter les alertes affichées uniquement à celles qui correspondent à la requête, au dossier ou aux balises que vous choisissez :
+ **Nom de l'alerte** : entrez une requête portant le nom de l'alerte.
+ **Libellé de l'instance d'alerte** : filtrez les instances d'alerte à l'aide de requêtes par étiquette. Par exemple, `{severity="critical", instance=~"cluster-us-.+"}`.
+ **Dossier** : sélectionnez un dossier. Seules les alertes provenant des tableaux de bord du dossier sélectionné seront affichées.
+ **Source de données** : filtrez les alertes provenant de la source de données sélectionnée.

## Filtre d'état
<a name="v10-panels-alert-state-filter"></a>

Choisissez les états d'alerte à afficher dans ce panneau.
+ Alerte/Déclenchement
+ En attente
+ Aucune donnée
+ Normal
+ Erreur

# Liste d'annotations
<a name="v10-panels-annotations"></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)

La liste des annotations affiche la liste des annotations disponibles que vous pouvez utiliser pour afficher les données annotées. Différentes options sont disponibles pour filtrer la liste en fonction des balises et du tableau de bord actuel.

## Requête d'annotation
<a name="v10-panels-annotations-query"></a>

Les options suivantes contrôlent la requête source pour la liste des annotations.

**Filtre de requête**

Utilisez le filtre de requête pour créer une liste d'annotations à partir de tous les tableaux de bord de votre organisation ou du tableau de bord actuel dans lequel se trouve ce panneau. Il propose les options suivantes :
+ Tous les tableaux de bord - Répertoriez les annotations de tous les tableaux de bord de l'organisation actuelle.
+ Ce tableau de bord : limitez la liste aux annotations du tableau de bord actuel.

**Plage de temps**

Utilisez l'option de plage de temps pour spécifier si la liste doit être limitée à la plage de temps actuelle. Il propose les options suivantes :
+ Aucune : aucune limite de temps pour la requête d'annotations.
+ Ce tableau de bord : limitez la liste à la plage de temps du tableau de bord où le panneau de liste d'annotations est disponible.

**Balises**

Utilisez l'option tags pour filtrer les annotations par tags. Vous pouvez ajouter plusieurs balises afin d'affiner la liste.

**Note**  
Vous pouvez éventuellement laisser la liste de balises vide et filtrer à la volée en sélectionnant les balises répertoriées dans les résultats sur le panneau lui-même.

**Limite**

Utilisez l'option limit pour limiter le nombre de résultats renvoyés.

## Affichage
<a name="v10-panels-annotations-display"></a>

Ces options contrôlent les métadonnées supplémentaires incluses dans l'affichage du panneau d'annotations.

**Afficher l'utilisateur**

Utilisez cette option pour afficher ou masquer l'utilisateur qui a créé l'annotation.

**Afficher l'heure**

Utilisez cette option pour afficher ou masquer l'heure de création de l'annotation.

**Afficher les tags**

Utilisez cette option pour afficher ou masquer les balises associées à une annotation. *NB* : Vous pouvez utiliser les balises pour filtrer en direct la liste d'annotations sur la visualisation elle-même.

## Comportement des liens
<a name="v10-panels-annotations-links"></a>

**Cible du lien**

Utilisez cette option pour choisir le mode d'affichage des données annotées. Il comporte les options suivantes.
+ Panneau - Cette option vous amène directement à une vue en plein écran du panneau avec l'annotation correspondante
+ Tableau de bord : cette option permet de concentrer l'annotation dans le contexte d'un tableau de bord complet

**Temps antérieur**

Utilisez cette option pour définir la plage de temps avant l'annotation. Utilisez des valeurs de chaîne de durée telles que « 1h » = 1 heure, « 10m » = 10 minutes, etc.

**Temps après**

Utilisez cette option pour définir la plage de temps après l'annotation.

# Diagramme à barres
<a name="v10-panels-bar-chart"></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)

Les diagrammes à barres vous permettent de représenter graphiquement des données catégorielles.

![\[Une image présentant des exemples de visualisations de diagrammes à barres dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/barchart_example.png)


## Formats de données pris en charge
<a name="v10-panels-bar-chart-formats"></a>

Un seul bloc de données est pris en charge et il doit comporter au moins un champ de chaîne qui sera utilisé comme catégorie pour un axe X ou Y et un ou plusieurs champs numériques. Voici un exemple de formats de données :


| Navigateur | Part de marché | 
| --- | --- | 
| Chrome | 50 | 
| Internet Explorer | 17,5 | 

Si vous avez plusieurs champs numériques, le panneau affiche des barres groupées.

### Visualisation de séries chronologiques ou de plusieurs ensembles de résultats
<a name="v10-panels-bar-chart-visualization"></a>

Si vous avez plusieurs séries chronologiques ou tables, vous devez d'abord les joindre à l'aide d'une jointure ou d'une transformation réduite. Par exemple, si vous avez plusieurs séries chronologiques et que vous souhaitez comparer leur dernière valeur et leur valeur maximale, ajoutez la transformation **Reduce** et spécifiez **Max** et **Last** comme options sous **Calculs**.

## Options du graphique à barres
<a name="v10-panels-bar-chart-options"></a>

Utilisez ces options pour affiner votre visualisation.

**Orientation**
+ **Auto** — Grafana décide de l'orientation de la barre en fonction des dimensions du panneau.
+ **Horizontal** — Fait de l'axe X l'axe des catégories.
+ **Vertical** — Fait de l'axe Y l'axe des catégories.

**Faire pivoter les étiquettes à cocher sur l'axe X**

 Lorsque le graphique est orienté verticalement, ce paramètre fait pivoter les étiquettes situées sous les barres. Ce paramètre est utile lorsque les libellés des diagrammes à barres sont longs et se chevauchent.

**Longueur maximale de l'étiquette à cocher sur l'axe X**

Définit la longueur maximale des libellés des diagrammes à barres. Les étiquettes dont la longueur est supérieure à la longueur maximale sont tronquées par des ellipses.

**Espacement minimal des étiquettes à barres**

Définit l'espacement minimal entre les étiquettes des barres.

**Afficher les valeurs**

Contrôle si les valeurs sont affichées en haut ou à gauche des barres.
+ **Auto** — Les valeurs sont affichées s'il y a de l'espace.
+ **Toujours** : affiche toujours les valeurs.
+ **Jamais** : ne jamais afficher les valeurs.

**Empilage**

Contrôle l'empilement des diagrammes à barres.
+ **Désactivé** — Les barres ne seront pas empilées.
+ **Normal** — Les barres seront empilées les unes sur les autres.
+ **Pourcentage** — Les barres seront empilées les unes sur les autres, et la hauteur de chaque barre est le pourcentage de la hauteur totale de la pile.

**Largeur du groupe**

Contrôle la largeur des groupes.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Largeur de la barre**

Contrôle la largeur des barres.
+ `0 = Minimum width`
+ `1 = Maximum width`

**Rayon de la barre**

Contrôle le rayon des barres.
+ `0 = Minimum radius`
+ `0.5 = Maximum radius`

**Surlignez toute la zone en surlignant**

Contrôle si toute la zone environnante de la barre est surlignée lorsque vous survolez la barre avec le pointeur de la souris.

**Largeur de ligne**

Contrôle la largeur de ligne des barres.

**Opacité du remplissage**

Contrôle l'opacité de remplissage des barres.

**Mode dégradé**

Définit le mode de remplissage du dégradé. Le dégradé de remplissage est basé sur la couleur de la ligne. Pour modifier la couleur, utilisez l'option de champ du jeu de couleurs standard.

L'apparence du dégradé est influencée par le paramètre d'**opacité du remplissage**.
+ **Aucun** : aucun remplissage en dégradé. Il s’agit du paramètre par défaut.
+ **Opacité** — La transparence du dégradé est calculée en fonction des valeurs de l'axe Y. L'opacité du remplissage augmente avec les valeurs de l'axe Y.
+ **Teinte** — Le dégradé de couleur est généré en fonction de la teinte de la couleur de la ligne.

**Mode infobulle**

Lorsque vous passez le curseur sur la visualisation, Grafana peut afficher des infobulles. Choisissez le comportement des infobulles.
+ **Unique** : l'infobulle affiche une seule série, celle que vous survolez dans la visualisation.
+ **Tout** — L'infobulle affiche toutes les séries de la visualisation. Grafana met en évidence la série que vous survolez en gras dans la liste des séries de l'infobulle.
+ **Masqué** : n'affiche pas l'infobulle lorsque vous interagissez avec la visualisation.

**Note**  
Vous pouvez utiliser un override pour masquer des séries individuelles dans l'infobulle.

**Taille du texte**

Entrez une valeur pour modifier la taille du texte sur votre graphique à barres.

## Options de légende
<a name="v10-panels-bar-chart-legend"></a>

**Mode légende**

Utilisez ces paramètres pour définir le mode d'affichage de la légende dans votre visualisation. Pour de plus amples informations, veuillez consulter [Configuration d'une légende](v10-panels-configure-legend.md).
+ **Liste** — Affiche la légende sous forme de liste. Il s'agit du mode d'affichage par défaut de la légende.
+ **Tableau** : affiche la légende sous forme de tableau.
+ **Masqué** : masque la légende.

**Placement des légendes**

Choisissez où placer la légende.
+ **En bas** : en dessous du graphique.
+ **Droite** : à droite du graphique.

**Valeurs de légende**

Choisissez des valeurs de données de série ou des calculs standard à afficher dans la légende. Tu peux en avoir plusieurs. Pour de plus amples informations, veuillez consulter [Configuration d'une légende](v10-panels-configure-legend.md).

## Options d'axe
<a name="v10-panels-bar-chart-axis"></a>

Utilisez les paramètres de champ suivants pour affiner l'affichage de vos axes. Certaines options de champ n'affectent pas la visualisation tant que vous n'avez pas cliqué en dehors de la zone d'options de champ que vous êtes en train de modifier ou que vous n'avez pas appuyé sur Entrée.

**Placement**

Définit le placement de l'axe Y.
+ **Auto** — Grafana assigne automatiquement l'axe Y à la série. Lorsqu'il existe deux séries ou plus avec des unités différentes, Grafana affecte l'axe gauche à la première unité et l'axe droit aux unités suivantes.
+ **Gauche** — Affiche tous les axes Y sur le côté gauche.
+ **Droite** — Affiche tous les axes Y sur le côté droit.
+ **Masqué** : masque tous les axes Y.

Pour masquer les axes de manière sélective, [ajoutez des remplacements de champs](v10-panels-configure-overrides.md) qui ciblent des champs spécifiques.

**Étiquette**

Définissez une étiquette de texte sur l'axe Y. Si vous avez plusieurs axes Y, vous pouvez attribuer différentes étiquettes en les remplaçant.

**Width (Largeur)**

Définissez une largeur fixe de l'axe. Par défaut, Grafana calcule dynamiquement la largeur d'un axe.

En définissant la largeur de l'axe, les données avec différents types d'axes peuvent partager les mêmes proportions d'affichage. Cela facilite la comparaison des données de plusieurs graphes, car les axes ne sont ni décalés ni étirés à proximité visuelle les uns des autres.

**Soft min et soft max**

Définissez une option soft min ou soft max pour un meilleur contrôle des limites de l'axe Y. Par défaut, Grafana définit automatiquement la plage de l'axe Y en fonction du jeu de données.

Les paramètres minimum et maximum souples peuvent empêcher les pics de se transformer en montagnes lorsque les données sont généralement plates, et les paramètres minimum ou maximum définis à partir des options de champ minimales et maximales standard peuvent empêcher les pics intermittents d'aplatir les détails utiles en les découpant au-delà d'un point défini.

Vous pouvez définir des min/max options standard pour définir les limites strictes de l'axe Y. Pour de plus amples informations, veuillez consulter [Configuration des options standard](v10-panels-configure-standard-options.md).

**Afficher plusieurs axes Y**

Dans certains cas, vous souhaiterez peut-être afficher plusieurs axes Y. Par exemple, si vous disposez d'un jeu de données indiquant à la fois la température et l'humidité au fil du temps, vous souhaiterez peut-être afficher deux axes Y avec des unités différentes pour ces deux séries.

Vous pouvez le faire en [ajoutant des remplacements de champs](v10-panels-configure-overrides.md). Suivez les étapes autant de fois que nécessaire pour ajouter autant d'axes Y que nécessaire.

# Jauge à barres
<a name="v10-panels-bar-gauge"></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 jauges à barres simplifient vos données en réduisant chaque champ à une valeur unique. Vous choisissez comment Grafana calcule la réduction.

Ce panneau peut afficher un ou plusieurs indicateurs à barres en fonction du nombre de séries, de lignes ou de colonnes renvoyées par votre requête.

![\[Image montrant un exemple de visualisation d'une jauge à barres dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/bar_gauge_example.png)


## Options de valeur
<a name="v10-panels-bar-gauge-value"></a>

Utilisez les options suivantes pour affiner la façon dont votre visualisation affiche la valeur :

**Afficher**

Choisissez la manière dont Grafana affiche vos données.

**Calculer**

Afficher une valeur calculée en fonction de toutes les lignes.
+ **Calcul** — Sélectionnez une fonction de réduction que Grafana utilisera pour réduire de nombreux champs à une seule valeur. Pour obtenir la liste des calculs disponibles, reportez-vous à la section [Types de calculs](v10-panels-calculation-types.md).
+ **Champs** — Sélectionnez les champs affichés dans le panneau.

**Toutes les valeurs**

Afficher une statistique distincte pour chaque ligne. Si vous sélectionnez cette option, vous pouvez également limiter le nombre de lignes à afficher.
+ **Limite** : nombre maximal de lignes à afficher. La valeur par défaut est 5 000.
+ **Champs** — Sélectionnez les champs affichés dans le panneau.

## Options de jauge à barres
<a name="v10-panels-bar-gauge-options"></a>

Réglez le mode d'affichage de la jauge à barres.

**Orientation**

Choisissez une direction d'empilement.
+ **Auto** — Grafana sélectionne ce qu'il pense être la meilleure orientation.
+ **Horizontal** — Les barres s'étirent horizontalement, de gauche à droite.
+ **Vertical** — Les barres s'étirent verticalement de bas en haut.

**Mode d'affichage**

Choisissez un mode d'affichage.
+ **Dégradé** : les niveaux de seuil définissent un dégradé.
+ **LCD rétro** — La jauge est divisée en petites cellules allumées ou éteintes.
+ **Basique** : couleur unique basée sur le seuil correspondant.

**Affichage de la valeur**

Choisissez un mode d'affichage des valeurs.
+ **Couleur de la valeur** : la couleur de la valeur est déterminée par la valeur.
+ **Couleur du texte** : la couleur de la valeur est la couleur du texte par défaut.
+ **Masqué** : les valeurs sont masquées.

**Emplacement du nom**

Choisissez un mode de placement de nom.

**Note**  
Cette option ne s'applique que lorsque l'orientation du baromètre est horizontale. Lorsque la jauge à barres est orientée verticalement, les noms sont toujours placés au bas de chaque jauge à barres.
+ **Auto** — Grafana détermine le meilleur placement.
+ **Haut** — Les noms sont placés en haut de chaque jauge à barres.
+ **Gauche** — Les noms sont placés à gauche de chaque jauge à barres.

**Afficher la zone vide**

Sélectionnez cette option si vous souhaitez rendre la zone vide des barres en gris foncé. Non applicable au mode d'affichage LCD rétro.

**Taille de la barre**

Choisissez un mode de taille de barre.
+ **Auto** — Grafana détermine la meilleure taille de jauge à barres.
+ **Manuel** — Configurez manuellement la taille du manomètre.

**Largeur minimale**

Limitez la largeur minimale de la colonne de barres lorsque la jauge est orientée verticalement.

Afficher automatiquement la barre de défilement de l'axe X lorsqu'il y a une grande quantité de données.

**Note**  
Cette option s'applique uniquement lorsque la taille de la barre est réglée sur manuel.

**Hauteur minimale**

Limitez la hauteur minimale de la rangée de barres lorsque la jauge est orientée horizontalement.

Afficher automatiquement la barre de défilement de l'axe Y lorsqu'il y a une grande quantité de données.

**Note**  
Cette option s'applique uniquement lorsque la taille de la barre est réglée sur manuel.

**Hauteur maximale**

Limitez la hauteur maximale de la rangée de barres lorsque la jauge est orientée horizontalement.

Afficher automatiquement la barre de défilement de l'axe Y lorsqu'il y a une grande quantité de données.

**Note**  
Cette option s'applique uniquement lorsque la taille de la barre est réglée sur manuel.

# Candlestick (Chandelier)
<a name="v10-panels-candlestick"></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)

La visualisation Candlestick vous permet de visualiser des données qui incluent un certain nombre de dimensions cohérentes axées sur le mouvement des prix. Le panneau Candlestick inclut un mode Open-High-Low-Close (OHLC), ainsi que la prise en charge de dimensions supplémentaires basées sur des données de séries chronologiques.

![\[Image illustrant un exemple de visualisation d'un chandelier à Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/candlestick-panel-example.png)


Les visualisations Candlestick s'appuient sur les bases de [Séries chronologiques](v10-panels-time-series.md) et incluent de nombreux paramètres de configuration courants.

## Mode
<a name="v10-panels-candlestick-mode"></a>

Les options de mode vous permettent de choisir les dimensions utilisées pour la visualisation.
+ **Bougies** : limitez les dimensions du panneau aux dimensions ouverte, haute, basse et fermée utilisées par les visualisations en chandeliers.
+ **Volume** : limitez la dimension du panneau à la dimension du volume.
+ **Les deux** : comportement par défaut du panneau en chandeliers. Il inclut à la fois des visualisations en chandelier et en volume.

## Style de bougie
<a name="v10-panels-candlestick-style"></a>
+ **Bougies** — Le style d'affichage par défaut crée des visualisations sous forme de bougie entre les dimensions d'ouverture et de fermeture.
+ **Barres OHLC** — Affichez les quatre valeurs d'ouverture, de haute, de basse et de fermeture des quatre dimensions principales.

## Stratégie en matière de couleurs
<a name="v10-panels-candlestick-color"></a>
+ **Depuis Open** — Comportement par défaut. Ce mode utilisera la couleur *vers le haut* (ci-dessous) si l'évolution des prix intra-période est positive. En d'autres termes, si la valeur à la fermeture est supérieure ou égale à la valeur à l'ouverture, la couleur *Up* est utilisée.
+ **Depuis la fermeture précédente** — Méthode d'affichage alternative dans laquelle la couleur de la bougie est basée sur le mouvement des prix ou le changement de valeur entre les périodes. En d'autres termes, si la valeur à l'ouverture est supérieure à la valeur précédente à la fermeture, la couleur *Up* est utilisée. Si la valeur à l'ouverture est inférieure à la valeur précédente à la fermeture, la couleur *vers le bas* est utilisée. *Cette option déclenche également le mode de visualisation du chandelier creux*. Les chandeliers creux indiquent que le mouvement intra-période est positif (la valeur est plus élevée à la fermeture qu'à l'ouverture), les chandeliers pleins indiquent que le changement intra-période est négatif (la valeur est inférieure à la fermeture qu'à l'ouverture). Pour en savoir plus, consultez l'[explication des différences](https://thetradingbible.com/how-to-read-hollow-candlesticks).

## Couleurs ascendantes et descendantes
<a name="v10-panels-candlestick-updown"></a>

Les options de **couleur** vers le **haut et de couleur vers le bas** permettent de sélectionner les couleurs utilisées lorsque le mouvement des prix est à la hausse ou à la baisse. La *stratégie de couleur* ci-dessus déterminera si le mouvement des prix intra-période ou interpériode est utilisé pour sélectionner la couleur de la bougie ou de la barre OHLC.

## Ouvert, haut, bas, fermé
<a name="v10-panels-candlestick-ohlc"></a>

Le panneau en chandeliers tentera de mapper les champs à la dimension appropriée.
+ **Open** correspond à la valeur de départ de la période donnée.
+ La valeur la plus **élevée** correspond à la valeur la plus élevée de la période donnée.
+ **Faible** correspond à la valeur la plus faible de la période donnée.
+ **Close** correspond à la valeur finale (fin) de la période donnée.
+ **Le volume** correspond au nombre d'échantillons au cours de la période donnée. (par exemple, nombre de transactions)

**Note**  
La légende du chandelier n'affiche pas ces valeurs.

Pour mapper correctement ces dimensions, la table des résultats de requête de vos données doit inclure *au moins* les colonnes suivantes.
+ `timestamp`
+ `open`
+ `high`
+ `low`
+ `close`

Si vos données ne peuvent pas être mappées à ces dimensions pour une raison quelconque (par exemple, parce que les noms des colonnes ne sont pas les mêmes), vous pouvez les mapper manuellement à l'aide des champs **Ouvrir**, **Haut**, **Bas** et **Fermer** sous les options **Candlestick** de l'éditeur de panneaux.

## Champs supplémentaires
<a name="v10-panels-candlestick-other"></a>

**Champs supplémentaires**

Le panneau des chandeliers est basé sur la visualisation des séries chronologiques. Il peut visualiser des dimensions de données supplémentaires au-delà de l'ouverture, du haut, du faible, de la fermeture et du volume. Les options **Inclure** et **Ignorer** lui permettent de visualiser d'autres données incluses, telles que des moyennes mobiles simples, des bandes de Bollinger, etc., en utilisant les mêmes styles et configurations que ceux disponibles dans le. [Séries chronologiques](v10-panels-time-series.md)

# Canvas
<a name="v10-panels-canvas"></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 toiles allient la puissance de Grafana à la flexibilité des éléments personnalisés. Les canevas sont des panneaux de formulaires extensibles qui vous permettent de placer des éléments de manière explicite dans des mises en page statiques et dynamiques. Cela vous permet de concevoir des visualisations personnalisées et de superposer des données d'une manière qui n'est pas possible avec les panneaux Grafana standard, le tout dans l'interface utilisateur de Grafana. Si vous avez utilisé des outils d'interface utilisateur et de conception Web populaires, la conception de panneaux Canvas vous sera très familière.

## Eléments
<a name="v10-panels-canvas-elements"></a>

Vous pouvez ajouter ces éléments sur votre canevas. L'ajout de plusieurs types d'éléments vous permet de personnaliser une visualisation d'une manière qui n'est pas possible avec aucune autre visualisation.

**Valeur métrique**

L'élément de valeur métrique vous permet de sélectionner facilement les données que vous souhaitez afficher sur le canevas. Cet élément possède un mode d'*édition* unique qui peut être déclenché soit via l'option **Modifier** du menu contextuel, soit en double-cliquant sur le panneau. En mode édition, vous pouvez sélectionner les données de champ que vous souhaitez afficher.

**Text**

L'élément de texte vous permet d'ajouter facilement du texte au canevas. L'élément prend également en charge un mode d'édition, déclenché par un double-clic ou par l'option du menu d'édition dans le menu contextuel.

**Ellipse**

L'élément ellipse permet d'ajouter une ellipse de base au canevas. Un élément en ellipse peut afficher du texte (données fixes et données de terrain) et sa couleur d'arrière-plan peut être modifiée en fonction des seuils de données.

**Rectangulaire**

L'élément rectangle vous permet d'ajouter un rectangle de base au canevas. Les éléments d'un rectangle peuvent afficher du texte (données fixes et données de terrain) et sa couleur d'arrière-plan peut être modifiée en fonction des seuils de données.

**Icône**

L'élément icône vous permet d'ajouter une icône compatible au canevas. Les icônes peuvent avoir leur couleur définie en fonction de seuils ou de mappages de valeurs.

**de bases de données**

L'élément serveur vous permet de représenter facilement un serveur unique, une pile de serveurs, une base de données ou un terminal. Les éléments du serveur prennent en charge la couleur de l'état, la couleur de l'ampoule et le taux de clignotement de l'ampoule, tous configurables par des valeurs fixes ou des valeurs de champ.

**Button**

L'élément bouton permet d'ajouter un bouton de base au canevas. Les éléments des boutons permettent de déclencher des appels d'API de base non authentifiés. Les paramètres de l'API se trouvent dans l'éditeur d'éléments de bouton. Vous pouvez également transmettre des variables de modèle dans l'éditeur d'API.

**Note**  
Le choix d'un bouton ne déclenchera un appel d'API que lorsque l'édition en ligne est désactivée. Consultez [Édition de canevas](#v10-panels-canvas-editing).

## Connexions
<a name="v10-panels-canvas-connections"></a>

Lorsque vous créez un canevas, vous pouvez connecter des éléments entre eux pour créer des visualisations plus complexes. Vous pouvez créer des connexions en faisant glisser le pointeur de connexion d'un élément vers l'ancre de connexion d'un autre élément. Vous pouvez également créer des connexions avec l'arrière-plan du canevas. Les ancres de connexion s'affichent lorsque vous survolez un élément avec le pointeur de la souris et que l'édition en ligne est activée. Pour supprimer une connexion, sélectionnez-la, puis appuyez sur `Delete` ou`Backspace`.

Vous pouvez définir à la fois la taille et la couleur des connexions en fonction de valeurs fixes ou de champs. Pour ce faire, passez en mode édition de panneau, sélectionnez la connexion et modifiez les propriétés de la connexion dans l'éditeur de panneau.

## Édition de canevas
<a name="v10-panels-canvas-editing"></a>

**Éditeur en ligne**

Vous pouvez modifier votre canevas en ligne dans le contexte du mode tableau de bord.

**Panoramique et zoom**

Vous pouvez activer le panoramique et le zoom sur un canevas. Cela vous permet à la fois de créer et de naviguer dans des designs plus complexes.

**Note**  
Le panoramique et le zoom sont actuellement disponibles en avant-première par Grafana Labs. Support limité, et des modifications majeures peuvent survenir avant la disponibilité générale.

**Menu contextuel**

Le menu contextuel vous permet d'effectuer des tâches courantes rapidement et efficacement. Les fonctionnalités prises en charge incluent l'ouverture et la fermeture de l'éditeur intégré, la duplication d'un élément, la suppression d'un élément, etc.

Le menu contextuel est déclenché par un clic droit (ou équivalent) sur le panneau ou un élément du canevas donné.

Lorsque vous cliquez avec *le bouton droit sur le panneau*, vous pouvez définir une image d'arrière-plan et ajouter facilement des éléments au canevas.

Lorsque vous cliquez avec le bouton droit sur *un élément*, vous pouvez modifier, supprimer et dupliquer l'élément, ou modifier le positionnement de la couche de l'élément.

## Options du canevas
<a name="v10-panels-canvas-options"></a>

**Édition en ligne**

Le bouton d'édition intégré vous permet de verrouiller ou de déverrouiller le panneau du canevas. Lorsqu'il est éteint, le panneau de toile se *verrouille*, bloquant les éléments en place et empêchant toute modification involontaire.

**Liaisons de données**

Les canevas prennent en charge [les liens de données](v10-panels-configure-data-links.md). Vous pouvez créer un lien de données pour un élément à valeur métrique et l'afficher pour tous les éléments utilisant le nom du champ en suivant ces étapes.

**Pour créer un lien de données pour un élément**

1. Définissez un élément à lier à une valeur de champ.

1. Désactivez le bouton d'édition en ligne.

1. Créez un remplacement pour les **champs portant un nom** et sélectionnez le nom du champ de l'élément dans la liste.

1. Cliquez sur le bouton **\$1 Ajouter une propriété** de remplacement.

1. Sélectionnez **Liaisons de données > Liaisons de données dans la liste.**

1. Choisissez **\$1 Ajouter un lien**, ajoutez un titre et une URL pour le lien de données.

1. Passez le pointeur de la souris sur l'élément pour afficher l'infobulle du lien de données.

1. Choisissez l'élément pour pouvoir ouvrir le lien de données.

Si plusieurs éléments utilisent le même nom de champ et que vous souhaitez contrôler les éléments qui affichent le lien de données, vous pouvez créer un nom de champ unique à l'aide de la [Ajouter un champ à partir du calcul](v10-panels-xform-functions.md#v10-panels-xform-funcs-add) transformation. L'alias que vous créez dans la transformation apparaîtra sous forme de champ que vous pouvez utiliser avec un élément.

# Liste du tableau de bord
<a name="v10-panels-dashboard-list"></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 listes de tableaux de bord vous permettent d'afficher des liens dynamiques vers d'autres tableaux de bord. La liste peut être configurée pour utiliser des tableaux de bord marqués d'un favori, des tableaux de bord récemment consultés, une requête de recherche et des balises de tableau de bord.

À chaque chargement du tableau de bord, ce panneau interroge la liste des tableaux de bord, fournissant toujours le plus de up-to-date résultats.

**Options**

Utilisez ces options pour affiner votre visualisation.
+ **Inclure la plage horaire actuelle** : sélectionnez cette option pour propager la plage horaire du tableau de bord actuel vers les liens du tableau de bord. Lorsque l'utilisateur sélectionne un lien, le tableau de bord associé s'ouvre avec la plage de temps indiquée déjà définie.
+ **Inclure les valeurs des variables de modèle actuelles** : sélectionnez cette option pour inclure les variables de modèle actuellement utilisées comme paramètres de requête dans un lien. Lorsque l'utilisateur sélectionne un lien, tous les modèles correspondants du tableau de bord lié sont définis selon les valeurs de la liste. Pour de plus amples informations, veuillez consulter [Variables URL du tableau de bord](v10-dash-dashboard-url-variables.md).
+ **En vedette** : affiche les tableaux de bord favoris par ordre alphabétique.
+ **Consulté récemment** : affiche les tableaux de bord récemment consultés par ordre alphabétique.
+ **Recherche** : affichez les tableaux de bord par requête de recherche ou par balises. Vous devez saisir au moins une valeur dans **Requête** ou **Tags**. Pour les champs **Query** et **Tags**, l'interpolation variable est prise en charge, par exemple, `$my_var` ou`${my_var}`.
+ **Afficher les en-têtes** : la sélection de liste choisie (favoris, récemment consultée, recherche) est affichée sous forme de titre.
+ **Nombre maximum d'éléments** : définit le nombre maximum d'éléments à répertorier par section. Par exemple, si vous avez laissé la valeur par défaut de 10 et que vous avez affiché les tableaux de bord favoris et récemment consultés, le panneau affichera jusqu'à 20 tableaux de bord au total, dix dans chaque section.

**Rechercher**

Ces options ne s'appliquent que si l'option **Rechercher** est sélectionnée.
+ **Requête** — Entrez la requête à partir de laquelle vous souhaitez effectuer la recherche. Les requêtes ne distinguent pas les majuscules des minuscules et les valeurs partielles sont acceptées.
+ **Dossier** : sélectionnez les dossiers du tableau de bord que vous souhaitez afficher.
+ **Balises** — C'est ici que vous entrez les balises que vous souhaitez rechercher. Les balises existantes n'apparaîtront pas au fur et à mesure que vous tapez, et elles *distinguent les majuscules* et minuscules.

**Note**  
Lorsque plusieurs balises et chaînes apparaissent, la liste du tableau de bord affiche celles qui répondent à *toutes les* conditions.

# Grille de données
<a name="v10-panels-datagrid"></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)

**Note**  
La visualisation de la grille de données est actuellement en prévisualisation par Grafana Labs. Support limité, et des modifications majeures peuvent survenir avant la disponibilité générale.

Datagrids vous permet de créer, de modifier et d'affiner des données dans Grafana. Ce panneau peut donc servir de source de données pour les autres panneaux d'un tableau de bord.

![\[Image illustrant un exemple de visualisation d'une grille de données dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/datagrid-panel-example.png)


Il vous permet de manipuler les données demandées à partir de n'importe quelle source de données, de partir de zéro ou d'extraire des données d'un fichier glisser-déposer. Vous pouvez ensuite utiliser le panneau comme une simple visualisation tabulaire, ou vous pouvez modifier les données, voire les supprimer complètement, pour créer une page blanche.

La modification du jeu de données modifie la source de données pour utiliser la source de données **Grafana** intégrée, remplaçant les anciens paramètres de source de données et les requêtes associées, tout en copiant le jeu de données actuel dans le modèle de tableau de bord.

Vous pouvez ensuite utiliser le panneau comme source de données pour d'autres panneaux, en utilisant la source de données intégrée du **tableau de bord** pour extraire les données de la grille de données. Cela fournit une expérience de tableau de bord interactive, dans laquelle vous pouvez modifier les données et voir les modifications reflétées dans d'autres panneaux.

Pour plus d'informations sur les sources de données **Grafana** et **Dashboard**, consultez. [Sources de données spéciales](AMG-data-sources.md#AMG-data-sources-special)

## Menu contextuel
<a name="v10-panels-datagrid-context"></a>

Pour offrir une expérience plus rationalisée, la grille de données comporte un menu contextuel accessible en cliquant avec le bouton droit sur une cellule, un en-tête de colonne ou un sélecteur de ligne. En fonction de l'état de votre grille de données, le menu contextuel propose différentes options, dont les suivantes.
+ Supprimez ou effacez toutes les lignes et colonnes.
+ Supprimez toutes les données existantes (en rendant votre grille de données vide).
+ Déclenchez la fonctionnalité de recherche, qui vous permet de trouver des mots clés dans le jeu de données.

La suppression d'une ligne ou d'une colonne supprimera les données de la grille de données, tandis que l'effacement d'une ligne ou d'une colonne supprimera uniquement les données des cellules, laissant la ligne ou la colonne intacte.

**Menu d'en-tête**

Vous pouvez également accéder à un menu d'en-tête en choisissant l'icône déroulante à côté du titre de l'en-tête. À partir de là, vous pouvez non seulement supprimer ou effacer une colonne, mais également la renommer, la figer ou convertir le type de champ de la colonne.

## Sélection d'une série
<a name="v10-panels-datagrid-selectseries"></a>

S'il existe plusieurs séries, vous pouvez configurer la grille de données pour afficher le jeu de données préféré à l'aide de la liste déroulante **Sélectionner une série** dans les options du panneau.

## Utiliser des grilles de données
<a name="v10-panels-datagrid-using"></a>

Les Datagrids proposent différentes manières d'interagir avec vos données. Vous pouvez modifier, déplacer, effacer et supprimer des lignes et des colonnes, utiliser la fonctionnalité de recherche intégrée pour trouver des données spécifiques, convertir des types de champs ou bloquer le défilement horizontal sur une colonne spécifique.

**Ajouter des données**

Vous pouvez ajouter des données à une grille de données en créant une nouvelle colonne ou ligne.

**Pour ajouter une nouvelle colonne**

1. Dans un panneau existant, cliquez sur le bouton **\$1** dans l'en-tête du tableau après la dernière colonne.

1. Ajoutez un nom à la nouvelle colonne.

1. Sélectionnez n'importe quel endroit en dehors du champ ou appuyez `Enter` pour enregistrer la colonne.

Vous pouvez désormais ajouter des données dans chaque cellule.

Pour ajouter une nouvelle ligne, cliquez sur le bouton **\$1** après la dernière ligne. Le bouton est présent dans chaque cellule après la dernière ligne, et le fait de le sélectionner déclenche la création d'une nouvelle ligne tout en activant la cellule que vous avez choisie.

**Modification des données**

Vous pouvez déplacer des colonnes et des lignes selon vos besoins.

**Pour déplacer une colonne**

1. Appuyez et maintenez l'en-tête de la colonne à déplacer.

1. Faites glisser la colonne vers l'emplacement souhaité.

1. Relâchez la colonne pour finaliser le déplacement.

Pour déplacer une ligne, sélectionnez et maintenez le sélecteur de ligne dans la colonne numérique située à l'extrême gauche de la grille, puis faites-le glisser vers l'emplacement souhaité. Relâchez la ligne pour finaliser le déplacement.

**Sélection de plusieurs cellules**

Vous pouvez sélectionner plusieurs cellules en choisissant une seule cellule et en faisant glisser le pointeur sur les autres. Cette sélection peut être utilisée pour copier les données des cellules sélectionnées ou pour les supprimer à l'aide de la `Delete` touche.

**Supprimer ou effacer plusieurs lignes ou colonnes**

Pour supprimer ou effacer plusieurs lignes, vous pouvez effectuer les opérations suivantes.

**Pour supprimer ou effacer plusieurs lignes ou colonnes**

1. Passez le curseur sur la colonne numérique (à gauche de la première colonne de la grille) pour afficher la case à cocher.

1. Cochez les cases correspondant aux lignes que vous souhaitez utiliser. Pour sélectionner plusieurs lignes consécutives, maintenez la `Shift` touche enfoncée tout en cliquant sur la première et la dernière ligne. Pour sélectionner des lignes non consécutives, maintenez la touche `Ctrl` (ou`Cmd`) enfoncée tout en cliquant sur les lignes souhaitées.

1. Cliquez avec le bouton droit (ou équivalent) pour accéder au menu contextuel.

1. Sélectionnez **Supprimer les lignes** ou **Effacer les lignes**.

Les mêmes règles s'appliquent aux colonnes en cliquant sur les en-têtes des colonnes.

Pour supprimer toutes les lignes, cochez la case **Tout sélectionner** dans le coin supérieur gauche de la grille de données. Cela permet de sélectionner toutes les lignes et de les supprimer à l'aide du menu contextuel.

# Graphe de flammes
<a name="v10-panels-flamegraph"></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 graphes Flame vous permettent de visualiser les données de profilage. À l'aide de cette visualisation, le profil peut être représenté sous forme de graphe de flamme, de tableau ou des deux.

![\[Image illustrant un exemple de visualisation d'un graphe de flammes dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/flamegraph-panel-example.png)


## Mode Flame Graph
<a name="v10-panels-flamegraph-mode"></a>

Un graphe en flamme tire parti de la nature hiérarchique des données de profilage. Il condense les données dans un format qui vous permet de voir facilement quels chemins de code consomment le plus de ressources système, tels que le temps processeur, les objets alloués ou l'espace lorsque vous mesurez la mémoire. Chaque bloc du graphe de flammes représente un appel de fonction dans une pile et sa largeur représente sa valeur.

Les sections grisées sont un ensemble de fonctions qui représentent une valeur relativement faible et qui sont regroupées en une seule section pour des raisons de performance.

Vous pouvez survoler une fonction spécifique pour afficher une infobulle qui affiche des données supplémentaires sur cette fonction, telles que la valeur de la fonction, le pourcentage de la valeur totale et le nombre d'échantillons contenant cette fonction.

**Actions déroulantes**

Vous pouvez cliquer sur une fonction pour afficher un menu déroulant contenant des actions supplémentaires : 
+ **Bloc de mise** au **point : lorsque vous choisissez le bloc** de mise au point, le bloc, ou la fonction, est défini sur 100 % de la largeur du graphe en flammes et toutes ses fonctions secondaires sont affichées avec leur largeur mise à jour par rapport à la largeur de la fonction parent. Cela facilite l'exploration de parties plus petites du graphe de flammes.
+ **Copier le nom de la fonction** — Lorsque vous choisissez **Copier le nom** de la fonction, le nom complet de la fonction représentée par le bloc est copié.
+ **Vue sandwich** — La vue sandwich vous permet d'afficher le contexte de la fonction sur laquelle vous avez cliqué. Il affiche tous les appelants de la fonction en haut et tous les appelés en bas. Cela montre le contexte agrégé de la fonction. Ainsi, si la fonction existe à plusieurs endroits dans le graphe en flammes, tous les contextes sont affichés et agrégés dans la vue sandwich.

**Barre d'état**

 La barre d'état affiche les métadonnées relatives au graphe en flamme et aux modifications actuellement appliquées, telles que la partie du graphique qui est focalisée ou la fonction affichée en mode sandwich. Cliquez sur le **X** dans la pilule de la barre d'état pour supprimer cette modification.

## Barre d'outils
<a name="v10-panels-flamegraph-toolbar"></a>

**Rechercher**

Vous pouvez utiliser le champ de recherche pour trouver des fonctions portant un nom particulier. Toutes les fonctions du graphe en flammes correspondant à la recherche resteront colorées tandis que les autres fonctions seront grisées.

**Sélecteur de schéma de couleurs**

Vous pouvez passer d'une fonction de coloration à l'autre en fonction de leur valeur ou du nom de leur package pour relier visuellement les fonctions d'un même package.

**Aligner le texte**

Alignez le texte vers la gauche ou vers la droite pour afficher les parties les plus importantes du nom de la fonction lorsqu'il ne rentre pas dans le bloc.

**Sélecteur de visualisation**

Vous pouvez choisir de n'afficher que le graphique des flammes, uniquement le tableau ou les deux en même temps.

## Mode table supérieure
<a name="v10-panels-flamegraph-toptablemode"></a>

Le tableau supérieur présente les fonctions du profil sous forme de tableau. Le tableau comporte trois colonnes : symboles, soi et total. Le tableau est trié par heure par défaut, mais il peut être réorganisé par temps total ou par nom de symbole en cliquant sur les en-têtes des colonnes. Chaque ligne représente les valeurs agrégées pour la fonction donnée si celle-ci apparaît à plusieurs endroits du profil.

Il existe également des boutons d'action sur la gauche pour chaque ligne. Le premier bouton recherche le nom de la fonction tandis que le second affiche la vue sandwich de la fonction.

## API de données
<a name="v10-panels-flamegraph-dataapi"></a>

Pour afficher le graphe en flamme, vous devez formater les données du bloc de données à l'aide d'un [modèle d'ensemble imbriqué](https://wikipedia.org/wiki/Nested_set_model).

Un modèle d'ensemble imbriqué garantit que chaque élément du graphe de flamme est codé uniquement en fonction de son niveau d'imbrication sous forme de valeur entière, de ses métadonnées et de son ordre dans le bloc de données. Cela signifie que l'ordre des articles est important et doit être correct. L'ordre consiste à parcourir d'abord en profondeur les éléments du graphe en flamme, ce qui permet de recréer le graphique sans avoir besoin de valeurs de longueur variable dans le bloc de données, comme dans un tableau pour enfants.

Champs obligatoires :


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| level | number | Le niveau d'imbrication de l'élément. En d'autres termes, combien d'éléments se trouvent entre cet élément et l'élément supérieur du graphe en forme de flamme. | 
| value | number | La valeur absolue ou cumulée de l'élément. Cela se traduit par la largeur de l'élément dans le graphique. | 
| étiquette | chaîne | Étiquette à afficher pour l'article en question. | 
| self | number | Valeur propre qui est généralement la valeur cumulée de l'article moins la somme des valeurs cumulées de ses enfants immédiats. | 

# Jauge
<a name="v10-panels-gauge"></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 jauges sont des visualisations à valeur unique qui peuvent répéter une jauge pour chaque série, colonne ou ligne.

![\[Image montrant un exemple de visualisation d'une jauge dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/gauge_example.png)


## Options de valeur
<a name="v10-panels-gauge-value"></a>

Utilisez les options suivantes pour affiner la façon dont votre visualisation affiche la valeur :

**Afficher**

Choisissez la manière dont Grafana affiche vos données.

*Calculer*

Afficher une valeur calculée en fonction de toutes les lignes.
+ **Calcul** — Sélectionnez une fonction de réduction que Grafana utilisera pour réduire de nombreux champs à une seule valeur. Pour obtenir la liste des calculs disponibles, reportez-vous à[Types de calculs](v10-panels-calculation-types.md).
+ **Champs** — Sélectionnez les champs à afficher dans le panneau.

*Toutes les valeurs*

Afficher une statistique distincte pour chaque ligne. Si vous sélectionnez cette option, vous pouvez également limiter le nombre de lignes à afficher.
+ **Limite** : nombre maximal de lignes à afficher. La valeur par défaut est 5 000.
+ **Champs** — Sélectionnez les champs à afficher dans le panneau.

## Jauge
<a name="v10-panels-gauge-gauge"></a>

Réglez le mode d'affichage de la jauge.

**Orientation**

Choisissez une direction d'empilement.
+ **Auto** — Les jauges s'affichent en lignes et en colonnes.
+ **Horizontal** — Les jauges s'affichent de haut en bas.
+ **Vertical** — Les jauges s'affichent de gauche à droite.

**Afficher les étiquettes de seuil**

Contrôle si les valeurs de seuil sont affichées.

**Afficher les marqueurs de seuil**

Contrôle si une bande de seuil est affichée en dehors de la bande de valeur de jauge intérieure.

**Taille de la jauge**

Choisissez un modèle de taille de jauge
+ **Auto** — Grafana détermine la meilleure taille de jauge.
+ **Manuel** — Configurez manuellement la taille de la jauge.

**Largeur minimale**

Définissez la largeur minimale des jauges orientées verticalement.

Si vous définissez une largeur minimale, la barre de défilement de l'axe X s'affiche automatiquement en cas de grande quantité de données.

**Note**  
Cette option s'applique uniquement lorsque la taille de la jauge est réglée sur manuel.

**Hauteur minimale**

Définissez la hauteur minimale des jauges orientées horizontalement.

Si vous définissez une hauteur minimale, la barre de défilement de l'axe Y s'affiche automatiquement en cas de grande quantité de données.

**Note**  
Cette option s'applique uniquement lorsque la taille de la jauge est réglée sur manuel.

**Neutre**

Définissez la valeur de départ à partir de laquelle chaque jauge sera remplie.

## Taille du texte
<a name="v10-panels-gauge-textsize"></a>

Ajustez la taille du texte de la jauge.
+ **Titre** — Entrez une valeur numérique pour la taille du titre de la jauge.
+ **Valeur** — Entrez une valeur numérique pour la taille de la valeur de jauge.

# Géomap
<a name="v10-panels-geomap"></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 géomaps vous permettent de visualiser et de personnaliser la carte du monde à l'aide de données géospatiales. Vous pouvez configurer différents styles de superposition et paramètres de vue cartographique pour vous concentrer facilement sur les caractéristiques géolocalisées importantes des données.

**Note**  
Vous pouvez ajouter vos propres données géospatiales au-dessus des couches de fond de carte fournies par. AWS Les couches de fond de carte doivent toutes provenir de [https://tiles.maps.search-services.aws.a2z.com](https://tiles.maps.search-services.aws.a2z.com). 

![\[Image illustrant un exemple de visualisation d'une carte géographique à Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/geomap-panel-example.png)


## Vue Carte
<a name="v10-panels-geomap-view"></a>

La vue cartographique contrôle la vue initiale de la carte lorsque le tableau de bord se charge.

**Vue initiale**

La vue initiale configure le rendu du GeoMap panneau lors de son premier chargement.
+ La **vue** définit le centre de la carte lorsque le panneau se charge pour la première fois.
  + L'**ajustement aux données** s'adapte à la vue cartographique en fonction de l'étendue des données des couches cartographiques et se met à jour lorsque les données changent.
    + L'option **Data** permet de sélectionner l'étendue en fonction des données provenant de *toutes les couches*, d'une seule *couche* ou de la *dernière valeur* d'une couche sélectionnée.
    + **La couche** peut être sélectionnée si elle correspond aux données d'une seule *couche* ou à la *dernière valeur* d'une couche.
    + **Le remplissage** définit le remplissage en pourcentage relatif au-delà de l'étendue des données (non disponible uniquement lorsque vous consultez la *dernière valeur*).
    + Le **zoom maximal** définit le niveau de zoom maximal lors de l'ajustement des données.
  + **Coordinates** définit la vue de la carte en fonction de :
    + **Latitude**
    + **Longitude**
  + Les vues par défaut sont également disponibles, notamment :
    + **(0°, 0°)**
    + **Amérique du Nord**
    + **Amérique du Sud**
    + **L'Europe**
    + **Afrique**
    + **Asie de l'Ouest**
    + **Asie du Sud**
    + **Asie du Sud-Est**
    + **Asie de l'Est**
    + **Australie**
    + **Océanie**
+ **Zoom** définit le niveau de zoom initial.

## Couches cartographiques
<a name="v10-panels-geomap-layers"></a>

Les géomaps prennent en charge l'affichage de plusieurs couches. Chaque couche détermine la manière dont vous visualisez les données géospatiales au-dessus de la carte de base.

**Types**

Vous avez le choix entre trois types de couches cartographiques dans la visualisation Geomap.
+ [Couche de marqueurs](#v10-panels-geomap-markers)affiche un marqueur à chaque point de données.
+ [couche Heatmap](#v10-panels-geomap-heatmap)visualise une carte thermique des données.
+ [couche GeoJSON](#v10-panels-geomap-geojson)affiche des données statiques à partir d'un fichier GeoJSON.
+ [Couche jour/nuit (Alpha)](#v10-panels-geomap-nightday)affiche une région nocturne ou diurne.
+ [Couche d'itinéraires (aperçu)](#v10-panels-geomap-route)afficher les points de données sous forme d'itinéraire.
+ [Couche de photos (aperçu)](#v10-panels-geomap-photos)affiche une photo à chaque point de données.
+ [Couche réseau (aperçu)](#v10-panels-geomap-network)visualise un graphe de réseau à partir des données.

Il existe également deux types de couches expérimentales (ou alpha).
+ **L'icône au dernier point (alpha)** affiche une icône au dernier point de données.
+ **Dynamic GeoJSON (alpha) stylise** un fichier GeoJSON en fonction des résultats de requête.

**Note**  
Calques marqués « *aperçu* » ou « *alpha* » dans l'aperçu public. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.

**Contrôles des couches**

Les commandes des couches vous permettent de créer des couches, de modifier leur nom, de réorganiser et de supprimer des couches.
+ **Ajouter une couche** crée une couche de données supplémentaire configurable pour la carte géographique. Lorsque vous ajoutez une couche, vous êtes invité à sélectionner un type de couche. Vous pouvez modifier le type de couche à tout moment lors de la configuration du panneau.
+ Les commandes des couches vous permettent de renommer, de supprimer et de réorganiser les couches du panneau.
  + **Modifier le nom de la couche** (icône en forme de crayon) renomme la couche.
  + **Trash Bin** supprime la couche.
  + **Le réordre** (six dots/grab poignées) vous permet de modifier l'ordre des couches. Les données relatives aux couches supérieures apparaîtront au-dessus des données relatives aux couches inférieures. La visualisation met à jour l'ordre des couches au fur et à mesure que vous glissez et déposez afin de simplifier le choix de l'ordre des couches.

Vous pouvez ajouter plusieurs couches de données à un seul panneau de géomarographie afin de créer des visualisations riches et détaillées.

**Emplacement**

Geomaps a besoin d'une source de données géographiques. Ces données proviennent d'une requête de base de données, et il existe quatre options de mappage pour vos données.
+ Recherche **automatiquement** les données de localisation. Utilisez cette option lorsque votre requête est basée sur l'un des noms de champs de données suivants.
  + *géohash* : `geohash`
  + *latitude* :`latitude`, `lat`
  + *longitude* :`longitude`,`lng`, `lon`
  + *recherche* : `lookup`
+ **Coords** indique que votre requête contient des données de coordonnées. Vous serez invité à sélectionner des champs de données numériques pour la latitude et la longitude dans votre requête de base de données.
+ **Geohash** indique que votre requête contient des données de géohash. Vous serez invité à sélectionner un champ de données sous forme de chaîne pour le géohash dans votre requête de base de données.
+ **Lookup** indique que votre requête contient des données de nom de lieu qui doivent être mappées à une valeur. Vous serez invité à sélectionner le champ de recherche dans votre requête de base de données et dans un répertoire géographique. Le répertoire géographique est le répertoire utilisé pour mapper les données que vous avez demandées à un point géographique.

## Couche de marqueurs
<a name="v10-panels-geomap-markers"></a>

La couche de marqueurs vous permet d'afficher les points de données sous différentes formes de marqueurs, telles que des cercles, des carrés, des triangles, des étoiles, etc.

Les marqueurs disposent de nombreuses options de personnalisation.
+ **La taille** configure la taille des marqueurs. La valeur par défaut est la même pour toutes les tailles de marqueur`Fixed size`, quelles que soient les données ; toutefois, il existe également une option permettant de dimensionner les marqueurs en fonction des données correspondant au champ sélectionné. `Min`et la taille du `Max` marqueur doit être définie de telle sorte que la couche Marker puisse être redimensionnée dans cette plage.
+ Le **symbole** vous permet de choisir le symbole, l'icône ou le graphique afin de fournir un contexte visuel supplémentaire à vos données. Choisissez parmi les ressources incluses dans Grafana, telles que des symboles simples ou la bibliothèque Unicon. Vous pouvez également spécifier une URL contenant une ressource d'image. L'image doit être un graphique vectoriel évolutif (SVG).
+ L'**alignement vertical des symboles** configure l'alignement vertical du symbole par rapport au point de données. Notez que l'angle de rotation du symbole s'applique d'abord autour du point de données, puis l'alignement vertical est appliqué par rapport à la rotation du symbole.
+ L'**alignement horizontal des symboles** configure l'alignement horizontal du symbole par rapport au point de données. Notez que l'angle de rotation du symbole s'applique d'abord autour du point de données, puis l'alignement horizontal est appliqué par rapport à la rotation du symbole.
+ **La couleur** configure la couleur des marqueurs. La valeur par défaut `Fixed color` définit une couleur spécifique pour tous les marqueurs. Il existe également une option permettant d'avoir des couleurs conditionnelles en fonction des valeurs des points de données du champ sélectionné et du jeu de couleurs défini dans la section **Options standard**.
+ **L'opacité du remplissage** configure la transparence de chaque marqueur.
+ **L'angle de rotation** configure l'angle de rotation de chaque marqueur. La valeur par défaut est **Valeur fixe**, qui fait pivoter tous les marqueurs selon le même angle, quelles que soient les données ; toutefois, il existe également une option permettant de définir la rotation des marqueurs en fonction des données correspondant au champ sélectionné.
+ **L'étiquette de texte** configure une étiquette de texte pour chaque marqueur.
+ **Afficher la légende** vous permet de changer la légende des couches.
+ **Afficher l'infobulle vous permet de basculer** entre les infobulles de la couche.

## couche Heatmap
<a name="v10-panels-geomap-heatmap"></a>

La couche de carte thermique regroupe différents points de données pour visualiser des emplacements présentant différentes densités.

![\[Image illustrant un exemple de carte thermique utilisant la visualisation de la géomarte dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/geomap-heatmap-example.png)


Pour ajouter une couche de carte thermique :

Choisissez dans le menu déroulant sous Data Layer et sélectionnez`Heatmap`.

De même`Markers`, des options vous sont proposées pour déterminer les points de données à visualiser et la manière dont vous souhaitez les visualiser.
+ **Les valeurs de pondération** configurent l'intensité des clusters de cartes thermiques. **La valeur fixe** permet de conserver une valeur de pondération constante sur tous les points de données. Cette valeur doit être comprise entre 0 et 1. Comme pour les marqueurs, il existe une autre option dans la liste déroulante pour redimensionner automatiquement les valeurs de poids en fonction des valeurs de données.
+ **Radius** configure la taille des clusters de cartes thermiques.
+ **Le flou** configure le niveau de flou sur chaque cluster.
+ **L'opacité** configure l'opacité de chaque cluster.
+ **Afficher l'infobulle vous permet de basculer** entre les infobulles de la couche.

## couche GeoJSON
<a name="v10-panels-geomap-geojson"></a>

La couche GeoJSON vous permet de sélectionner et de charger un fichier GeoJSON statique depuis le système de fichiers.
+ **L'URL GeoJSON** fournit un choix de fichiers GeoJSON fournis avec Grafana.
+ **Le style par défaut** contrôle les styles à appliquer lorsqu'aucune des règles ci-dessus ne correspond.
  + **Couleur :** configure la couleur du style par défaut
  + **L'opacité** configure l'opacité par défaut
+ **Les règles de style** appliquent des styles en fonction des propriétés des fonctionnalités
  + **La règle** vous permet de sélectionner une *entité*, une *condition* et une *valeur* dans le fichier GeoJSON afin de définir une règle. L'icône de la corbeille peut être utilisée pour supprimer la règle actuelle.
  + **Couleur :** configure la couleur du style pour la règle actuelle.
  + **L'opacité** configure le niveau de transparence de la règle actuelle.
+ **Ajouter une règle de style** crée des règles de style supplémentaires.
+ **Afficher l'infobulle vous permet de basculer** entre les infobulles de la couche.

## Couche jour/nuit (Alpha)
<a name="v10-panels-geomap-nightday"></a>

La couche Night/Day affiche les régions nocturnes et diurnes en fonction de la plage horaire actuelle.

![\[Image illustrant un exemple de couche jour/nuit utilisant la visualisation géomarographique de Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/geomap-day-night-example.png)


**Options**
+ **Afficher fait** basculer la source de temps de la plage horaire du panneau.
+ La **couleur de la région nocturne** sélectionne la couleur de la région nocturne.
+ **Afficher l'icône du soleil** fait basculer le soleil.
+ **Opacité** comprise entre 0 (transparent) et 1 (opaque).
+ **Afficher l'infobulle vous permet de basculer** entre les infobulles de la couche.

**Note**  
Pour plus d'informations, voir [Extensions pour OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html).

## Couche d'itinéraires (aperçu)
<a name="v10-panels-geomap-route"></a>

La couche Route affiche les points de données sous forme d'itinéraire.

**Note**  
La couche Route est actuellement en version préliminaire publique. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.

![\[Image illustrant un exemple de couche d'itinéraires utilisant la visualisation de la géomarte dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/geomap-route-layer-example.png)


**Options**
+ **La taille** définit l'épaisseur du tracé. Valeur fixe par défaut. Lorsque les données de champ sont sélectionnées, vous pouvez définir la plage minimale et maximale dans laquelle les données de champ peuvent être mises à l'échelle.
+ **La couleur** définit la couleur de l'itinéraire. Réglé sur une couleur fixe par défaut, vous pouvez également lier la couleur aux données du champ.
+ **L'opacité de remplissage** configure l'opacité de l'itinéraire.
+ **L'étiquette de texte** configure une étiquette de texte pour chaque itinéraire.
+ **Arrow** configure le style des flèches à afficher le long de l'itinéraire, dans l'ordre des données.
  + **Aucun**
  + **Vers l'avant**
  + **Inverser**
+ **Afficher l'infobulle vous permet de basculer** entre les infobulles de la couche.

**Note**  
Pour plus d'informations, voir [Extensions pour OpenLayers - Flow Line Style](http://viglino.github.io/ol-ext/examples/style/map.style.gpxline.html).

## Couche de photos (aperçu)
<a name="v10-panels-geomap-photos"></a>

La couche Photos affiche une photo à chaque point de données.

**Note**  
La couche Photos est actuellement en prévisualisation publique. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.

**Options**
+ Le **champ source d'image** vous permet de sélectionner un champ de chaîne contenant des données d'image sous forme de binaire d'image codé en Base64 (`data:image/png;base64,...`).
+ **Kind** définit le style du cadre autour des images. Choisissez parmi :
  + **Square**
  + **Circle**
  + **Ancré**
  + **Folio**
+ Le **recadrage** indique si les images sont recadrées pour s'ajuster.
+ **Shadow** fait basculer une ombre encadrée située derrière les images.
+ La **bordure** définit la taille de la bordure autour des images.
+ **La couleur des bordures** définit la couleur des bordures autour des images.
+ Le **rayon** définit la taille globale des images en pixels.
+ **Afficher l'infobulle vous permet de basculer** entre les infobulles de la couche.

**Note**  
Pour plus d'informations, voir [Extensions pour OpenLayers - Image Photo Style](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html).

## Couche réseau (aperçu)
<a name="v10-panels-geomap-network"></a>

La couche réseau affiche un graphe de réseau. Ces couches prennent en charge le même format de données que celui pris en charge par la visualisation du graphe de nœuds, avec l'ajout de données géospatiales incluses dans les données des nœuds. Les données géospatiales sont utilisées pour localiser et afficher les nœuds sur la carte.

**Note**  
La couche réseau est actuellement en version préliminaire publique. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.

![\[Une image montrant des exemples de visualisations de réseaux sur une carte géographique à Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/geomap-network-layer-example.png)


**Note**  
La couche réseau est actuellement en version préliminaire publique. Grafana Labs offre un support limité, et des modifications importantes peuvent survenir avant que la fonctionnalité ne soit généralement disponible.

**Options**
+ La **flèche** définit la direction de la flèche à afficher pour chaque arête, l'avant signifiant de la source à la cible. Choisissez parmi :
  + **Aucun**
  + **Vers l'avant**
  + **Inverser**
  + **Les deux**
+ **Afficher la légende** vous permet de changer la légende de la couche. La légende ne prend en charge que les données des nœuds.
+ **Afficher l'infobulle vous permet de basculer** entre les infobulles de la couche.

**Styles de nœuds**
+ **La taille** configure la taille des nœuds. La valeur par défaut est **Taille fixe**, ce qui rend toutes les tailles de nœuds identiques quelles que soient les données ; toutefois, il existe également une option permettant de dimensionner les nœuds en fonction des données correspondant à un champ sélectionné. Les tailles **minimale** et **maximale** des nœuds doivent être définies de manière à ce que les nœuds puissent évoluer dans cette plage.
+ **La couleur** configure la couleur des nœuds. La valeur par défaut est **Couleur fixe**, qui définit une couleur spécifique pour tous les nœuds. Il existe également une option permettant d'avoir des couleurs conditionnelles en fonction des valeurs des points de données du champ sélectionné et du jeu de couleurs défini dans la section **Options standard**.
+ Le **symbole** vous permet de choisir le symbole, l'icône ou le graphique pour fournir un contexte visuel supplémentaire à vos données. Choisissez parmi les ressources incluses dans Grafana, telles que des symboles simples ou la bibliothèque Unicon. Vous pouvez également spécifier une URL contenant une ressource d'image. L'image doit être un graphique vectoriel évolutif (SVG).
+ **L'opacité de remplissage** configure la transparence de chaque nœud.
+ **L'angle de rotation** configure l'angle de rotation de chaque nœud. La valeur par défaut est **une valeur fixe**, qui fait pivoter tous les nœuds selon le même angle, quelles que soient les données ; toutefois, il existe également une option permettant de définir la rotation des nœuds en fonction des données correspondant à un champ sélectionné.
+ **L'étiquette de texte** configure une étiquette de texte pour chaque nœud.

**Styles de bord**
+ **La taille** configure la largeur de ligne des arêtes. La valeur par défaut est **Taille fixe**, ce qui rend toutes les largeurs de ligne de bord identiques quelles que soient les données ; toutefois, il existe également une option permettant de dimensionner les arêtes en fonction des données correspondant au champ sélectionné. Les tailles **minimale** et **maximale** des arêtes doivent être définies de telle sorte que les arêtes puissent être redimensionnées dans cette plage.
+ **La couleur** configure la couleur des bords. La valeur par défaut est **Couleur fixe**, qui définit une couleur spécifique pour tous les bords. Il existe également une option permettant d'avoir des couleurs conditionnelles en fonction des valeurs des points de données du champ sélectionné et du jeu de couleurs défini dans la section **Options standard**.
+ **L'opacité du remplissage** configure la transparence de chaque arête.
+ **L'étiquette de texte** configure une étiquette de texte pour chaque bord.

## couche CARTO
<a name="v10-panels-geomap-carto"></a>

Les couches CARTO ne sont pas prises en charge dans Amazon Managed Grafana.

## couche de tuiles XYZ
<a name="v10-panels-geomap-xyz"></a>

Les couches de tuiles XYZ ne sont pas prises en charge dans Amazon Managed Grafana.

## Couche Open Street Map
<a name="v10-panels-geomap-osm"></a>

Les couches Open Street Map (autres que la carte basée par défaut) ne sont pas prises en charge dans Amazon Managed Grafana.

## couche ArcGIS
<a name="v10-panels-geomap-arcgis"></a>

Les couches ArcGIS ne sont pas prises en charge dans Amazon Managed Grafana.

## Contrôles cartographiques
<a name="v10-panels-geomap-controls"></a>

La section des contrôles cartographiques contient diverses options pour les informations cartographiques et les superpositions d'outils.

**Zoom**

Options pour les commandes de zoom.

*Afficher le contrôle du zoom*

Affiche les commandes de zoom dans le coin supérieur gauche.

*Zoom avec molette de souris*

S'active ou se désactive à l'aide de la molette de la souris pour zoomer ou dézoomer.

**Afficher l'attribution**

Affiche l'attribution des couches de fond de carte sur la carte.

**Afficher l'échelle**

Affiche les informations d'échelle dans le coin inférieur gauche.

**Note**  
Affiche les unités en [m]/[km].

**Afficher les outils de mesure**

Affiche les outils de mesure dans le coin supérieur droit. Les mesures apparaissent uniquement lorsque cette commande est ouverte.
+ **Cliquez** pour commencer à mesurer
+ **Continuez à cliquer** pour poursuivre la mesure
+ **Double-cliquez** pour terminer la mesure

**Note**  
Lorsque vous modifiez le type ou les unités de mesure, la mesure précédente est supprimée de la carte.  
Si le contrôle est fermé puis rouvert, la mesure la plus récente est affichée.  
Une mesure peut être modifiée en cliquant dessus et en la faisant glisser.

*Longueur*

Obtenez la longueur sphérique d'une géométrie. Cette longueur est la somme des distances entre les grands cercles entre les coordonnées. Pour les géométries en plusieurs parties, la longueur est la somme de la longueur de chaque pièce. Les géométries sont supposées être dans « EPSG:3857 ».

Vous pouvez choisir les unités suivantes pour les mesures de longueur :
+ **Métrique (m/km)**
+ **Pieds (pieds)**
+ **Miles (miles)**
+ **Miles nautiques (nmi)**

*Area*

Obtenez la zone sphérique d'une géométrie. Cette zone est calculée en supposant que les arêtes des polygones sont des segments de grands cercles sur une sphère. Les géométries sont supposées être dans « EPSG:3857 ».

Vous pouvez choisir les unités suivantes pour les mesures de surface :
+ **Mètres carrés (m²)**
+ **Kilomètres carrés (km²)**
+ **Pieds carrés (ft²)**
+ **Miles carrés (mi²)**
+ **Hectares (acres)**
+ **Hectare (ha)**

**Afficher le débogage**

Affiche les informations de débogage dans le coin supérieur droit de la carte. Cela peut être utile pour le débogage ou la validation d'une source de données.
+ **Zoom** affiche le niveau de zoom actuel de la carte.
+ Le **centre** affiche la **longitude** et la **latitude** actuelles du centre de la carte.

**Info-bulle**
+ **Aucune n'**affiche les infobulles uniquement lorsque l'utilisateur clique sur un point de données.
+ **Details** affiche des infobulles lorsqu'un pointeur passe au-dessus d'un point de données.

# Heatmap
<a name="v10-panels-heatmap"></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)

La visualisation du panneau Heatmap vous permet de visualiser les histogrammes au fil du temps. Pour plus d'informations sur les histogrammes, reportez-vous à[Présentation des histogrammes et des cartes thermiques](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps).

![\[Image illustrant un exemple de visualisation d'une carte thermique dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/heatmap_example.jpg)


## Calculer à partir des données
<a name="v10-panels-heatmap-calculate"></a>

Ce paramètre détermine si les données sont déjà une carte thermique calculée (à partir de la source/du transformateur de données) ou si elles doivent être calculées dans le panneau.

**Seau X**

Ce paramètre détermine la façon dont l'axe X est divisé en compartiments. Vous pouvez spécifier un intervalle de temps dans la saisie **Taille**. Par exemple, une plage de temps de `1h` fait que les cellules ont une largeur d'une heure sur l'axe X.

**Seau en Y**

Ce paramètre détermine la façon dont l'axe Y est divisé en compartiments.

**Balance à godets Y**

Sélectionnez l'une des échelles de valeurs de l'axe Y suivantes :
+ **linear** — Échelle linéaire.
+ **log (base 2)** — Échelle logarithmique en base 2.
+ **log (base 10)** — Échelle logarithmique en base 10.
+ **symlog — Échelle** Symlog.

## Axes Y
<a name="v10-panels-heatmap-y-axes"></a>

Définit le mode d'affichage de l'axe Y

**Placement**
+ **Gauche** — Sur la gauche
+ **Droite** — Sur la droite
+ **Masqué** — Masqué

**Unité**

Configuration de l'unité

**Décimales**

Ce paramètre détermine la configuration décimale.

**Valeur min/max**

Ce paramètre permet de configurer la plage d'axes.

**Inverser**

Lorsque cette option est sélectionnée, l'axe apparaît dans l'ordre inverse.

**Afficher plusieurs axes Y**

Dans certains cas, vous souhaiterez peut-être afficher plusieurs axes Y. Par exemple, si vous disposez d'un jeu de données indiquant à la fois la température et l'humidité au fil du temps, vous souhaiterez peut-être afficher deux axes Y avec des unités différentes pour ces deux séries.

Vous pouvez le faire en [ajoutant des remplacements de champs](v10-panels-configure-overrides.md). Suivez les étapes autant de fois que nécessaire pour ajouter autant d'axes Y que nécessaire.

## Couleurs
<a name="v10-panels-heatmap-colors"></a>

Le spectre de couleurs contrôle le mappage entre le nombre de valeurs (dans chaque compartiment) et la couleur attribuée à chaque compartiment. La couleur la plus à gauche du spectre représente le nombre minimum et la couleur située le plus à droite représente le nombre maximum. Certaines combinaisons de couleurs sont automatiquement inversées lorsque vous utilisez le thème de la lumière.

Vous pouvez également définir le mode couleur sur Opacité. Dans ce cas, la couleur ne changera pas, mais le degré d'opacité changera en fonction du nombre de compartiments
+ **Mode**
  + **Schéma** — Valeur du compartiment représentée par la couleur de la cellule.
    + **Schéma** : si le mode est **Schéma**, sélectionnez un jeu de couleurs.
  + **opacité** — Valeur du compartiment représentée par l'opacité de la cellule. Cellule opaque signifie valeur maximale.
    + **Couleur — Couleur** de base de la cellule.
    + **Échelle** : échelle permettant de mapper les valeurs des compartiments à l'opacité.
      + **linear** — Échelle linéaire. La valeur du compartiment correspond linéairement à l'opacité.
      + **sqrt** — Échelle de puissance. L'opacité de la cellule est calculée comme `value ^ k` suit : où se `k` trouve une valeur d'**exposant** configurée. Si l'exposant est inférieur à`1`, vous obtiendrez une échelle logarithmique. Si l'exposant est supérieur à`1`, vous obtiendrez une échelle exponentielle. Dans ce cas`1`, l'échelle sera la même que l'échelle linéaire.
    + **Exposant** : valeur de l'exposant, supérieure à. `0`

**Couleur de début/fin à partir de la valeur**

Par défaut, Grafana calcule les couleurs des cellules en fonction des valeurs minimales et maximales des compartiments. Avec Min et Max, vous pouvez remplacer ces valeurs. Considérez une valeur de compartiment comme un axe Z et Min et Max comme Z-Min et Z-Max, respectivement.
+ **Début** : valeur minimale utilisée pour le calcul de la couleur des cellules. Si la valeur du compartiment est inférieure à Min, elle est mappée à la couleur « minimale ». La valeur minimale de la série est la valeur par défaut.
+ **Fin** : valeur maximale utilisée pour le calcul de la couleur des cellules. Si la valeur du compartiment est supérieure à Max, elle est mappée sur la couleur « maximale ». La valeur maximale de la série est la valeur par défaut.

## Écran cellulaire
<a name="v10-panels-heatmap-cell"></a>

Utilisez ces paramètres pour affiner votre visualisation.

## Options d'affichage supplémentaires
<a name="v10-panels-heatmap-options"></a>

**Info-bulle**
+ **Afficher l'infobulle : affiche** l'infobulle d'outil de la carte thermique.
+ **Afficher l'histogramme : affiche** un histogramme de l'axe Y dans l'infobulle. Un histogramme représente la distribution des valeurs des compartiments pour un horodatage spécifique.
+ **Afficher l'échelle de couleurs** : affiche une échelle de couleurs dans l'infobulle. L'échelle de couleurs représente le mappage entre la valeur du compartiment et la couleur.

**Légende**

Choisissez si vous souhaitez afficher la légende de la carte thermique sur la visualisation.

**Exemplaires**

Définissez la couleur utilisée pour afficher les données exemplaires.

# Histogramme
<a name="v10-panels-histogram"></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 visualisation par histogramme calcule la distribution des valeurs et les présente sous forme de graphique à barres. L'axe Y et la hauteur de chaque barre représentent le nombre de valeurs comprises dans chaque fourchette, tandis que l'axe X représente la plage de valeurs.

![\[Image montrant un exemple de visualisation d'un histogramme dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/histogram-example.png)


## Formats pris en charge
<a name="v10-panels-histogram-formats"></a>

La visualisation par histogramme prend en charge les séries chronologiques et les résultats de tout tableau comportant un ou plusieurs champs numériques.

## Options d'affichage
<a name="v10-panels-histogram-options"></a>

Utilisez ces options pour affiner vos visualisations.

**Taille du seau**

La taille des seaux. Laissez ce champ vide pour le dimensionnement automatique du godet (\$1 10 % de la gamme complète).

**Déport du godet**

Si le premier bucket ne doit pas commencer à zéro. Un décalage différent de zéro décale la fenêtre d'agrégation. Par exemple, des compartiments de 5 tailles de 0 à 5, 5 à 10, 10 à 15 avec un décalage de 0 par défaut deviendraient des compartiments de 2 à 7, 7 à 12, 12 à 17 avec un décalage de 2 ; dans ce cas, des décalages de 0, 5 ou 10 ne serviraient en fait à rien. Généralement, cette option est utilisée avec une taille de compartiment définie de manière explicite plutôt qu'automatiquement. Pour que ce paramètre soit appliqué, le montant du décalage doit être supérieur à 0 et inférieur à la taille du compartiment ; les valeurs situées en dehors de cette plage auront le même effet que les valeurs comprises dans cette plage.

**Série Combine**

Cela fusionnera toutes les séries et tous les champs dans un histogramme combiné.

**Largeur de ligne**

Contrôle la largeur de ligne des barres.

**Opacité du remplissage**

Contrôle l'opacité de remplissage des barres.

**Mode dégradé**

Définissez le mode de remplissage du dégradé. Le dégradé de remplissage est basé sur la couleur de la ligne. Pour modifier la couleur, utilisez l'option de champ du jeu de couleurs standard. L'apparence du dégradé est influencée par le paramètre d'**opacité du remplissage**.
+  **Aucun — Aucun** remplissage en dégradé, il s'agit du paramètre par défaut.
+  **Opacité** — La transparence du dégradé est calculée en fonction des valeurs de l'axe Y. L'opacité du remplissage augmente avec les valeurs de l'axe Y.
+  **Teinte** — Le dégradé de couleur est généré en fonction de la teinte de la couleur de la ligne.

## Options de légende
<a name="v10-panels-histogram-legend"></a>

Lorsque l'option de légende est activée, elle peut afficher les mappages de valeurs ou les crochets de seuil. Pour afficher les mappages de valeurs dans la légende, il est important que l'option Jeu de couleurs des options standard soit définie sur Couleur unique ou Palette classique. Pour voir les parenthèses de seuil dans la légende, définissez le schéma de couleurs sur From threshold. Pour plus d'informations sur la légende, voir [Configurer une légende](v10-panels-configure-legend.md).

**Mode légende**

Utilisez ces paramètres pour définir le mode d'affichage de la légende dans votre visualisation.
+  **Liste** — Affiche la légende sous forme de liste. Il s'agit du mode d'affichage par défaut de la légende.
+  **Tableau** : affiche la légende sous forme de tableau.
+  **Masqué** : masque la légende.

**Placement des légendes**

Choisissez où placer la légende.
+  **En bas** — Sous le graphique.
+  **Droite** : à droite du graphique.

**Valeurs de légende**

Choisissez les calculs standard à afficher dans la légende. Tu peux en avoir plusieurs. Pour de plus amples informations, veuillez consulter [Types de calculs](v10-panels-calculation-types.md).

**Calculs de légendes**

Choisissez les calculs à afficher dans la légende. Vous pouvez en sélectionner plusieurs.

# Journaux
<a name="v10-panels-logs"></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 visualisation du panneau des journaux montre les lignes de journal issues de sources de données qui prennent en charge les journaux, telles qu'Elastic, Influx et Loki. Généralement, vous utilisez ce panneau à côté d'un panneau graphique pour afficher le résultat du journal d'un processus associé.

Le panneau des journaux affiche le résultat des requêtes saisies dans l'onglet **Requête**. Les résultats de plusieurs requêtes sont fusionnés et triés par ordre chronologique. Vous pouvez faire défiler le panneau si la source de données renvoie plus de lignes que ce qui peut être affiché.

Pour limiter le nombre de lignes affichées, vous pouvez utiliser le paramètre Nombre **maximum de points de données** dans les **options de requête**. Si elle n'est pas définie, la source de données applique généralement une limite par défaut.

## Niveau du journal
<a name="v10-panels-logs-level"></a>

Pour les journaux pour lesquels une étiquette de **niveau** est spécifiée, nous utilisons la valeur de l'étiquette pour déterminer le niveau de journalisation et actualiser la couleur en conséquence. Si aucune étiquette de niveau n'est spécifiée pour le journal, nous essayons de déterminer si son contenu correspond à l'une des expressions prises en charge (voir ci-dessous pour plus d'informations). Le niveau de journalisation est toujours déterminé par la première correspondance. Si Grafana n'est pas en mesure de déterminer un niveau de journalisation, celui-ci sera visualisé avec un niveau de journalisation **inconnu**. Pour de plus amples informations, veuillez consulter [Niveau de journalisation](v10-explore-logs.md#v10-explore-log-level).

## Détails du journal
<a name="v10-panels-logs-details"></a>

Chaque ligne de journal possède une zone extensible avec ses étiquettes et ses champs détectés, pour une interaction plus robuste. Chaque champ ou étiquette possède une icône de statistiques pour afficher les statistiques relatives à tous les journaux affichés.

**Liaisons de données**

En utilisant des liens de données, vous pouvez transformer n'importe quelle partie d'un message de journal en lien interne ou externe. Le lien créé est visible sous forme de bouton dans la section **Liens** de la vue des **détails du journal**.

**Options d'affichage**

Utilisez les paramètres suivants pour affiner votre visualisation :
+ **Heure** : affiche ou masque la colonne horaire. Il s'agit de l'horodatage associé à la ligne de journal tel qu'indiqué par la source de données.
+ **Étiquettes uniques** : affiche ou masque la colonne des étiquettes uniques, qui affiche uniquement les étiquettes non courantes.
+ **Étiquettes communes** : affiche ou masque les étiquettes communes
+ **Lignes d'enroulement** — Activez l'enroulement de lignes.
+ **Prettify JSON** — Définissez ce paramètre sur pour `true` afficher joliment tous les journaux JSON. Ce paramètre n'affecte pas les journaux dans un format autre que JSON.
+ **Activer les détails du journal** — Activez cette option pour afficher l'affichage des détails du journal pour chaque ligne du journal. Le paramètre par défaut est `true`.
+ **Ordre** : affiche les résultats par ordre chronologique décroissant ou croissant. La valeur par défaut est **Décroissant**, les journaux les plus récents étant affichés en premier. Réglez sur **Ascending** pour afficher les lignes de journal les plus anciennes en premier.

# Actualités
<a name="v10-panels-news"></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)

La visualisation des actualités affiche un flux RSS. Par défaut, il affiche les articles du blog de Grafana Labs, et les utilisateurs peuvent modifier cela en saisissant une autre URL de flux RSS.

Entrez l'URL d'un flux RSS dans la section **Affichage**. Ce type de visualisation n'accepte aucune autre requête, et les utilisateurs ne doivent pas s'attendre à pouvoir filtrer ou interroger les données du flux RSS de quelque manière que ce soit à l'aide de cette visualisation.

**Note**  
Les flux RSS sont chargés par le front-end de Grafana sans proxy. Par conséquent, seuls les flux RSS configurés avec les [en-têtes CORS appropriés seront chargés](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS). Si le flux RSS que vous essayez d'afficher ne se charge pas, pensez à le réhéberger ou à créer votre propre proxy.

# Graphe de nœuds
<a name="v10-panels-node-graph"></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 graphes de nœuds peuvent visualiser des graphes orientés ou des réseaux. Ils utilisent une disposition de force dirigée pour positionner efficacement les nœuds, afin de faciliter l'affichage de cartes d'infrastructure complexes, de hiérarchies ou de diagrammes d'exécution.

## Exigences relatives aux données
<a name="v10-panels-node-graph-requirements"></a>

Un graphe de nœuds nécessite une forme spécifique des données pour pouvoir afficher ses nœuds et ses arêtes. Ce graphique ne permet pas de visualiser toutes les sources de données ou requêtes. Si vous souhaitez l'utiliser en tant que développeur de sources de données, consultez la section sur l'API de données.

Un graphe de nœuds est composé de *nœuds* et d'*arêtes*.
+ Un *nœud* est affiché sous forme de cercle. Un nœud peut représenter une application, un service ou tout autre élément pertinent du point de vue de l'application.
+ Une *arête* est affichée sous la forme d'une ligne reliant deux nœuds. La connexion peut être une demande, une opération ou une autre relation entre les deux nœuds.

Les nœuds et les arêtes peuvent être associés à des métadonnées ou à des statistiques. La source de données définit les informations et les valeurs affichées, de sorte que les différentes sources de données peuvent afficher différents types de valeurs ou ne pas afficher certaines valeurs.

## Nœuds
<a name="v10-panels-node-graph-nodes"></a>

Habituellement, les nœuds affichent deux valeurs statistiques à l'intérieur du nœud et deux identifiants juste en dessous du nœud, généralement le nom et le type. Les nœuds peuvent également afficher un autre ensemble de valeurs sous la forme d'un cercle de couleur autour du nœud, avec des sections de couleurs différentes représentant différentes valeurs dont le total doit être égal à 1. Par exemple, le pourcentage d'erreurs peut être représenté par la partie rouge du cercle.

Des détails supplémentaires peuvent être affichés dans un menu contextuel, qui s'affiche lorsque vous choisissez le nœud. Le menu contextuel peut également contenir des liens supplémentaires qui peuvent cibler d'autres parties de l'espace de travail Grafana ou un lien externe.

**Note**  
Le graphe de nœuds ne peut afficher que 1 500 nœuds. Si cette limite est franchie, un avertissement est visible dans le coin supérieur droit et certains nœuds seront masqués. Vous pouvez développer les parties cachées du graphique en cliquant sur les marqueurs **Nœuds cachés** dans le graphique.

## Edges
<a name="v10-panels-node-graph-edges"></a>

Les arêtes peuvent également afficher des statistiques lorsque vous survolez les arêtes. Comme pour les nœuds, vous pouvez ouvrir un menu contextuel contenant des informations et des liens supplémentaires en choisissant le bord.

La première source de données prenant en charge cette visualisation est la source de AWS X-Ray données de sa fonctionnalité de carte de service. Pour de plus amples informations, veuillez consulter [Se connecter à une source AWS X-Ray de données](x-ray-data-source.md).

## Navigation dans le graphe de nœuds
<a name="v10-panels-node-graph-navigation"></a>

**Casserole**

Vous pouvez vous déplacer dans le graphe de nœuds en choisissant l'extérieur d'un nœud ou d'une arête et en faisant glisser le pointeur.

**Zoomer ou dézoomer**

Vous pouvez zoomer à l'aide des boutons situés dans le coin supérieur gauche du graphe de nœuds, ou à l'aide de la molette de la souris ou d'une autre saisie de défilement avec la touche `Ctrl` (ou`Cmd`).

**Explorez les nœuds cachés**

Le nombre de nœuds affichés à un moment donné est limité afin de maintenir des performances raisonnables. Les nœuds situés en dehors de cette limite sont cachés derrière des marqueurs sélectionnables qui indiquent un nombre approximatif de nœuds cachés connectés à cette arête. Vous pouvez choisir le marqueur pour développer le graphique autour de ce nœud.

**Vue de la grille**

Vous pouvez passer à la vue en grille pour avoir une meilleure vue d'ensemble des nœuds les plus intéressants du graphique. La vue en grille montre les nœuds dans une grille sans arêtes et peut être triée en fonction des statistiques affichées à l'intérieur du nœud ou des statistiques représentées par la bordure colorée des nœuds.

Pour trier les nœuds, choisissez les statistiques dans la légende. Le marqueur situé à côté du nom de la statistique (`˄`ou`˅`) indique la statistique actuellement utilisée pour le tri et la direction du tri.

Choisissez un nœud, puis sélectionnez l'option **Afficher dans le graphique** pour revenir à la mise en page graphique en mettant l'accent sur le nœud sélectionné, afin de l'afficher dans le contexte du graphique complet.

## API de données
<a name="v10-panels-node-graph-data-api"></a>

Cette visualisation nécessite une forme spécifique des données à renvoyer par la source de données afin de les afficher correctement.

Node Graph nécessite au minimum un bloc de données décrivant les arêtes du graphe. Par défaut, le graphe de nœuds calcule les nœuds et toutes les statistiques en fonction de cette trame de données. En option, une deuxième trame de données décrivant les nœuds peut être envoyée au cas où il serait nécessaire d'afficher davantage de métadonnées spécifiques aux nœuds. Vous devez définir `frame.meta.preferredVisualisationType = 'nodeGraph'` les deux blocs de données ou les nommer `nodes` et `edges` respectivement le rendu du graphe de nœuds.

**Données d'arêtes issues de la structure**

Champs obligatoires :


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| id | chaîne | Identifiant unique de l'arête. | 
| source | chaîne | ID du nœud source. | 
| cible | chaîne | Identifiant de la cible. | 

Champs facultatifs :


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| mainstat | chaîne/numéro | Première statistique affichée dans la superposition lorsque vous survolez le bord. Il peut s'agir d'une chaîne indiquant la valeur telle quelle ou d'un nombre. S'il s'agit d'un nombre, toute unité associée à ce champ est également affichée. | 
| stat secondaire | chaîne/numéro | Identique à MainStat, mais affiché juste en dessous. | 
| détail\$1\$1\$1 | chaîne/numéro | Tout champ préfixé par `detail__` sera affiché dans l'en-tête du menu contextuel lorsque vous cliquez sur le bord. `config.displayName`À utiliser pour une étiquette plus lisible par l'homme. | 

**Données des nœuds issues de la structure**

Champs obligatoires :


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| id | chaîne | Identifiant unique du nœud. Cet identifiant est référencé par arête dans ses champs source et cible. | 

Champs facultatifs :


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| title | chaîne | Nom du nœud visible juste en dessous du nœud. | 
| subtitle | chaîne | Identifiant supplémentaire, nom, type ou autre identifiant indiqué sous le titre. | 
| mainstat | chaîne/numéro | Première statistique affichée à l'intérieur du nœud lui-même. Il peut s'agir d'une chaîne indiquant la valeur telle quelle ou d'un nombre. S'il s'agit d'un nombre, toute unité associée à ce champ est également affichée.  | 
| stat secondaire | chaîne/numéro | Identique à MainStat, mais affiché en dessous à l'intérieur du nœud. | 
| arc\$1\$1\$1 | number | Tout champ préfixé par un `arc__` sera utilisé pour créer le cercle de couleur autour du nœud. La somme de toutes les valeurs de ces champs doit être égale à 1. Vous pouvez spécifier la couleur à l'aide de`config.color.fixedColor`. | 
| détail\$1\$1\$1 | chaîne/numéro | Tout champ préfixé par `detail__` sera affiché dans l'en-tête du menu contextuel lorsque vous cliquez sur le nœud. À utiliser `config.displayName` pour une étiquette plus lisible par l'homme. | 
| color | chaîne/numéro | Peut être utilisé pour spécifier une seule couleur au lieu d'utiliser les `arc__` champs pour spécifier des sections de couleur. Il peut s'agir d'une chaîne (il doit s'agir d'une chaîne de couleur HTML acceptable) ou d'un nombre, auquel cas le comportement dépend du `field.config.color.mode` paramètre. Cela peut être utilisé, par exemple, pour créer un dégradé de couleurs contrôlé par une valeur de champ. | 
| icon | chaîne | Nom de l'icône à afficher dans le nœud à la place des statistiques par défaut. Seules les icônes intégrées à Grafana sont autorisées (voir les icônes disponibles [ici](https://developers.grafana.com/ui/latest/index.html?path=/story/docs-overview-icon--icons-overview)). | 
| Rayon du nœud | number | Valeur du rayon en pixels. Utilisé pour gérer la taille des nœuds. | 
| surligné | Booléen | Définit si le nœud doit être surligné. Utilisez-le, par exemple, pour représenter un chemin spécifique dans le graphe en surlignant plusieurs nœuds et arêtes. La valeur par défaut est `false` . | 

# Graphique à secteurs
<a name="v10-panels-piechart"></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)

![\[Image illustrant un exemple de visualisation d'un graphique à secteurs dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/pie_chart_example.png)


Le graphique circulaire affiche les séries réduites, ou les valeurs d'une série, issues d'une ou de plusieurs requêtes, telles qu'elles sont liées les unes aux autres, sous la forme de tranches de gâteau. La longueur de l'arc, la surface et l'angle central d'une tranche sont tous proportionnels à la valeur des tranches, car ils se rapportent à la somme de toutes les valeurs. Il est préférable d'utiliser ce type de graphique lorsque vous souhaitez comparer rapidement un petit ensemble de valeurs sous une forme esthétique.

## Options de valeur
<a name="v10-panels-piechart-value"></a>

Utilisez les options suivantes pour affiner la valeur de votre visualisation.

**Afficher**

Choisissez la quantité d'informations à afficher.
+ **Calculer** — Réduit chaque valeur à une valeur unique par série.
+ **Toutes les valeurs** — Affiche toutes les valeurs d'une seule série.

**Calculs**

Sélectionnez un calcul pour réduire chaque série lorsque **Calculer** a été sélectionné. Pour plus d'informations sur les calculs disponibles, reportez-vous à la section [Types de calculs](v10-panels-calculation-types.md).

**Limite**

Lorsque vous affichez toutes les valeurs d'une seule série, cela limite le nombre de valeurs affichées.

**Champs**

Sélectionnez au moins un champ à afficher dans la visualisation. Le nom de chaque champ est disponible dans la liste, ou vous pouvez sélectionner l'une des options suivantes :
+ **Champs numériques** : tous les champs contenant des valeurs numériques.
+ **Tous les champs** : tous les champs qui ne sont pas supprimés par les transformations.
+ **Heure** : tous les champs contenant des valeurs temporelles.

## Options du graphique à secteurs
<a name="v10-panels-piechart-options"></a>

Utilisez ces options pour affiner l'apparence de votre visualisation.

**Type de graphique à secteurs**

Sélectionnez le style d'affichage du graphique à secteurs. Cela peut être soit :
+ **Pie** — Un diagramme circulaire standard
+ **Beignet** — Un diagramme circulaire percé d'un trou au milieu

**Etiquettes**

Sélectionnez les étiquettes à afficher sur le graphique circulaire. Vous pouvez en sélectionner plusieurs.
+ **Nom — Nom** de la série ou du champ.
+ **Pourcentage** — Le pourcentage de l'ensemble.
+ **Valeur** — La valeur numérique brute.

Les étiquettes sont affichées en blanc sur le corps du graphique par défaut. Vous pouvez sélectionner des couleurs de graphique plus foncées pour les rendre plus visibles. Les noms longs ou les chiffres peuvent être coupés.

**Mode infobulle**

Lorsque vous passez le curseur sur la visualisation, Grafana peut afficher des infobulles. Choisissez le comportement des infobulles.
+ **Unique** : l'infobulle affiche une seule série, celle que vous survolez dans la visualisation.
+ **Tout** — L'infobulle affiche toutes les séries de la visualisation. Grafana met en évidence la série que vous survolez en gras dans la liste des séries de l'infobulle.
+ **Masqué** : n'affiche pas l'infobulle lorsque vous interagissez avec la visualisation.

Utilisez un override pour masquer des séries individuelles dans l'infobulle.

## Options de légende
<a name="v10-panels-piechart-legend"></a>

Utilisez ces paramètres pour définir le mode d'affichage de la légende dans votre visualisation. Pour plus d'informations sur la légende, reportez-vous à la section [Configurer une légende](v10-panels-configure-legend.md).

**Visibilité des légendes**

Utilisez le bouton **Visibilité** pour afficher ou masquer la légende.

**Mode légende**

Définissez le mode d'affichage de la légende.
+ **Liste** — Affiche la légende sous forme de liste. Il s'agit du mode d'affichage par défaut de la légende.
+ **Tableau** : affiche la légende sous forme de tableau.

**Placement des légendes**

Choisissez où afficher la légende.
+ **En bas** — Sous le graphique.
+ **Droite** : à droite du graphique.

**Valeurs de légende**

Sélectionnez les valeurs à afficher dans la légende. Vous pouvez en sélectionner plusieurs.
+ **Pourcentage** — Le pourcentage de l'ensemble.
+ **Valeur** — La valeur numérique brute.

Pour plus d'informations sur la légende, reportez-vous à la section [Configurer une légende](v10-panels-configure-legend.md).

# Stat
<a name="v10-panels-stat"></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 statistiques indiquent une valeur de statistique élevée avec une ligne d'étincelle graphique optionnelle. Vous pouvez contrôler la couleur d'arrière-plan ou la couleur des valeurs à l'aide de seuils ou de dérogations.

![\[Image illustrant un exemple de visualisation de statistiques dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/stat_panel_example.png)


Par défaut, une statistique affiche l'un des éléments suivants :
+ Juste la valeur d'une seule série ou d'un seul champ.
+ La valeur et le nom de plusieurs séries ou champs.

Vous pouvez utiliser le **mode Texte** pour contrôler si le texte est affiché ou non.

## Réglage automatique de la disposition
<a name="v10-panels-stat-automatic-adjust"></a>

Le panneau ajuste automatiquement la disposition en fonction de la largeur et de la hauteur disponibles dans le tableau de bord. Il masque automatiquement le graphique (sparkline) si le panneau devient trop petit.

## Options de valeur
<a name="v10-panels-stat-value"></a>

Utilisez les options suivantes pour affiner la façon dont votre visualisation affiche la valeur :

**Afficher**

Choisissez la manière dont Grafana affiche vos données.
+ **Calculez**

  Afficher une valeur calculée en fonction de toutes les lignes.
  + **Calcul** — Sélectionnez une fonction de réduction que Grafana utilisera pour réduire de nombreux champs à une seule valeur. Pour obtenir la liste des calculs disponibles, consultez la section [Calculs standard](v10-panels-calculation-types.md).
  + **Champs** : sélectionnez les champs affichés dans la visualisation.
+ **Toutes les valeurs**

  Afficher une statistique distincte pour chaque ligne. Si vous sélectionnez cette option, vous pouvez également limiter le nombre de lignes à afficher.
  + **Limite** : nombre maximal de lignes à afficher. La valeur par défaut est 5 000.
  + **Champs** : sélectionnez les champs affichés dans la visualisation.

## Styles de statistiques
<a name="v10-panels-stat-styles"></a>

Donnez du style à votre visualisation.

**Orientation**

Choisissez une direction d'empilement.
+ **Auto** — Grafana sélectionne ce qu'il pense être la meilleure orientation.
+ **Horizontal** — Les barres s'étirent horizontalement, de gauche à droite.
+ **Vertical** — Les barres s'étirent verticalement de haut en bas.

**Mode texte**

Vous pouvez utiliser l'option Mode texte pour contrôler le texte affiché par la visualisation. Si la valeur n'est pas importante, seuls le nom et la couleur le sont, puis changez le **mode Texte en** **Nom**. La valeur sera toujours utilisée pour déterminer la couleur et est affichée dans une infobulle.
+ **Auto** : si les données contiennent plusieurs séries ou champs, indiquez à la fois le nom et la valeur.
+ **Valeur** — Afficher uniquement la valeur, jamais le nom. Le nom est plutôt affiché dans l'infobulle.
+ **Valeur et nom** : affichez toujours la valeur et le nom.
+ **Nom** : affiche le nom au lieu de la valeur. La valeur est affichée dans l'infobulle du pointeur.
+ **Aucun** — Ne rien afficher (vide). Le nom et la valeur sont affichés dans l'infobulle.

**Large mise en page**

Définissez si la mise en page large est activée ou non. La mise en page large est activée par défaut.
+ **Activé** — La mise en page large est activée.
+ **Désactivé** — La mise en page large est désactivée.

**Note**  
Cette option n'est applicable que lorsque **le mode texte** est défini sur **Valeur et nom**. Lorsque la mise en page large est activée, la valeur et le nom sont affichés side-by-side avec la valeur sur la droite, si le panneau est suffisamment large. Lorsque la mise en page large est désactivée, la valeur est toujours affichée sous le nom.

**Mode couleur**

Sélectionnez un mode couleur.
+ **Aucune** — Aucune couleur n'est appliquée à la valeur.
+ **Valeur** — Applique des couleurs à la valeur et à la zone du graphique.
+ **Dégradé d'arrière-plan** : applique de la couleur à la valeur, à la zone du graphique et à l'arrière-plan, avec un léger dégradé d'arrière-plan.
+ **Fond uni** : applique une couleur à la valeur, à la zone du graphique et à l'arrière-plan, avec une couleur d'arrière-plan unie.

**Mode graphique**

Sélectionnez un graphique et un mode Sparkline.
+ **Aucun** : masque le graphique et affiche uniquement la valeur.
+ **Zone** — Affiche le graphique en aires en dessous de la valeur. Cela nécessite que votre requête renvoie une colonne de temps.

**Alignement du texte**

Choisissez un mode d'alignement.
+ **Auto** — Si une seule valeur est affichée (pas de répétition), elle est centrée. Si plusieurs séries ou lignes sont affichées, la valeur est alignée à gauche.
+ **Centre** — La valeur de la statistique est centrée.

**Afficher le pourcentage de variation**

Définissez si le pourcentage de variation est affiché ou non. Par défaut, il n'est pas affiché.

**Note**  
Cette option n'est pas applicable lorsque le paramètre **Afficher**, sous **Options de valeur**, est défini sur **Toutes les valeurs**.

## Taille du texte
<a name="v10-panels-stat-textsize"></a>

Ajustez la taille du texte de la jauge.
+ **Titre** — Entrez une valeur numérique pour la taille du titre de la jauge.
+ **Valeur** — Entrez une valeur numérique pour la taille de la valeur de jauge.

# Chronologie de l'État
<a name="v10-panels-state-timeline"></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)

Les chronologies des États montrent les changements d'état discrets au fil du temps. Chaque champ ou série est affiché sous la forme d'une bande horizontale unique. Les régions d'État peuvent être affichées avec ou sans valeurs. Ce panneau fonctionne bien avec les chaînes ou les états booléens, mais peut également être utilisé avec des séries chronologiques. Lorsqu'ils sont utilisés avec des séries chronologiques, les seuils sont utilisés pour transformer les valeurs numériques en régions à états discrets.

![\[Image montrant un exemple de visualisation de la chronologie d'un État à Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/state_timeline_example.png)


## Options de chronologie de l'État
<a name="v10-panels-state-timeline-options"></a>

Utilisez les options suivantes pour affiner vos visualisations :

**Fusionner des valeurs consécutives égales**

Contrôle si Grafana fusionne des valeurs identiques si elles sont côte à côte.

**Afficher les valeurs**

Contrôle si les valeurs sont affichées dans les régions de l'État. **Auto** affichera les valeurs s'il y a suffisamment d'espace.

**Aligner les valeurs**

Contrôle l'alignement des valeurs dans les régions de l'État.

**Hauteur de ligne**

Contrôle l'espace entre les lignes. 1 = aucun espace = 0,5 = 50 % d'espace.

**Largeur de ligne**

Contrôle la largeur de ligne des régions de l'État.

**Opacité du remplissage**

Contrôle l'opacité des régions de l'État.

**Connecter des valeurs nulles**

Choisissez la façon dont les valeurs nulles, qui sont des lacunes dans les données, apparaissent sur le graphique. Les valeurs nulles peuvent être connectées pour former une ligne continue ou définies sur un seuil au-dessus duquel les lacunes dans les données ne sont plus connectées.
+ **Jamais** : les points de données des séries chronologiques présentant des lacunes dans les données ne sont jamais connectés.
+ **Toujours** — Les points de données des séries chronologiques présentant des lacunes dans les données sont toujours connectés.
+ **Seuil** — Spécifiez un seuil au-dessus duquel les lacunes dans les données ne sont plus connectées. Cela peut être utile lorsque les espaces connectés dans les données sont d'une taille connue ou se situent dans une plage connue, et que les espaces situés en dehors de cette plage ne doivent plus être connectés.

**Déconnecter les valeurs**

Choisissez si vous souhaitez définir un seuil au-dessus duquel les valeurs des données doivent être déconnectées.
+ **Jamais** : les points de données des séries chronologiques figurant dans les données ne sont jamais déconnectés.
+ **Seuil** — Spécifiez un seuil au-dessus duquel les valeurs des données sont déconnectées. Cela peut être utile lorsque les valeurs souhaitées dans les données sont d'une taille connue ou se situent dans une plage connue, et que les valeurs situées en dehors de cette plage ne doivent plus être connectées.

## Mappages de valeurs
<a name="v10-panels-state-timeline-valuemap"></a>

Pour attribuer des couleurs à des valeurs booléennes ou à des valeurs de chaîne, utilisez. [Configurer les mappages de valeurs](v10-panels-configure-value-mappings.md)

## Données de séries chronologiques avec seuils
<a name="v10-panels-state-timeline-threshold"></a>

La visualisation peut également être utilisée avec des données de séries chronologiques. Dans ce cas, les seuils sont utilisés pour transformer les séries chronologiques en régions d'états colorées discrètes.

## Options de légende
<a name="v10-panels-state-timeline-legend"></a>

Lorsque l'option de légende est activée, elle peut afficher les mappages de valeurs ou les crochets de seuil. Pour afficher les mappages de valeurs dans la légende, il est important que l'option Jeu de **couleurs** sous Options standard soit définie sur **Couleur unique** ou **Palette classique**. Pour voir les parenthèses de seuil dans la légende, définissez le **schéma de couleurs** sur **From** threshold.

**Mode légende**

Utilisez ces paramètres pour définir le mode d'affichage de la légende dans votre visualisation. Pour plus d'informations sur la légende, reportez-vous à la section [Configurer une légende](v10-panels-configure-legend.md).
+ **Liste** — Affiche la légende sous forme de liste. C'est le mode par défaut.
+ **Tableau** : affiche la légende sous forme de tableau.
+ **Masqué** : masque la légende.

**Placement des légendes**

Choisissez l'endroit où vous souhaitez afficher la légende.
+ **En bas** : en dessous du graphique.
+ **Droite** : à droite du graphique.

**Valeurs de légende**

Choisissez les [calculs standard](v10-panels-calculation-types.md) à afficher dans la légende. Tu peux en avoir plus d'un.

# Historique des statuts
<a name="v10-panels-status-history"></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)

L'historique des statuts montre les états périodiques au fil du temps. Chaque champ ou série est affiché sous forme de ligne horizontale. Les cases sont affichées et centrées autour de chaque valeur.

## Données prises en charge
<a name="v10-panels-status-history-supporteddata"></a>

L'historique des statuts fonctionne avec des chaînes de caractères, des champs booléens et numériques ou des séries chronologiques. Un champ horaire est obligatoire. Vous pouvez utiliser des mappages de valeurs pour colorer des chaînes ou affecter des valeurs de texte à des plages numériques.

## Options d'affichage
<a name="v10-panels-status-history-options"></a>

Utilisez ces options pour affiner la visualisation.

**Afficher les valeurs**

Contrôle si les valeurs sont affichées dans les cases de valeurs. **Auto** affichera les valeurs s'il y a suffisamment d'espace.

**Largeur de colonne**

Contrôle la largeur des cases. 1 = espace maximum et 0 = espace minimum.

**Largeur de ligne**

Contrôle la largeur de ligne des régions de l'État.

**Opacité du remplissage**

Contrôle l'opacité de remplissage des régions de l'État.

## Mappages de valeurs
<a name="v10-panels-status-history-valuemap"></a>

Pour attribuer des couleurs à des valeurs booléennes ou à des valeurs de chaîne, utilisez. [Configurer les mappages de valeurs](v10-panels-configure-value-mappings.md)

## Données de séries chronologiques avec seuils
<a name="v10-panels-status-history-threshold"></a>

Le panneau peut également être utilisé avec des données de séries chronologiques. Dans ce cas, les seuils sont utilisés pour colorer les cases. Vous pouvez également utiliser des modèles de dégradés pour colorer les valeurs.

## Options de légende
<a name="v10-panels-status-history-legend"></a>

Lorsque l'option de légende est activée, elle peut afficher les mappages de valeurs ou les crochets de seuil. Pour afficher les mappages de valeurs dans la légende, il est important que l'option Jeu de **couleurs** sous Options standard soit définie sur **Couleur unique** ou **Palette classique**. Pour voir les parenthèses de seuil dans la légende, définissez le **schéma de couleurs** sur **From** threshold.

**Mode légende**

Utilisez ces paramètres pour définir le mode d'affichage de la légende dans votre visualisation. Pour plus d'informations sur la légende, reportez-vous à la section [Configurer une légende](v10-panels-configure-legend.md).
+ **Liste** — Affiche la légende sous forme de liste. C'est le mode par défaut.
+ **Tableau** : affiche la légende sous forme de tableau.
+ **Masqué** : masque la légende.

**Placement des légendes**

Choisissez l'endroit où vous souhaitez afficher la légende.
+ **En bas** : en dessous du graphique.
+ **Droite** : à droite du graphique.

**Valeurs de légende**

Choisissez les [calculs standard](v10-panels-calculation-types.md) à afficher dans la légende. Tu peux en avoir plusieurs.

# Table
<a name="v10-panels-table"></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)

Les tables sont très flexibles et prennent en charge plusieurs modes pour les séries chronologiques et pour les tables, les annotations et les données JSON brutes. Cette visualisation fournit également des options de mise en forme de date, de mise en forme de valeur et de coloration.

![\[Image illustrant un exemple de visualisation de table dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/table_example.png)


**Note**  
Les annotations et les alertes ne sont pas prises en charge dans les tableaux.

## Colonne de tri
<a name="v10-panels-table-sort"></a>

Choisissez un titre de colonne pour faire passer l'ordre de tri par défaut à l'ordre décroissant puis croissant. Chaque fois que vous sélectionnez la colonne, l'ordre de tri passe à l'option suivante du cycle. Vous pouvez trier sur plusieurs colonnes en maintenant la `shift` touche enfoncée lorsque vous sélectionnez des colonnes supplémentaires.

## Options du tableau
<a name="v10-panels-table-options"></a>

**Afficher l'en-tête**

Afficher ou masquer les noms des colonnes importées depuis votre source de données.

## Largeur de colonne
<a name="v10-panels-table-width"></a>

Par défaut, Grafana calcule automatiquement la largeur de colonne en fonction de la taille du tableau et de la largeur de colonne minimale. Cette option de champ peut remplacer le paramètre et définir la largeur de toutes les colonnes en pixels.

Par exemple, si vous entrez`100`, toutes les colonnes seront définies sur une largeur de 100 pixels (le changement intervient lorsque vous quittez le champ).

## Largeur de colonne minimale
<a name="v10-panels-table-min"></a>

Par défaut, la largeur minimale de la colonne du tableau est de 150 pixels. Cette option de champ peut remplacer cette valeur par défaut et définira la nouvelle largeur de colonne minimale pour le panneau du tableau en pixels.

Par exemple, si vous définissez le minimum sur`75`, toutes les colonnes seront redimensionnées de manière à ce qu'elles ne soient pas inférieures à 75 pixels de large.

Pour les appareils à petit écran, tels que les smartphones ou les tablettes, vous pouvez réduire la valeur de `150` pixel par défaut pour permettre `50` aux panneaux basés sur des tableaux de s'afficher correctement dans les tableaux de bord.

## Alignement des colonnes
<a name="v10-panels-table-alignment"></a>

Choisissez comment Grafana doit aligner le contenu des cellules.
+ Auto (par défaut)
+ Left (Gauche)
+ Center
+ Right (Droite)

## Type de cellule
<a name="v10-panels-table-cell-type"></a>

Par défaut, Grafana choisit automatiquement les paramètres d'affichage. Vous pouvez annuler les paramètres en choisissant l'une des options suivantes pour définir la valeur par défaut pour tous les champs. Une configuration supplémentaire est disponible pour certains types de cellules.

**Note**  
Si vous les définissez dans l'onglet **Champ**, le type s'appliquera à tous les champs, y compris le champ horaire. Vous pouvez les définir dans l'onglet **Remplacer** pour appliquer la modification à un ou plusieurs champs.

**Texte en couleur**

Si des seuils sont définis, le texte du champ est affiché dans la couleur de seuil appropriée.

**Fond de couleur (dégradé ou uni)**

Si des seuils sont définis, l'arrière-plan du champ est affiché dans la couleur de seuil appropriée.

**Jauge**

Les cellules peuvent être affichées sous forme de jauge graphique, avec différents types de présentation.
+ *Basique* — Le mode de base affiche une jauge simple avec les niveaux de seuil définissant la couleur de la jauge.
+ *Dégradé* — Les niveaux de seuil définissent un dégradé.
+ *LCD* — La jauge est divisée en petites cellules allumées ou éteintes.

En outre, les étiquettes affichées à côté des jauges peuvent être configurées pour être colorées par valeur, correspondre à la couleur du texte du thème ou être masquées.
+ **Couleur de la valeur**
+ **Couleur du texte**
+ **Caché**

**Vue JSON**

Affiche la valeur formatée sous forme de code. Si une valeur est un objet, la vue JSON permettant de parcourir l'objet JSON apparaîtra au survol.

**Sparkline**

Affiche les valeurs affichées sous forme de sparkline. Nécessite une transformation des données [de séries chronologiques pour tabler](v10-panels-xform-functions.md#v10-panels-xform-funcs-series).

## Inspection de la valeur des cellules
<a name="v10-panels-table-cell-value"></a>

Permet d'inspecter les valeurs à partir des cellules du tableau. La valeur brute est présentée dans une fenêtre modale.

**Note**  
L'inspection de la valeur des cellules n'est disponible que lorsque le mode d'affichage des cellules est défini sur Auto, Texte en couleur, Couleur d'arrière-plan ou Vue JSON.

## Filtre à colonne
<a name="v10-panels-table-col-filter"></a>

Vous pouvez modifier temporairement le mode d'affichage des données des colonnes. Par exemple, vous pouvez classer les valeurs du plus élevé au plus bas ou masquer des valeurs spécifiques. Pour plus d'informations, voir [Filtrer les colonnes du tableau](#v10-panels-table-filter).

## Pagination
<a name="v10-panels-table-pagination"></a>

Utilisez cette option pour activer ou désactiver la pagination. Il s'agit d'une option frontale qui n'affecte pas les requêtes. Lorsque cette option est activée, le format de page s'adapte automatiquement à la hauteur du tableau.

## Filtrer les colonnes du tableau
<a name="v10-panels-table-filter"></a>

Si vous activez le **filtre de colonnes**, vous pouvez filtrer les options du tableau.

**Pour activer le filtrage des colonnes**

1. Dans Grafana, accédez au tableau de bord contenant le tableau contenant les colonnes que vous souhaitez filtrer.

1. Sur le panneau de tableau que vous souhaitez filtrer, ouvrez l'éditeur de panneaux.

1. Choisissez l'onglet **Champ**.

1. Dans les options du **tableau**, activez l'option **Filtre par colonne**.

Une icône de filtre (entonnoir) apparaît à côté du titre de chaque colonne.

**Valeurs des colonnes de filtre**

Pour filtrer les valeurs des colonnes, cliquez sur l'icône du filtre (entonnoir) à côté du titre d'une colonne. Grafana affiche les options de filtre pour cette colonne.

Cochez la case à côté des valeurs que vous souhaitez afficher. Entrez du texte dans le champ de recherche en haut pour afficher ces valeurs à l'écran afin de pouvoir les sélectionner plutôt que de faire défiler la page pour les trouver.

Sélectionnez l'un des différents opérateurs pour afficher les valeurs des colonnes :
+ **Contient** — Correspond à un modèle d'expression régulière (opérateur par défaut).
+ **Expression** — Évalue une expression booléenne. Le caractère `$` représente la valeur de colonne dans l'expression (par exemple,`$ >= 10 ≈& $ <= 12`).
+ **Opérateurs de comparaison** — Vous pouvez utiliser les opérateurs de comparaison classiques : `=``!=`,`<`,,`<=`,`>`,`>=`.

Cochez la case située au-dessus des boutons **Ok** et **Annuler** pour ajouter ou supprimer toutes les valeurs affichées dans le filtre.

**Effacer les filtres à colonne**

Les colonnes auxquelles des filtres sont appliqués ont un entonnoir bleu affiché à côté du titre.

Pour supprimer le filtre, choisissez l'icône en forme d'entonnoir bleu, puis sélectionnez **Effacer le filtre**.

## Pied de page du tableau
<a name="v10-panels-table-footer"></a>

Vous pouvez utiliser le pied de page du tableau pour afficher les [calculs sur les](v10-panels-calculation-types.md) champs.

Après avoir activé le pied de page du tableau, vous pouvez sélectionner le **calcul**, puis les **champs** que vous souhaitez calculer.

Le système applique le calcul à tous les champs numériques si vous ne sélectionnez aucun champ.

**Compter les lignes**

Si vous souhaitez afficher le nombre de lignes du jeu de données au lieu du nombre de valeurs dans les champs sélectionnés, sélectionnez le calcul du **nombre** et activez le calcul du **nombre de lignes**.

# Texte
<a name="v10-panels-text"></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)

Les visualisations de texte vous permettent d'inclure directement du texte ou du code HTML dans vos tableaux de bord. Cela peut être utilisé pour ajouter des informations contextuelles et des descriptions ou pour intégrer du code HTML complexe.

**Mode**

**Le mode** détermine le mode d'affichage du contenu intégré. Il propose les options suivantes :
+ **Markdown** — Cette option met en forme le contenu sous forme de markdown.
+ **HTML** — Ce paramètre affiche le contenu sous forme de code HTML épuré.
+ **Code** — Ce paramètre affiche le contenu dans un éditeur de code en lecture seule. Sélectionnez une langue appropriée pour appliquer un surlignage syntaxique au texte intégré.

**Variables**

Les variables du contenu seront étendues pour être affichées.

# Séries chronologiques
<a name="v10-panels-time-series"></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 image montrant des exemples de visualisations de séries chronologiques à Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/time_series_example.png)


Les visualisations de séries chronologiques constituent le principal moyen par défaut de visualiser les données de séries chronologiques sous forme de graphique. Ils peuvent afficher des séries sous forme de lignes, de points ou de barres. Ils sont suffisamment polyvalents pour afficher presque toutes les séries chronologiques.

**Note**  
Vous pouvez migrer les visualisations du panneau Graph vers des visualisations de séries chronologiques. Pour effectuer la migration, dans l'onglet **Panneau**, sélectionnez **Visualisation des séries chronologiques**. Grafana transfère tous les paramètres applicables.

**Topics**
+ [Options d'infobulle](v10-time-series-panel-tooltip.md)
+ [Options de légende](v10-time-series-panel-legend.md)
+ [Styles de graphes](v10-time-series-graph.md)
+ [Options d'axe](v10-time-series-axis.md)
+ [Options de couleur](v10-time-series-color.md)

# Options d'infobulle
<a name="v10-time-series-panel-tooltip"></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)

Les options d'infobulle contrôlent la superposition d'informations qui apparaît lorsque vous survolez des points de données dans le graphique.

**Mode infobulle**
+ **Unique** — L'infobulle montre n'affiche qu'une seule série, celle que vous survolez.
+ **Tout** — L'infobulle affiche toutes les séries de la visualisation. Grafana met en évidence la série que vous survolez en gras dans la liste des séries de l'infobulle.
+ **Masqué** : n'affiche pas l'infobulle lorsque vous interagissez avec la visualisation.

# Options de légende
<a name="v10-time-series-panel-legend"></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)

Les options de légende contrôlent les noms des séries et les statistiques qui apparaissent sous ou à droite du graphique.

**Mode légende**

Utilisez ces paramètres pour définir le mode d'affichage de la légende dans votre visualisation. Pour plus d'informations sur la légende, consultez[Configuration d'une légende](v10-panels-configure-legend.md).
+ **Liste** — Affiche la légende sous forme de liste. Il s'agit du mode d'affichage par défaut d'une légende.
+ **Tableau** : affiche la légende sous forme de tableau.
+ **Masqué** : masque la légende.

**Placement des légendes**

Choisissez l'endroit où vous souhaitez afficher la légende.
+ **En bas** : en dessous du graphique.
+ **Droite** : à droite du graphique.

**Valeurs de légende**

Choisissez le [calcul des normes](v10-panels-calculation-types.md) à afficher dans la légende. Tu peux en avoir plusieurs.

# Styles de graphes
<a name="v10-time-series-graph"></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)

Utilisez cette option pour définir le mode d'affichage des données de vos séries chronologiques. Vous pouvez utiliser des remplacements pour combiner plusieurs styles dans le même graphique.
+ **Lignes** : affiche la série chronologique sous forme de ligne sur un graphique.
+ **Barres** : affichez la série chronologique sous la forme d'une série de barres sur un graphique, une pour chaque point de données.
+ **Points** : affiche la série chronologique sous forme de points sur un graphique, un pour chaque point de données.

## Alignement des barres
<a name="v10-time-series-graph-bar"></a>

Définissez la position de la barre par rapport à un point de données où le point serait dessiné sur le graphique. Comme une barre a une largeur, elle peut être placée avant, après ou centrée sur le point. Les options disponibles pour cette option sont les suivantes :
+ ![\[An image showing a bar graph aligned before a point.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/bar-alignment-before.png)**Avant** — La barre est dessinée avant le point. Le point est placé dans le coin arrière de la barre.
+ ![\[An image showing a bar graph aligned around a point.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/bar-alignment-center.png)**Centre** — La barre est dessinée autour du point. Le point est placé au centre de la barre. Il s’agit de l’option par défaut.
+ ![\[An image showing a bar graph aligned after a point.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/bar-alignment-after.png)**Après** — La barre est dessinée après le point. Le point est placé dans le coin supérieur de la barre.

## Largeur de ligne
<a name="v10-time-series-graph-linewidth"></a>

La largeur de ligne est un curseur qui contrôle l'épaisseur des lignes de série ou le contour des barres.

## Opacité du remplissage
<a name="v10-time-series-graph-fill"></a>

Définit l'opacité d'une couleur de remplissage. Les remplissages sont utilisés, par exemple, pour montrer la zone située sous la ligne dans un graphique linéaire ou comme couleur des barres dans un graphique à barres.

## Mode dégradé
<a name="v10-time-series-graph-gradient"></a>

Le mode dégradé spécifie le remplissage du dégradé, qui est basé sur la couleur de la série. Pour modifier la couleur, utilisez l'option de champ du jeu de couleurs standard. Pour de plus amples informations, veuillez consulter [Schéma de couleurs](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme).

Les options du mode dégradé sont les suivantes :
+ **Aucun** — Aucun remplissage en dégradé. Il s’agit du paramètre par défaut.
+ **Opacité** : gradient d'opacité dans lequel l'opacité du remplissage augmente à mesure que les valeurs de l'axe Y augmentent.
+ **Teinte** : dégradé subtil basé sur la teinte de la couleur de la série.
+ **Schéma** : dégradé de couleurs défini par votre jeu de couleurs. Ce paramètre est utilisé pour la zone de remplissage et la ligne. Pour de plus amples informations, veuillez consulter [Options de couleur](v10-time-series-color.md).

L'apparence du dégradé est influencée par le paramètre d'**opacité du remplissage**.

## Afficher les points
<a name="v10-time-series-graph-showpoints"></a>

Vous pouvez configurer votre visualisation pour ajouter des points à des lignes ou à des barres, à l'aide des options suivantes.
+ **Auto** — Grafana détermine s'il faut afficher les points en fonction de la densité des données. Les points sont affichés lorsque la densité est faible.
+ **Toujours** — Les points sont affichés, quelle que soit la densité des données.
+ **Jamais** — Ne montrez pas de points.

## Taille du point
<a name="v10-time-series-graph-pointsize"></a>

Définit la taille des points, de 1 à 40 pixels de diamètre.

## Interpolation de lignes
<a name="v10-time-series-graph-interpolation"></a>

Choisissez la manière dont Grafana interpole la ligne de série.

![\[Image montrant différentes manières de tracer des lignes entre des points dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/line-interpolation.png)


Les options sont :
+ **Linéaire** — Les points sont reliés par des lignes droites.
+ **Lisse** — Les points sont reliés par des lignes courbes qui facilitent les transitions entre les points.
+ **Étape précédente** — La ligne est affichée sous forme de pas entre les points. Les points sont rendus à la fin de l'étape.
+ **Étape après** — La ligne est affichée sous forme de pas entre les points. Les points sont rendus au début de l'étape.

## Mise en forme des lignes
<a name="v10-time-series-graph-linestyle"></a>

Définissez le style de la ligne. Pour modifier la couleur, utilisez l'option de champ du jeu de couleurs standard.

Les choix de style de ligne sont les suivants :
+ **Solide** — Affiche une ligne continue. Il s’agit du paramètre par défaut.
+ **Dash** — Affiche une ligne en pointillés. Lorsque vous choisissez cette option, une liste apparaît pour vous permettre de sélectionner la longueur et l'écart (longueur, écart) des tirets de ligne. L'espacement des tirets est défini sur 10, 10 par défaut.
+ **Points** — Affiche les lignes en pointillés. Lorsque vous choisissez cette option, une liste apparaît pour vous permettre de sélectionner la longueur de l'intervalle pour l'espacement des points. L'espacement des points est défini sur 10 par défaut.

## Connecter des valeurs nulles
<a name="v10-time-series-graph-null"></a>

Choisissez la façon dont les valeurs nulles, qui sont des lacunes dans les données, apparaissent sur le graphique. Les valeurs nulles peuvent être connectées pour former une ligne continue ou définies sur un seuil au-dessus duquel les lacunes dans les données ne sont plus connectées.

Les options permettant de connecter des valeurs nulles sont les suivantes :
+ **Jamais** : les points de données des séries chronologiques présentant des lacunes dans les données ne sont jamais connectés.
+ **Toujours** — Les points de données des séries chronologiques présentant des lacunes dans les données sont toujours connectés.
+ **Seuil** — Spécifiez un seuil au-dessus duquel les lacunes dans les données ne sont plus connectées. Cela peut être utile lorsque les espaces connectés dans les données sont d'une taille connue ou se situent dans une plage connue, et que les espaces situés en dehors de cette plage ne doivent plus être connectés.

## Déconnecter les valeurs
<a name="v10-time-series-graph-disconnect"></a>

Choisissez si vous souhaitez ajouter un écart entre les valeurs des données dont le temps est supérieur à un seuil spécifié.

Les choix pour les valeurs de déconnexion sont les suivants :
+ **Jamais** : les points de données des séries chronologiques ne sont jamais déconnectés.
+ **Seuil** — Spécifiez un seuil au-dessus duquel les valeurs des données sont déconnectées. Cela peut être utile lorsque les valeurs souhaitées dans les données sont d'une taille connue ou se situent dans une plage connue, et que les valeurs situées en dehors de cette plage ne doivent plus être connectées.

## Série Stack
<a name="v10-time-series-graph-stack"></a>

*L'empilage* permet à Grafana d'afficher les séries les unes sur les autres. Soyez prudent lorsque vous utilisez l'empilement dans la visualisation, car cela peut facilement créer des graphiques trompeurs. Pour en savoir plus sur les raisons pour lesquelles l'empilage n'est peut-être pas la meilleure approche, reportez-vous à [La question de l'empilage](https://www.data-to-viz.com/caveat/stacking.html).

Les options d'empilage sont les suivantes :
+ **Désactivé** — Désactive l'empilage en série.
+ **Normal** — Les séries s'empilent les unes sur les autres.
+ **100 %** : cumul par pourcentage, la somme de toutes les séries étant égale à 100 %.

**Séries d'empilage en groupes**

Vous pouvez modifier le comportement d'empilement pour empiler les séries par groupes. Pour plus d'informations sur la création d'une dérogation, consultez[Configurer les remplacements de champs](v10-panels-configure-overrides.md).

**Pour empiler des séries en groupes**

1. Modifiez le panneau et choisissez **Remplacer**.

1. Créez une dérogation de champ pour l'option **Stack series**.

1. En mode empilage, sélectionnez **Normal.**

1. Nommez le groupe d'empilage dans lequel vous souhaitez que la série apparaisse.

   L'option de nom du groupe d'empilage n'est disponible que lorsque vous créez une dérogation.

## Remplissez le formulaire ci-dessous pour
<a name="v10-time-series-graph-fillbelow"></a>

L'option **Remplir ci-dessous pour** remplir la zone située entre deux séries. Cette option n'est disponible que sous forme de remplacement de série ou de champ.

Avec cette option, vous pouvez remplir la zone située entre deux séries, plutôt que de partir de la ligne de série jusqu'à 0. Par exemple, si vous avez deux séries appelées *Max* et *Min*, vous pouvez sélectionner la série *Max* et la remplacer par **Fill below** par la série *Min*. Cela ne remplirait que la zone située entre les deux lignes de série.

# Options d'axe
<a name="v10-time-series-axis"></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)

Les options de la catégorie d'axe modifient le mode de rendu des axes x et y. Certaines options ne prennent effet que lorsque vous cliquez en dehors de la zone d'options du champ que vous modifiez. Vous pouvez également appuyer sur`Enter`.

## Fuseau horaire
<a name="v10-time-series-axis-timezone"></a>

Définissez les fuseaux horaires souhaités à afficher le long de l'axe X.

## Placement
<a name="v10-time-series-axis-placement"></a>

Sélectionnez l'emplacement de l'axe Y. Les options sont :
+ **Auto** — Affecte automatiquement l'axe Y à la série. Lorsqu'il existe deux séries ou plus avec des unités différentes, Grafana assigne l'axe gauche à la première unité et l'axe droit aux unités suivantes.
+ **Gauche** — Affiche tous les axes Y sur le côté gauche.
+ **Droite** — Affiche tous les axes Y sur le côté droit.
+ **Masqué** : masque tous les axes.

Pour masquer les axes de manière sélective, [ajoutez un remplacement de champ qui](v10-panels-configure-overrides.md) cible des champs spécifiques.

## Étiquette
<a name="v10-time-series-axis-label"></a>

Définissez une étiquette de texte sur l'axe Y. Si vous avez plusieurs axes Y, vous pouvez attribuer différentes étiquettes à l'aide d'une dérogation.

## Width
<a name="v10-time-series-axis-width"></a>

Définissez une largeur fixe de l'axe. Par défaut, Grafana calcule dynamiquement la largeur d'un axe.

En définissant la largeur de l'axe, les données avec différents types d'axes peuvent partager les mêmes proportions d'affichage. Ce paramètre vous permet de comparer plus facilement les données de plusieurs graphiques, car les axes ne sont ni décalés ni étirés à proximité visuelle les uns des autres.

## Afficher les lignes de la grille
<a name="v10-time-series-axis-gridlines"></a>

Définissez la visibilité de la ligne de quadrillage de l'axe.
+ **Auto** : affiche automatiquement les lignes de la grille en fonction de la densité des données.
+ **Activé** : affiche toujours les lignes de la grille.
+ **Désactivé** — Ne jamais afficher les lignes de la grille.

## Couleur
<a name="v10-time-series-axis-color"></a>

Définissez la couleur de l'axe.
+ **Texte** — Définissez la couleur en fonction de la couleur du texte du thème.
+ **Série** — Définissez la couleur en fonction de la couleur de la série.

## Afficher la bordure
<a name="v10-time-series-axis-border"></a>

Définissez la visibilité de la bordure de l'axe.

## Échelle
<a name="v10-time-series-axis-scale"></a>

Définissez l'échelle des valeurs de l'axe Y.
+ **Linéaire** — Divise l'échelle en parties égales.
+ **Logarithmique** — Utilisez une échelle logarithmique. Lorsque vous sélectionnez cette option, une liste apparaît pour vous permettre de choisir une échelle logarithmique binaire (base 2) ou commune (base 10).
+ **Symlog** — Utilisez une échelle logarithmique symétrique. Lorsque vous sélectionnez cette option, une liste apparaît pour vous permettre de choisir une échelle logarithmique binaire (base 2) ou commune (base 10). L'option de seuil linéaire vous permet de définir le seuil à partir duquel l'échelle passe de linéaire à logarithmique.

## Zéro centré
<a name="v10-time-series-axis-centered"></a>

Définit l'axe Y pour qu'il soit centré sur zéro.

## Soft min et soft max
<a name="v10-time-series-axis-softminmax"></a>

Définissez une option **Soft min** ou **Soft Max** pour un meilleur contrôle des limites de l'axe Y. Par défaut, Grafana définit automatiquement la plage de l'axe Y en fonction du jeu de données.

Les paramètres soft min et soft max peuvent empêcher de petites variations dans les données d'être agrandies lorsqu'elles sont généralement plates. En revanche, les valeurs minimales et maximales strictes permettent de ne pas masquer les détails utiles des données en réduisant les pics intermittents au-delà d'un point spécifique.

Pour définir les limites strictes de l'axe Y, définissez les min/max options standard. Pour plus d'informations, reportez-vous à la section [Configurer les options standard](v10-panels-configure-standard-options.md).

## Transformation
<a name="v10-time-series-axis-transform"></a>

Utilisez cette option pour transformer les valeurs de série sans affecter les valeurs affichées dans l'infobulle, les menus contextuels ou la légende. Deux options de transformation s'offrent à vous :
+ **Transformation en Y négative** — Inverse les résultats en valeurs négatives sur l'axe Y.
+ **Constante** — Affiche la première valeur sous forme de ligne constante.

**Note**  
L'option de transformation n'est disponible qu'en tant que remplacement.

## Afficher plusieurs axes Y
<a name="v10-time-series-axis-multiple"></a>

Dans certains cas, vous souhaitez afficher plusieurs axes Y. Par exemple, si vous avez un jeu de données indiquant à la fois la température et l'humidité au fil du temps, vous pouvez afficher deux axes Y avec des unités différentes pour ces deux séries.

Pour afficher plusieurs axes Y, [ajoutez un remplacement de champ](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field). Suivez les étapes autant de fois que nécessaire pour ajouter autant d'axes Y que nécessaire.

# Options de couleur
<a name="v10-time-series-color"></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)

Par défaut, le graphique utilise l'option de [schéma de couleurs](v10-panels-configure-standard-options.md#v10-panels-standard-options-color-scheme) standard pour attribuer les couleurs des séries. Vous pouvez également utiliser la légende pour ouvrir le sélecteur de couleurs en sélectionnant l'icône de couleur de la série de légendes. Le réglage de la couleur de cette manière crée automatiquement une règle de remplacement qui définit une couleur spécifique pour une série spécifique.

Vous trouverez ci-dessous des options supplémentaires que vous pouvez utiliser pour remplacer les valeurs de couleur par défaut des séries.

## Palette classique
<a name="v10-time-series-color-classic"></a>

La configuration la plus courante consiste à utiliser la **palette classique** pour les graphiques. Ce schéma attribue automatiquement une couleur à chaque champ ou série en fonction de son ordre. Si l'ordre d'un champ change dans votre requête, la couleur change également. Vous pouvez configurer manuellement une couleur pour un champ spécifique à l'aide d'une règle de remplacement.

## Couleur unique
<a name="v10-time-series-color-single"></a>

Utilisez ce mode pour définir une couleur. Vous pouvez également sélectionner l'icône en forme de ligne colorée à côté de chaque série dans la légende pour ouvrir le sélecteur de couleurs. Cela crée automatiquement un nouveau remplacement qui définit le jeu de couleurs sur une seule couleur et la couleur sélectionnée.

## Schémas de couleurs par valeur
<a name="v10-time-series-color-byvalue"></a>

Si vous sélectionnez un jeu de couleurs par valeur, tel que **À partir des seuils (par valeur)** ou **Green-Yellow-Red (par valeur)**, l'option **Série de couleurs par** valeur apparaît. Cette option contrôle la valeur (Last, Min, Max) à utiliser pour attribuer sa couleur à la série.

## Mode dégradé du schéma
<a name="v10-time-series-color-gradient"></a>

L'option **Mode dégradé** située sous les **styles de graphique** possède un mode nommé **Schéma**. Lorsque vous activez **Schéma**, la ligne ou la barre reçoit un dégradé de couleur défini à partir du jeu de **couleurs** sélectionné.

**À partir des seuils**

Si le **schéma de couleurs** est défini sur À **partir des seuils (par valeur)** et **que le mode dégradé** est défini sur **Schéma**, la couleur de la ligne ou de la barre change lorsqu'elle franchit les seuils définis. Vous ne verrez que les couleurs exactes choisies dans le schéma.

**Schémas de couleurs dégradés**

L'utilisation d'un jeu de couleurs en **dégradé *sans* définir le mode dégradé** sur **Schéma** signifie que les couleurs choisies formeront un dégradé entre les couleurs choisies, à mesure que les valeurs de la série se déplacent entre les seuils définis.

# Suivis
<a name="v10-panels-traces"></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)

Les visualisations de traces vous permettent de suivre une demande au fur et à mesure qu'elle traverse les services de votre infrastructure. La visualisation des traces affiche les données des traces dans un diagramme qui vous permet de les interpréter facilement.

Pour plus d'informations sur les traces et leur utilisation, consultez la documentation suivante :
+ [Traçage dans Explore](v10-explore-tracing.md)
+ [Source de données Tempo](tempo-data-source.md)
+ [Commencer à utiliser Tempo](https://grafana.com/docs/tempo/latest/getting-started/) dans la documentation *Tempo de Grafana Labs*.

## Ajout d'un panneau avec des visualisations de traçage
<a name="v10-panels-traces-add"></a>

Une fois que les données de suivi sont disponibles dans votre stack Grafana, vous pouvez ajouter des panneaux de suivi à vos tableaux de bord Grafana.

L'utilisation d'une variable de tableau de bord vous permet de créer une requête pour afficher des traces spécifiques pour un ID de trace donné. `traceID` Pour plus d'informations sur les variables de tableau de bord, consultez la [documentation sur les variables](v10-dash-variables.md). 

**Conditions préalables**

Avant de commencer, vous avez besoin des éléments suivants :
+ Un espace de travail Grafana géré par Amazon.
+ Une [source de données Tempo](tempo-data-source.md) connectée à votre espace de travail.

Pour afficher et analyser les données de traces dans un tableau de bord, vous devez ajouter la visualisation des traces à votre tableau de bord et définir une requête à l'aide de l'éditeur de panneaux. La requête détermine les données affichées dans la visualisation. Pour plus d'informations sur l'éditeur de panneaux, reportez-vous à la [documentation de l'éditeur de panneaux](v10-panels-editor-overview.md).

Cette procédure utilise des variables et des modèles de tableau de bord pour vous permettre de saisir une trace IDs qui peut ensuite être visualisée. Vous allez utiliser une variable appelée `traceId` et l'ajouter en tant que modèle de requête.

**Pour ajouter une requête de visualisation des traces**

1. Dans votre espace de travail, créez un nouveau tableau de bord ou accédez à un tableau de bord existant dans lequel vous souhaitez ajouter des visualisations de traces.

1. Choisissez **Ajouter une visualisation** à partir d'un nouveau tableau de bord ou choisissez **Ajouter un panneau** sur un tableau de bord existant.

1. Sélectionnez la source de données de suivi appropriée.

1. **Dans le coin supérieur droit de l'éditeur de panneaux, choisissez l'onglet **Visualisations**, puis sélectionnez Traces.**

1. Dans les **options du panneau**, entrez un **titre** pour votre panneau de suivi. Pour plus d'informations sur l'éditeur de panneaux, voir[Configurer les options du panneau](v10-panels-configure-panel-options.md).

1. Dans l'éditeur de requêtes, sélectionnez l'onglet Type de requête **TraceQL**.

1.  Entrez `${traceId}` dans le champ de requête TraceQL pour créer une variable de tableau de bord. Cette variable est utilisée comme modèle de requête.

1. Choisissez **Appliquer** dans l'éditeur de panneau pour ajouter le panneau au tableau de bord.

1. Accédez aux **paramètres** du tableau de bord et ajoutez une nouvelle variable appelée`traceId`, de type variable **Custom**, en lui donnant une étiquette, si nécessaire. Choisissez **Appliquer** pour ajouter la variable au tableau de bord.

1. Vérifiez que le panneau fonctionne en utilisant un ID de trace valide pour la source de données utilisée pour le panneau de suivi et en modifiant l'ID dans la variable du tableau de bord.

## Ajout de TraceQL avec des visualisations de tables
<a name="v10-panels-traces-traceql"></a>

Bien que vous puissiez ajouter une visualisation de trace à un tableau de bord, il est fastidieux d'ajouter manuellement une trace IDs en tant que variable de tableau de bord. Il est plus utile de pouvoir utiliser des requêtes TraceQL pour rechercher des types de traces spécifiques, puis de sélectionner les traces appropriées parmi les résultats correspondants.

**Conditions préalables**

Cette procédure suppose que vous avez terminé la procédure précédente.

**Pour ajouter TraceQL avec des visualisations de tables**

1. Dans le tableau de bord où vous avez ajouté la visualisation de trace, choisissez **Ajouter un panneau** pour ajouter un nouveau panneau de visualisation.

1. Sélectionnez la même source de données de trace que celle que vous avez utilisée dans la section précédente.

1. **Dans le coin supérieur droit de l'éditeur de panneaux, sélectionnez l'onglet **Visualisations**, puis choisissez Table.**

1. Dans l'éditeur de requêtes, choisissez l'onglet **TraceQL**.

1. Dans les **options du panneau**, entrez un **titre** pour votre panneau de suivi.

1. Ajoutez une requête TraceQL appropriée pour rechercher les traces que vous souhaitez visualiser dans le tableau de bord. Par exemple, voici une requête statique simple provenant d'un serveur appelé*my-server*.

   ```
   { .service.name = "my-server" && .http.status_code=500 }
   ```

   Vous pouvez écrire la requête TraceQL sous forme de requête modèle pour tirer parti des autres variables du tableau de bord, si elles existent. Cela vous permet de créer des requêtes dynamiques basées sur ces variables.

Lorsque des résultats sont renvoyés par une requête, ils sont affichés dans le tableau du panneau.

Les résultats de la visualisation des traces incluent des liens vers la page **Explore** qui affiche la trace. Vous pouvez ajouter d'autres liens vers des traces dans le tableau qui renseignent la variable du `traceId` tableau de bord lorsqu'elle est sélectionnée, afin que la trace soit visualisée dans le même tableau de bord.

Pour créer un ensemble de liens de données dans le panneau, procédez comme suit.

**Pour utiliser une variable pour ajouter d'autres liens aux traces**

1. Dans le menu de droite, sous Liaisons de **données**, choisissez **Ajouter un lien**.

1. Ajoutez un **titre** pour le lien de données.

1. Trouvez le chemin d'accès au tableau de bord en consultant la barre d'adresse de votre navigateur lorsque le tableau de bord complet est affiché. Comme il s'agit d'un lien vers un tableau de bord de la même pile Grafana, seul le chemin du tableau de bord est requis.

   Par exemple, si votre chemin est :

   ```
   https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
   ```

   Le chemin d'accès au tableau de bord est alors le suivant :

   ```
   /d/1234abcd5/my-dashboard?orgId=1
   ```

1. Dans le champ **URL**, faites référence au tableau de bord qui contient les deux panneaux. Cette autoréférence utilise la valeur de la trace sélectionnée dans le tableau pour renseigner la variable du tableau de bord. Utilisez le chemin du tableau de bord indiqué à l'étape précédente, puis saisissez la valeur d'`traceId`utilisation des résultats sélectionnés dans la table TraceQL. L'ID de trace est exposé à l'aide du champ de `traceID` données dans les résultats renvoyés. Utilisez-le donc comme valeur pour la variable du tableau de bord. Par exemple :

   ```
   /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
   ```

1. Choisissez **Enregistrer** pour enregistrer le lien de données.

1. Choisissez **Appliquer** dans l'éditeur de panneaux pour appliquer le panneau au tableau de bord.

1. Enregistrez le tableau de bord.

Vous devriez maintenant voir une liste des traces correspondantes dans la visualisation du tableau. Lorsque vous sélectionnez les champs **TraceID** ou **SpanID**, vous pouvez soit ouvrir la page **Explore** pour visualiser la trace, soit suivre le lien de données, sélectionner un autre champ (tel que`Start time`, ou`Duration`) suit automatiquement le lien de données`Name`, en remplissant la variable du tableau de `traceId` bord, puis en affichant la trace correspondante dans le panneau de suivi. 

# Tendance
<a name="v10-panels-trend"></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)

Les visualisations de tendances doivent être utilisées pour les ensembles de données dont le X numérique séquentiel n'est pas le temps. Les graphiques fonctionnels, les rpm/torque courbes, les relations entre l'offre et la demande, ainsi que les diagrammes d'altitude ou de fréquence cardiaque le long d'un parcours de course (avec x comme distance ou durée depuis le départ) en sont des exemples.

Les visualisations de tendances prennent en charge tous les styles et options visuels disponibles dans la [visualisation des séries chronologiques](v10-panels-time-series.md), à l'exception des éléments suivants :
+ Pas d'annotations ni de zones temporelles
+ Aucun curseur (ou réticule) partagé
+ Pas de fuseaux horaires multiples sur l'axe X
+ Impossible de modifier la plage horaire du tableau de bord par glisser-sélectionner

**X Sélection du champ**

Utilisez cette option pour sélectionner un champ contenant des valeurs numériques croissantes.

 Par exemple, vous pouvez représenter la puissance et le couple du moteur par rapport à la vitesse, la vitesse étant tracée sur l'axe x et la puissance et le couple sur les axes y.

# Graphique XY
<a name="v10-panels-xychart"></a>

Les diagrammes XY permettent de visualiser des valeurs x et y arbitraires dans un graphique afin de pouvoir facilement montrer la relation entre deux variables. Les diagrammes XY sont généralement utilisés pour créer des nuages de points. Vous pouvez également les utiliser pour créer des graphiques à bulles, dans lesquels les valeurs des champs déterminent la taille de chaque bulle.

![\[Image illustrant un exemple de visualisation d'un graphique XY dans Grafana.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/viz/xy-chart-example.png)


## Formats de données pris en charge
<a name="v10-panels-xychart-formats"></a>

Vous pouvez utiliser n'importe quel type de données tabulaires comportant au moins deux champs numériques dans un graphique XY. Ce type de visualisation ne nécessite pas de données temporelles.

## Options du panneau
<a name="v10-panels-xychart-paneloptions"></a>

Dans la section **Options du panneau** du volet de l'éditeur de panneaux, vous définissez les options de base telles que le titre et la description du panneau. Vous pouvez également configurer des panneaux récurrents dans cette section. Pour de plus amples informations, veuillez consulter [Configurer les options du panneau](v10-panels-configure-panel-options.md).

## Options du graphique XY
<a name="v10-panels-xychart-options"></a>

**Cartographie des séries**

Définissez la manière dont les données de série sont mappées dans le graphique.
+ **Auto** : génère automatiquement des séries à partir de tous les blocs de données (ou ensembles de données) disponibles. Vous pouvez filtrer pour ne sélectionner qu'un seul cadre.
+ **Manuel** — Définissez explicitement la série en la sélectionnant parmi les trames de données disponibles.

En fonction de votre sélection de mappage de série, les options **Frame**, **X-field** et **Y-field diffèrent**. Les sections de mappage des séries Auto et Manuel décrivent ces différentes options.

**Options de mappage automatique des séries**

Lorsque vous sélectionnez **Auto** comme mode de mappage de séries, les options suivantes sont préconfigurées, mais vous pouvez également les définir vous-même.
+ **Cadre** — Par défaut, un graphique XY affiche tous les blocs de données. Vous pouvez filtrer pour ne sélectionner qu'un seul cadre.
+ **Champ X** — Sélectionnez le champ que X représente. Par défaut, il s'agit du premier champ numérique de chaque bloc de données.
+ **Champ Y** — Une fois le champ X défini, tous les champs numériques restants du bloc de données sont désignés par défaut comme champs Y. Vous pouvez utiliser cette option pour choisir explicitement les champs à utiliser pour Y.

  Les séries du graphique sont générées à partir des champs Y. Pour modifier une série dans un graphique XY, remplacez le champ Y. Aucun champ que vous utilisez dans le champ Taille ou Couleur ne génère de série.

  Vous pouvez également utiliser des remplacements pour exclure les champs Y individuellement. Pour ce faire, ajoutez une dérogation avec les propriétés suivantes pour chaque champ Y que vous souhaitez supprimer :
  + Type de remplacement : **champs avec nom**
  + Propriété de remplacement : **Série > Masquer dans la zone**
  + Région : **Viz**

**Options de mappage manuel des séries**

Lorsque vous sélectionnez **Manuel** comme mode série, vous pouvez ajouter, modifier et supprimer des séries. Pour gérer une série, sélectionnez le champ **Série**. Pour renommer la série, sélectionnez le nom de la série.

En mode **manuel**, vous devez définir les options suivantes :
+ **Cadre** : sélectionnez votre bloc de données ou votre jeu de données. Vous pouvez ajouter autant de cadres que vous le souhaitez.
+ **Champ X** — Sélectionnez le champ que X représente.
+ **Champ Y** — Sélectionnez le champ Y représenté.

**Champ de taille**

Utilisez cette option pour définir les valeurs des champs qui contrôlent la taille du point dans le graphique. Cette valeur est relative au minimum et au maximum de toutes les valeurs du bloc de données.

Lorsque vous sélectionnez cette option, vous pouvez ensuite définir les options de taille minimale et maximale en points.

**Champ de couleur**

Utilisez cette option pour définir les valeurs des champs qui contrôlent la couleur des points du graphique. Pour utiliser les options de valeur de couleur dans les **options Standard**, vous devez définir ce champ.

Généralement, cette option est utilisée lorsque vous n'avez qu'une seule série affichée dans le graphique.

**Afficher**

Définissez la manière dont les valeurs sont représentées dans la visualisation.
+ **Points** : affiche les valeurs sous forme de points. Lorsque vous sélectionnez cette option, l'option de taille en points s'affiche également.
+ **Lignes** — Ajoutez une ligne entre les valeurs. Lorsque vous sélectionnez cette option, les options de style de ligne et de largeur de ligne sont également affichées.
+ **Les deux** : affiche à la fois les points et les lignes.

**Taille du point**

Définit la taille de tous les points du graphique, d'un à 100 pixels de diamètre. La taille par défaut est de cinq pixels. Vous pouvez définir une dérogation pour définir la taille des pixels par série (champ Y).

**Taille de points min/max**

Utilisez ces options pour contrôler la taille minimale ou maximale en points lorsque vous avez défini l'option de **champ Taille**. Vous pouvez annuler ces options pour des séries spécifiques.

**Mise en forme des lignes**

Définissez le style de la ligne. Pour modifier la couleur, utilisez l'option de champ du jeu de couleurs standard.
+ **Solide** — Affiche une ligne continue. Il s’agit du paramètre par défaut.
+ **Dash** — Affiche une ligne en pointillés. Lorsque vous choisissez cette option, une liste déroulante s'affiche dans laquelle vous pouvez sélectionner le paramètre de longueur et d'écart pour les tirets de ligne. Par défaut, la longueur et l'écart sont définis sur`10, 10`.
+ **Points** — Affiche les lignes en pointillés. Lorsque vous choisissez cette option, une liste déroulante s'affiche dans laquelle vous pouvez sélectionner l'espacement des points. Par défaut, l'espacement des points est défini sur `0, 10` (le premier chiffre représente la longueur du point et est toujours égal à zéro).

**Largeur de ligne**

Définit la largeur des lignes, en pixels.

## Options d'infobulle
<a name="v10-panels-xychart-tooltipoptions"></a>

Les options d'infobulle contrôlent la superposition d'informations qui apparaît lorsque vous survolez des points de données dans le graphique.

**Mode infobulle**
+ **Unique** — L'infobulle montre n'affiche qu'une seule série, celle que vous survolez.
+ **Masqué** : n'affiche pas l'infobulle lorsque vous interagissez avec la visualisation.

Utilisez un override pour masquer des séries individuelles dans l'infobulle.

**Hauteur maximale**

Définissez la hauteur maximale de la boîte d'infobulle. La valeur par défaut est de 600 pixels.

## Options de légende
<a name="v10-panels-xychart-legendoptions"></a>

Les options de légende contrôlent les noms des séries et les statistiques qui apparaissent sous ou à droite du graphique. Pour plus d'informations sur la légende, consultez[Configuration d'une légende](v10-panels-configure-legend.md).

**Visibilité**

Activez ou désactivez le bouton pour activer ou désactiver la légende.

**Mode**

Utilisez ces paramètres pour définir le mode d'affichage de la légende dans votre visualisation.
+ **Liste** — Affiche la légende sous forme de liste. Il s'agit du mode d'affichage par défaut d'une légende.
+ **Tableau** : affiche la légende sous forme de tableau.

**Placement**

Choisissez l'endroit où vous souhaitez afficher la légende.
+ **En bas** : en dessous du graphique.
+ **Droite** : à droite du graphique.

**Valeurs**

Choisissez les [calculs standards](v10-panels-calculation-types.md) à afficher dans la légende. Tu peux en avoir plusieurs.

**Width (Largeur)**

Contrôlez la largeur de la légende lorsqu'elle est placée sur le côté droit de la visualisation. Cette option n'est affichée que si vous définissez le placement de la légende sur **Droite**.

## Options d'axe
<a name="v10-panels-xychart-axis"></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)

Les options de la catégorie d'axe modifient le mode de rendu des axes x et y. Certaines options ne prennent effet que lorsque vous cliquez en dehors de la zone d'options du champ que vous modifiez. Vous pouvez également appuyer sur`Enter`.

**Placement (axe Y)**

Sélectionnez l'emplacement de l'axe Y. Les options sont :
+ **Auto** — Affecte automatiquement l'axe Y à la série. Lorsqu'il existe deux séries ou plus avec des unités différentes, Grafana assigne l'axe gauche à la première unité et l'axe droit aux unités suivantes.
+ **Gauche** — Affiche tous les axes Y sur le côté gauche.
+ **Droite** — Affiche tous les axes Y sur le côté droit.
+ **Masqué** : masque tous les axes.

Pour masquer les axes de manière sélective, [ajoutez un remplacement de champ qui](v10-panels-configure-overrides.md) cible des champs spécifiques.

**Étiquette**

Définissez une étiquette de texte sur l'axe Y. Si vous avez plusieurs axes Y, vous pouvez attribuer différentes étiquettes à l'aide d'une dérogation.

**Width (Largeur)**

Définissez une largeur fixe de l'axe. Par défaut, Grafana calcule dynamiquement la largeur d'un axe.

En définissant la largeur de l'axe, les données avec différents types d'axes peuvent partager les mêmes proportions d'affichage. Ce paramètre vous permet de comparer plus facilement les données de plusieurs graphiques, car les axes ne sont ni décalés ni étirés à proximité visuelle les uns des autres.

**Afficher les lignes de la grille**

Définissez la visibilité de la ligne de quadrillage de l'axe.
+ **Auto** : affiche automatiquement les lignes de la grille en fonction de la densité des données.
+ **Activé** : affiche toujours les lignes de la grille.
+ **Désactivé** — Ne jamais afficher les lignes de la grille.

**Color (Couleur)**

Définissez la couleur de l'axe.
+ **Texte** — Définissez la couleur en fonction de la couleur du texte du thème.
+ **Série** — Définissez la couleur en fonction de la couleur de la série.

**Afficher la bordure**

Définissez la visibilité de la bordure de l'axe.

**Évolutivité**

Définissez l'échelle des valeurs de l'axe Y.
+ **Linéaire** — Divise l'échelle en parties égales.
+ **Logarithmique** — Utilisez une échelle logarithmique. Lorsque vous sélectionnez cette option, une liste apparaît pour vous permettre de choisir une échelle logarithmique binaire (base 2) ou commune (base 10).
+ **Symlog** — Utilisez une échelle logarithmique symétrique. Lorsque vous sélectionnez cette option, une liste apparaît pour vous permettre de choisir une échelle logarithmique binaire (base 2) ou commune (base 10). L'option de seuil linéaire vous permet de définir le seuil à partir duquel l'échelle passe de linéaire à logarithmique.

*Zéro centré*

Définit l'axe Y pour qu'il soit centré sur zéro.

**Soft min et soft max**

Définissez une option **Soft min** ou **Soft Max** pour un meilleur contrôle des limites de l'axe Y. Par défaut, Grafana définit automatiquement la plage de l'axe Y en fonction du jeu de données.

Les paramètres soft min et soft max peuvent empêcher de petites variations dans les données d'être agrandies lorsqu'elles sont généralement plates. En revanche, les valeurs minimales et maximales strictes permettent de ne pas masquer les détails utiles des données en réduisant les pics intermittents au-delà d'un point spécifique.

Pour définir les limites strictes de l'axe Y, définissez les min/max options standard. Pour plus d'informations, reportez-vous à la section [Configurer les options standard](v10-panels-configure-standard-options.md).

**Transform**

Utilisez cette option pour transformer les valeurs de série sans affecter les valeurs affichées dans l'infobulle, les menus contextuels ou la légende. Deux options de transformation s'offrent à vous :
+ **Transformation en Y négative** — Inverse les résultats en valeurs négatives sur l'axe Y.
+ **Constante** — Affiche la première valeur sous forme de ligne constante.

**Note**  
L'option de transformation n'est disponible qu'en tant que remplacement.

**Afficher plusieurs axes Y**

Dans certains cas, vous souhaitez afficher plusieurs axes Y. Par exemple, si vous disposez d'un jeu de données indiquant à la fois la température et l'humidité au fil du temps, vous pouvez afficher deux axes Y avec des unités différentes pour ces deux séries.

Pour afficher plusieurs axes Y, [ajoutez un remplacement de champ](v10-panels-configure-overrides.md#v10-panels-overrides-add-a-field). Suivez les étapes autant de fois que nécessaire pour ajouter autant d'axes Y que nécessaire.

## Options standard
<a name="v10-panels-xychart-standard"></a>

**Les options standard** de l'éditeur de panneaux vous permettent de modifier le mode d'affichage des données de champ dans votre visualisation. Lorsque vous définissez une option standard, la modification est appliquée à tous les champs ou séries. Pour un contrôle plus précis de l'affichage des champs, reportez-vous à[Configurer les remplacements de champs](v10-panels-configure-overrides.md).

Vous pouvez personnaliser les options standard suivantes :
+ **Champ min/max** — Activez **le champ min/max pour** que Grafana calcule le minimum ou le maximum de chaque champ individuellement, en fonction de la valeur minimale ou maximale du champ.
+ **Jeu de couleurs** : définissez une ou plusieurs couleurs pour l'ensemble de votre visualisation.

Pour de plus amples informations, veuillez consulter [Configuration des options standard](v10-panels-configure-standard-options.md).

## Liaisons de données
<a name="v10-panels-xychart-datalinks"></a>

Les liens de données vous permettent de créer des liens vers d'autres panneaux, tableaux de bord et ressources externes tout en conservant le contexte du panneau source. Vous pouvez créer des liens qui incluent le nom de la série ou même la valeur située sous le curseur.

Pour chaque liaison de données, définissez les options suivantes :
+ **Titre**
+ **URL**
+ **Ouvrir dans un nouvel onglet**

Pour de plus amples informations, veuillez consulter [Configuration des liaisons de données](v10-panels-configure-data-links.md).

## Dérogations de champs
<a name="v10-panels-xychart-fieldoverrides"></a>

Les remplacements vous permettent de personnaliser les paramètres de visualisation pour des champs ou des séries spécifiques. Lorsque vous ajoutez une règle de remplacement, vous pouvez cibler un ensemble particulier de champs et définir plusieurs options pour l'affichage de ces champs.

Choisissez l'une des options de remplacement suivantes :
+ **Champs avec nom** — Sélectionnez un champ dans la liste de tous les champs disponibles.
+ **Champs dont le nom correspond à une expression régulière** : spécifiez les champs à remplacer par une expression régulière.
+ **Champs avec type** : sélectionnez les champs par type, par exemple chaîne, numérique ou heure.
+ **Champs renvoyés par requête** — Sélectionnez tous les champs renvoyés par une requête spécifique.
+ **Champs contenant des valeurs** : sélectionnez tous les champs renvoyés par la condition de réduction que vous avez définie, tels que **Min**, **Max**, **Count** ou **Total**.

Pour de plus amples informations, veuillez consulter [Configurer les remplacements de champs](v10-panels-configure-overrides.md).

# Explorez dans la version 10 de Grafana
<a name="v10-explore"></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)

L'interface utilisateur du tableau de bord de Grafana fournit des fonctionnalités permettant de créer des tableaux de bord à des fins de visualisation. *Explore* supprime les options du tableau de bord et du panneau afin que vous puissiez vous concentrer sur la requête. Il vous permet d'itérer jusqu'à obtenir une requête fonctionnelle, puis de créer un tableau de bord à partir de cette requête.

**Note**  
Si vous souhaitez simplement explorer vos données et ne souhaitez pas créer de tableau de bord, Explore vous facilite grandement la tâche. Si votre source de données prend en charge les données graphiques et tabulaires, Explore affiche les résultats sous forme de graphique et de tableau. Cela vous permet de voir les tendances des données et de voir plus de détails en même temps.

Cette page vous permettra de commencer à explorer vos données. Les rubriques suivantes fournissent des informations supplémentaires sur les fonctionnalités et utilisations spécifiques d'Explore.
+ [Gestion des requêtes dans Explore](v10-explore-manage.md)
+ [Se connecte Explore](v10-explore-logs.md)
+ [Traçage dans Explore](v10-explore-tracing.md)
+ [Éditeur de corrélations dans Explore](v10-explore-correlations.md)
+ [Inspector dans Explore](v10-explore-inspector.md)

## Commencez à explorer
<a name="v10-explore-start"></a>

**Note**  
Pour accéder à Explore, vous devez avoir un rôle d'éditeur ou d'administrateur.

**Pour accéder à Explore**

1. Dans votre espace de travail Grafana, choisissez l'élément de menu Explore dans la barre de menu de gauche.

   Un onglet Explore vide s'ouvre.

   Sinon, pour commencer avec une requête existante dans un panneau, choisissez l'option Explorer dans le menu Panneau. Cela ouvre un onglet Explore contenant la requête du panneau et vous permet de modifier ou d'itérer la requête en dehors de votre tableau de bord.

1. Choisissez votre source de données dans le menu déroulant en haut à gauche.

   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 (pour les administrateurs uniquement).

1. Rédigez la requête à l'aide de l'éditeur de requêtes fourni par la source de données sélectionnée.

   Pour plus de détails sur les requêtes, consultez[Interrogez et transformez les données](v10-panels-query-xform.md).

1. Exécutez la requête à l'aide du bouton situé dans le coin supérieur droit.

## Divisez et comparez
<a name="v10-explore-compare"></a>

La vue divisée permet de comparer facilement des visualisations side-by-side ou de consulter des données associées sur une seule page.

**Ouvrez la vue divisée en haut**

1. Dans la vue Explorer, cliquez sur le bouton **Diviser** pour dupliquer la requête en cours et diviser la page en deux side-by-side requêtes.
**Note**  
Il est possible de sélectionner une autre source de données pour la nouvelle requête, ce qui vous permet, par exemple, de comparer la même requête pour deux serveurs différents ou de comparer l'environnement de préparation à l'environnement de production.

   Dans la vue partagée, les sélecteurs des deux panneaux peuvent être liés (si vous modifiez l'un, l'autre sera également modifié) en sélectionnant un bouton de synchronisation horaire attaché à l'un des sélecteurs. La liaison de timepickers permet de synchroniser les heures de début et de fin des requêtes en vue partagée. Cela garantit que vous examinez le même intervalle de temps dans les deux panneaux divisés.

1. Pour fermer la requête nouvellement créée, cliquez sur le bouton **Fermer le partage**.

## Aperçu du contenu
<a name="v10-explore-outline"></a>

L'aperçu du contenu est une barre de navigation latérale qui permet de suivre les requêtes et les visualisations que vous avez créées dans Explore. Cela vous permet de naviguer rapidement entre eux.

L'aperçu du contenu fonctionne également dans une vue divisée. Lorsque vous êtes en mode partagé, le plan du contenu est généré pour chaque volet.

**Pour ouvrir le plan du contenu**

1. Sélectionnez le bouton **Plan** dans le coin supérieur gauche de l'écran d'**exploration**.

1. Sélectionnez n'importe quelle icône de panneau dans le plan du contenu pour accéder à ce panneau.

## Partagez et explorez URLs
<a name="v10-explore-shareurl"></a>

Lorsque vous utilisez Explore, l'URL de la barre d'adresse du navigateur est mise à jour à mesure que vous modifiez les requêtes. Vous pouvez partager ou ajouter cette URL à vos favoris.

**Note**  
L'exploration peut être relativement longue URLs. Vous pouvez également générer et partager un [lien abrégé](#v10-explore-share) si l'URL est trop longue pour vos outils.

**Génération d'Explore URLs à partir d'outils externes**

Explore URLs ayant une structure définie, vous pouvez créer une URL à partir d'outils externes et l'ouvrir dans Grafana. La structure de l'URL est la suivante :

```
http://<workspace_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>
```

où :
+ `org_id`est l'identifiant de l'organisation
+ `schema_version`est la version du schéma (doit être définie sur la dernière version, qui est`1`.
+ `panes`est un objet JSON de volets codé en URL, où chaque clé est l'ID du volet et chaque valeur est un objet correspondant au schéma suivant :

  ```
  {
    datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
    queries: {
      refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
      datasource: {
        uid: string; // the query's datasource UID ie: "AD7864H6422"
        type: string; // the query's datasource type-id, i.e: "loki"
      }
      // ... any other datasource-specific query parameters
    }[]; // array of queries for this pane
    range: {
      from: string; // the start time, in milliseconds since epoch
      to: string; // the end time, in milliseconds since epoch
    }
  }
  ```
**Note**  
Les `to` champs `from` et acceptent également les plages relatives, comme décrit dans la [Configuration de la plage horaire du tableau de bord](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) rubrique.

## Partager le lien raccourci
<a name="v10-explore-share"></a>

La fonctionnalité Partager des liens raccourcis vous permet de créer des liens plus petits et plus simples URLs au format /goto/:uid au lieu d'utiliser des paramètres de requête plus longs. URLs Pour créer un lien raccourci vers les résultats de la requête, sélectionnez l'option **Partager** dans la barre d'outils Explore. Un lien abrégé qui n'est jamais utilisé sera automatiquement supprimé au bout de sept (7) jours. Si un lien est utilisé au moins une fois, il ne sera pas supprimé.

**Partage de liens raccourcis en temps absolu**

Les liens courts ont deux options : conserver l'heure relative (par exemple, entre deux heures et l'heure actuelle) ou l'heure absolue (par exemple, entre 8 h et 10 h). Le partage d'un lien raccourci par défaut copiera la plage de temps sélectionnée, relative ou absolue. En cliquant sur le bouton déroulant situé à côté du bouton Partager le lien abrégé et en sélectionnant l'une des options sous **Synchronisation temporelle des liens URL**, vous pouvez créer un lien court avec l'heure absolue, ce qui signifie que toute personne recevant le lien verra les mêmes données que vous, même si elle ouvre le lien à un autre moment. Cette option n'affectera pas la plage de temps sélectionnée dans votre vue Explore.

# Gestion des requêtes dans Explore
<a name="v10-explore-manage"></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 gérer les requêtes que vous avez créées dans Explore, y compris l'historique des requêtes que vous avez exécutées et des requêtes auxquelles vous avez ajouté des favoris.

## Historique des requêtes
<a name="v10-explore-manage-history"></a>

L'historique des requêtes est une liste des requêtes que vous avez utilisées dans Explore. L'historique est stocké dans la base de données Grafana et n'est pas partagé avec d'autres utilisateurs. La période de conservation des requêtes dans l'historique est de deux semaines. Les requêtes datant de plus de deux semaines sont automatiquement supprimées. Pour ouvrir votre historique et interagir avec celui-ci, sélectionnez le bouton **Historique des requêtes** dans Explore.

**Note**  
Les requêtes marquées d'un astérisque (mises en favoris) ne sont pas soumises à la période de conservation de deux semaines et ne sont pas supprimées.

## Afficher l'historique des requêtes
<a name="v10-explore-manage-history-view"></a>

L'historique des requêtes vous permet de consulter l'historique de vos requêtes. Pour chaque requête individuelle, vous pouvez :
+ Exécutez la requête.
+ Créez et and/or modifiez un commentaire.
+ Copiez une requête dans le presse-papiers.
+ Copiez un lien abrégé contenant la requête dans le presse-papiers.
+ Ajoutez une requête à la liste des favoris.

## Gérer les requêtes favorites
<a name="v10-explore-manage-history-favorites"></a>

Toutes les requêtes qui ont été marquées dans l'onglet Historique des requêtes sont affichées dans l'onglet Marqué. Cela vous permet d'accéder plus rapidement à vos requêtes préférées et de les réutiliser sans les taper à partir de zéro.

## Tri de l'historique des requêtes
<a name="v10-explore-manage-history-sort"></a>

Par défaut, l'historique des requêtes affiche les requêtes les plus récentes. Vous pouvez trier votre historique par date ou par nom de source de données par ordre croissant ou décroissant.

**Pour trier l'historique de vos requêtes**

1. Sélectionnez le champ **Trier les requêtes par**.

1. Sélectionnez l’une des options suivantes :
   + **Le plus récent en premier**
   + **Le plus vieux d'abord**

## Filtrer l'historique des requêtes
<a name="v10-explore-manage-history-filter"></a>

Vous pouvez filtrer l'historique de vos requêtes dans l'onglet Historique des requêtes et dans l'onglet Favoris en fonction d'une source de données spécifique.

**Pour filtrer l'historique vers une source de données**

1. Sélectionnez le champ **Filtrer les requêtes pour des sources de données spécifiques**.

1. Sélectionnez la source de données pour laquelle vous souhaitez filtrer votre historique. Vous pouvez sélectionner plusieurs sources de données.

**Note**  
Les requêtes exécutées à l'aide de la source de données mixte apparaîtront uniquement lors du filtrage pour le mode mixte, et non lors du filtrage en fonction de leurs sources de données individuelles.

Dans l'onglet **Historique des requêtes**, il est également possible de filtrer les requêtes par date à l'aide du curseur :
+ Utilisez le curseur vertical pour filtrer les requêtes par date.
+ Ajustez la date de début en faisant glisser la poignée inférieure.
+ Ajustez la date de fin en faisant glisser la poignée supérieure.

## Recherche dans l'historique des requêtes
<a name="v10-explore-manage-history-search"></a>

Vous pouvez effectuer des recherches dans votre historique parmi les requêtes et les commentaires. Il est possible de rechercher des requêtes dans l'onglet Historique des requêtes et dans l'onglet Started.

**Pour effectuer une recherche dans l'historique des requêtes**

1. Sélectionnez le champ **Requêtes de recherche**.

1. Entrez le terme que vous recherchez dans le champ de recherche.

## Paramètres de l'historique des requêtes
<a name="v10-explore-manage-history-settings"></a>

Vous pouvez personnaliser l'historique des requêtes dans l'onglet Paramètres. Les options sont décrites dans le tableau suivant.


| Paramètre | Valeur par défaut | 
| --- | --- | 
| Modifier l'onglet actif par défaut | Onglet Historique des requêtes | 

**Note**  
Les paramètres de l'historique des requêtes sont globaux et appliqués aux deux panneaux en mode partagé.

# Se connecte Explore
<a name="v10-explore-logs"></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)

Explore vous permet d'examiner vos journaux dans différentes sources de données, notamment :
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

Lors de la surveillance de l'infrastructure et de la réponse à un incident, vous pouvez approfondir les indicateurs et les journaux pour en trouver la cause. Explore vous permet également de corréler les journaux avec d'autres signaux de télémétrie tels que les métriques, les traces ou les profils, en les visualisant. side-by-side

Les résultats des requêtes de journal sont affichés sous forme de lignes de journal individuelles et sous forme de graphique indiquant le volume de journaux pour la période sélectionnée.

## Volume des journaux
<a name="v10-explore-logs-volume"></a>

Lorsque vous travaillez avec des sources de données qui prennent en charge un volume de journaux complet, Explore affiche automatiquement un graphique montrant la distribution des journaux pour toutes les requêtes de journal saisies. Cette fonctionnalité est actuellement prise en charge par OpenSearch les sources de données Loki.

**Note**  
Dans Loki, ce volume de log complet est rendu par une requête métrique qui peut être coûteuse en fonction de la plage de temps demandée. Cette requête peut être particulièrement difficile à traiter pour les petites installations Loki. Pour atténuer ce problème, vous pouvez utiliser un proxy tel que [nginx](https://www.nginx.com/) devant Loki pour définir un délai d'attente personnalisé (par exemple, 10 secondes) pour ces requêtes. Les requêtes d'histogramme de volume de journal peuvent être identifiées en recherchant les requêtes dont l'en-tête HTTP contient `X-Query-Tags` une valeur `Source=logvolhist` ; ces en-têtes sont ajoutés par Grafana à toutes les requêtes d'histogramme de volume de journal.

Si la source de données ne prend pas en charge le chargement du volume complet des journaux, le modèle de journaux calcule une série chronologique en comptant les lignes de journaux et en les organisant en compartiments sur la base d'un intervalle de temps calculé automatiquement. L'horodatage de la première ligne de log est utilisé pour ancrer le début du volume de logs dans les résultats. La fin de la série chronologique est ancrée dans la plage To du sélecteur **de** temps. Ainsi, vous pouvez toujours analyser et visualiser efficacement les données des journaux, même lorsque la source de données n'offre pas une prise en charge complète.

## Journaux
<a name="v10-explore-logs-overview"></a>

Dans les sections suivantes, vous trouverez des explications détaillées sur la manière de visualiser et d'interagir avec des journaux individuels dans Explore.

## Navigation dans les journaux
<a name="v10-explore-logs-navigation"></a>

La navigation dans les journaux, sur le côté droit des lignes de journal, peut être utilisée pour demander facilement des journaux supplémentaires. Vous pouvez le faire en cliquant sur le bouton **Anciens journaux** en bas de la navigation. Cela est particulièrement utile lorsque vous atteignez la limite de lignes et que vous souhaitez voir plus de journaux. Chaque demande exécutée à partir de la navigation est ensuite affichée dans la navigation sous forme de page distincte. Chaque page affiche `from` et `to` horodatage des lignes de journal entrantes. Vous pouvez consulter les résultats précédents en cliquant sur chaque page. Explore met en cache les cinq dernières requêtes exécutées depuis la navigation des journaux. Vous n'avez donc pas à réexécuter les mêmes requêtes lorsque vous cliquez sur les pages, ce qui permet d'économiser du temps et des ressources.

## Options de visualisation
<a name="v10-explore-log-visualization-options"></a>

 Vous pouvez personnaliser le mode d'affichage des journaux et sélectionner les colonnes à afficher. 


| Option | Description | 
| --- | --- | 
| Time (Période) | Affiche ou masque la colonne de temps. Il s'agit de l'horodatage associé à la ligne de journal tel qu'indiqué par la source de données. | 
| Étiquettes uniques | Affiche ou masque la colonne d'étiquettes uniques qui inclut uniquement les étiquettes non courantes. Toutes les étiquettes courantes sont affichées ci-dessus. | 
| Lignes d'enroulement | Définissez ce paramètre sur true si vous souhaitez que l'affichage utilise l'habillage de lignes. Si ce paramètre est défini surfalse, il en résultera un défilement horizontal. | 
| Embellissez le JSON |  Réglez ce paramètre sur true pour imprimer joliment tous les journaux JSON. Ce paramètre n'affecte pas les journaux dans un format autre que JSON. | 
| Déduplication | Les données de journal peuvent être très répétitives et Explore peut vous aider en masquant les lignes de journal dupliquées. Il existe différents algorithmes de déduplication que vous pouvez utiliser. Les correspondances exactes sont effectuées sur l'ensemble de la ligne, à l'exception des champs de date. Les correspondances de nombres sont effectuées sur la ligne après avoir retiré des nombres tels que les durées, les adresses IP, etc. La signature est la déduplication la plus agressive, car elle supprime toutes les lettres et tous les chiffres et fait correspondre les espaces blancs et les signes de ponctuation restants. | 
| Afficher l'ordre des résultats | Vous pouvez modifier l'ordre des journaux reçus de l'ordre décroissant par défaut (le plus récent en premier) à l'ordre croissant (le plus ancien en premier). | 

## Téléchargez les lignes de journal
<a name="v10-explore-download-log-lines"></a>

Pour télécharger les résultats du journal dans l'`txt`un ou l'autre `json` format, utilisez le bouton **Télécharger**. Cette fonctionnalité vous permet d'enregistrer les données du journal pour une analyse plus approfondie ou de les partager avec d'autres personnes dans un format pratique et accessible.

## Méta-informations sur les résultats du journal
<a name="v10-explore-log-result-meta-information"></a>

Au-dessus des lignes de journal reçues, vous trouverez des méta-informations essentielles, notamment :
+ **Nombre de journaux reçus** : indique le nombre total de journaux reçus pour la requête ou la période en cours.
+ **Erreur** — Affiche une erreur possible dans les résultats de votre journal.
+ **Étiquettes communes** : affiche les étiquettes communes.
+ **Nombre total d'octets traités** : représente la taille cumulée des données du journal traitées en octets.

**Note**  
La disponibilité de certaines méta-informations peut dépendre de la source de données et, par conséquent, il est possible que vous ne voyiez certains de ces détails que pour des sources de données spécifiques.

## Échapper aux nouvelles lignes
<a name="v10-explore-log-escaping-newlines"></a>

Explore détecte automatiquement certaines séquences échappées de manière incorrecte dans les lignes de journal, telles que les nouvelles lignes (`\n`,`\r`) ou les onglets (`\t`). Lorsqu'il détecte de telles séquences, Explore propose une option **Escape newlines**.

**Pour corriger automatiquement les séquences incorrectement échappées détectées par Explore**

1. Choisissez **Escape newlines** pour remplacer les séquences.

1. Vérifiez manuellement les remplacements pour confirmer leur exactitude.

Explore remplace ces séquences. Dans ce cas, l'option passe de **Échapper aux nouvelles lignes à Supprimer les lignes** **qui s'échappent**. Évaluez les modifications car l'analyse peut ne pas être précise en fonction des entrées reçues. Vous pouvez annuler les remplacements en sélectionnant **Supprimer** les échappements.

## Niveau de journalisation
<a name="v10-explore-log-level"></a>

Pour les journaux pour lesquels une `level` étiquette est spécifiée, nous utilisons la valeur de cette étiquette pour déterminer le niveau de journalisation et mettre à jour la couleur de chaque ligne de journal en conséquence. Si le journal n'a pas d'étiquette de niveau spécifiée, nous essayons de déterminer si son contenu correspond à l'une des expressions prises en charge (consultez le tableau suivant pour plus d'informations). Le niveau de journalisation est toujours déterminé par la première correspondance. Si Grafana n'est pas en mesure de déduire un champ de niveau de log, celui-ci sera visualisé avec un niveau de log inconnu.

**Note**  
Si vous utilisez une source de données Loki et que celle-ci `level` fait partie de votre ligne de journal, vous pouvez utiliser des analyseurs (JSON, logfmt, regex,..) pour extraire les informations de niveau dans une étiquette de niveau utilisée pour déterminer la valeur du niveau. Cela permettra à l'histogramme d'afficher les différents niveaux de log sous forme de barres distinctes.

**Niveaux de journalisation pris en charge et mappage des abréviations et expressions des niveaux de journalisation :** 


| Niveau de journalisation | Couleur | Expressions prises en charge | 
| --- | --- | --- | 
| critique | pourpre | émerge, fatal, alerte, critique, critique | 
| error | red | erreur, erreur, erreur | 
| warning | yellow | avertir, avertir | 
| info | green | info, information, information, avis | 
| debug | blue | dbug, debug | 
| trace | bleu clair | trace | 
| inconnu | gris | \$1 | 

## Surligner les mots recherchés
<a name="v10-explore-highlight-searched-words"></a>

Lorsque votre requête inclut des mots ou des expressions spécifiques à rechercher, Explore les met en évidence dans les lignes de journal pour une meilleure visibilité. Cette fonctionnalité de mise en évidence permet d'identifier plus facilement le contenu pertinent de vos journaux et de vous concentrer sur celui-ci.

**Note**  
La capacité à surligner les mots de recherche peut varier en fonction de la source de données. Pour certaines sources de données, le surlignage des mots de recherche peut ne pas être disponible.

## Affichage des détails du journal
<a name="v10-explore-log-details-view"></a>

Dans Explore, chaque ligne de journal comporte une section extensible appelée *Détails du journal* qui peut être ouverte en choisissant la ligne de journal. La vue des détails du journal fournit des informations supplémentaires et des options d'exploration sous la forme de *champs* et de *liens* attachés aux lignes de journal, permettant une interaction et une analyse plus robustes.

**Champs**

Dans la vue Détails du journal, vous pouvez filtrer les champs affichés de deux manières : un filtre positif (pour vous concentrer sur un champ spécifique) et un filtre négatif (pour exclure certains champs). Ces filtres mettront à jour la requête correspondante qui a produit la ligne de log, en ajoutant les expressions d'égalité et d'inégalité en conséquence. Si la source de données est compatible, comme c'est le cas pour Loki et Loki OpenSearch, les détails du journal vérifieront si le champ est déjà présent dans la requête en cours et s'affichera à l'état actif (pour les filtres positifs uniquement), ce qui vous permettra de le désactiver ou de faire passer l'expression du filtre de positive à négative.

Vous pouvez sélectionner un sous-ensemble de champs à visualiser dans la liste des journaux plutôt que dans la ligne complète du journal en cliquant sur l'icône en forme d'œil. Chaque champ possède une icône de statistiques pour afficher les statistiques relatives à tous les journaux affichés.

**Liens**

Grafana offre la fonctionnalité de liens ou de corrélations de données, vous permettant de convertir n'importe quelle partie d'un message de journal en lien interne ou externe. Ces liens peuvent être utilisés pour accéder à des données connexes ou à des ressources externes, offrant ainsi un moyen simple et pratique d'explorer de plus amples informations.

## Contexte du journal
<a name="v10-explore-log-context"></a>

Le contexte du journal affiche des lignes de contexte supplémentaires entourant une entrée de journal qui correspond à une requête de recherche particulière. Cela peut être utile pour comprendre le contexte de l'entrée du journal et est similaire au `-C` paramètre de la `grep` commande.

Vous pouvez rencontrer de longues lignes de texte qui compliquent la lecture et l'analyse du contexte de chaque entrée du journal. C'est là que le bouton **Wrap lines** peut s'avérer utile. En activant cette option, Grafana enroulera automatiquement de longues lignes de texte afin qu'elles correspondent à la largeur visible du lecteur. Cela peut faciliter la lecture et la compréhension des entrées du journal. 

 Le bouton **Ouvrir en mode partagé** vous permet d'exécuter la requête contextuelle pour une entrée de journal sur un écran partagé dans la vue Explore. Le fait de cliquer sur ce bouton ouvre un nouveau volet Explore dans lequel la requête contextuelle est affichée à côté de l'entrée du journal, ce qui facilite l'analyse et la compréhension du contexte environnant.

La requête contextuelle du journal peut également être ouverte dans un nouvel onglet du navigateur en appuyant sur la touche `Ctrl` (ou`Cmd`) tout en choisissant le bouton pour ouvrir le modal de contexte. Lorsqu'ils sont ouverts dans un nouvel onglet, les filtres précédemment sélectionnés sont également appliqués.

## Copier la ligne du journal
<a name="v10-explore-copy-log-line"></a>

Vous pouvez facilement copier le contenu d'une ligne de journal sélectionnée dans votre presse-papiers en cliquant sur le bouton **Copier la ligne de journal**.

## Copier le lien vers la ligne de journal
<a name="v10-explore-copy-link-to-log-line"></a>

La liaison des lignes de journal dans Grafana vous permet de naviguer rapidement vers des entrées de journal spécifiques pour une analyse précise. En cliquant sur le bouton **Copier le lien court** pour une ligne de journal, vous pouvez générer et copier une URL courte qui fournit un accès direct à l'entrée exacte du journal dans un intervalle de temps absolu. Lorsque vous ouvrez le lien, Grafana fait automatiquement défiler la page jusqu'à la ligne de journal correspondante et la met en évidence sur fond bleu, ce qui permet d'identifier facilement les informations pertinentes et de se concentrer sur celles-ci.

**Note**  
Cela n'est pris en charge que dans Loki et dans les autres sources de données qui fournissent un `id` champ.

## Tailing en direct
<a name="v10-explore-log-live-tailing"></a>

Pour consulter les journaux en temps réel des sources de données prises en charge, vous pouvez utiliser la fonctionnalité de suivi en direct d'Explore.

**Pour consulter les journaux en temps réel grâce au suivi en direct**

1. Cliquez sur le bouton **Live** dans la barre d'outils Explore pour passer à la vue Live tail.

1. En mode Live tail, les nouveaux journaux apparaîtront en bas de l'écran, avec un arrière-plan contrastant qui s'estompe, ce qui vous permettra de suivre facilement les nouveautés.

1. Si vous souhaitez suspendre le suivi en direct et explorer les journaux précédents sans interruption, vous pouvez le faire en cliquant sur le bouton **Pause** ou en faisant simplement défiler la vue des journaux.

1. Pour effacer l'affichage et supprimer tous les journaux de l'écran, cliquez sur le bouton **Effacer les journaux**. Cette action réinitialisera la vue du journal et vous permettra de faire table rase pour poursuivre l'analyse du journal.

1. Pour reprendre le suivi en direct et continuer à consulter les journaux en temps réel, cliquez sur le bouton **Reprendre**.

1. Si vous souhaitez quitter Live Tailing et revenir à la vue Explore standard, cliquez sur le bouton **Arrêter**.

Grâce à la fonction de suivi en direct, vous pouvez suivre de près les derniers journaux au fur et à mesure qu'ils arrivent, ce qui facilite le suivi des événements en temps réel et la détection rapide des problèmes.

**Exemple de journaux**

Si la source de données sélectionnée implémente un échantillon de journaux et prend en charge les requêtes de log et de métrique, alors pour les requêtes métriques, vous pourrez voir automatiquement des exemples de lignes de journal ayant contribué à la visualisation des métriques. Cette fonctionnalité est actuellement prise en charge par les sources de données Loki.

**Passez des métriques aux journaux**

 Si vous passez d'une source de données de métriques implémentée `DataSourceWithQueryExportSupport` (telle que Prometheus) à une source de données de journalisation `DataSourceWithQueryImportSupport` compatible (telle que Loki), elle conservera les étiquettes de votre requête qui existent dans les journaux et les utilisera pour interroger les flux de journaux.

Par exemple, la `grafana_alerting_active_alerts{job='grafana'}` requête Prometheus suivante, une fois passée à la source de données Loki, deviendra. `{job='grafana'}` Cela renverra une partie des journaux dans la plage de temps sélectionnée qui pourront être grepped/text recherchés.

# Traçage dans Explore
<a name="v10-explore-tracing"></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 Explore pour visualiser des traces à partir de sources de données de suivi.

Les sources de données suivantes sont prises en charge :
+ [Tempo](tempo-data-source.md) (formats d'ingestion pris en charge : OpenTelemetry, Jaeger et Zipkin)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

Pour plus d'informations sur la configuration des requêtes pour les sources de données répertoriées ci-dessus, reportez-vous à la documentation de la source de données spécifique.

## Éditeur de requêtes
<a name="v10-explore-trace-queryeditor"></a>

Vous pouvez interroger et rechercher des données de suivi à l'aide de l'éditeur de requêtes d'une source de données.

Chaque source de données peut avoir son propre éditeur de requêtes. L'éditeur de requêtes pour la source de données Tempo est légèrement différent de l'éditeur de requêtes pour la source de données Jaeger.

Pour plus d'informations sur l'interrogation de chaque source de données, reportez-vous à leur documentation.
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## Explication de Trace View
<a name="v10-explore-trace-view"></a>

Cette section explique les éléments du tableau de bord Trace View.

**En-tête**

L'en-tête de la vue de trace comporte les éléments suivants :
+ Titre de l'en-tête — Affiche le nom de l'intervalle racine et l'ID de trace.
+ Rechercher : met en évidence les plages contenant le texte recherché.
+ Métadonnées : diverses métadonnées relatives à la trace.

**Mini-carte**

Affiche la vue condensée ou la chronologie du tracé. Faites glisser votre pointeur sur la mini-carte pour zoomer sur une plage de temps plus courte. Le zoom permet également de mettre à jour la chronologie principale, de sorte qu'il est facile de voir des plages plus courtes. Lorsque vous passez le curseur sur la minicarte, une fois zoomée, le bouton **Réinitialiser la sélection permet de réinitialiser** le zoom.

**Filtres Span**

À l'aide de filtres d'intervalle, vous pouvez filtrer vos intervalles dans l'afficheur de chronologie des traces. Plus vous ajoutez de filtres, plus les plages filtrées sont spécifiques.

Vous pouvez ajouter un ou plusieurs des filtres suivants :
+ Nom du service de ressources
+ Nom de l'Espagne
+ Duration
+ Balises (qui incluent les balises, les balises de processus et les champs de journal)

Pour afficher uniquement les intervalles auxquels vous avez fait correspondre, sélectionnez le bouton **Afficher les correspondances uniquement**.

**Chronologie**

Affiche la liste des intervalles contenus dans le tracé. Chaque ligne de span comprend les composants suivants :
+ Bouton Élargir les enfants : permet d'étendre ou de réduire toutes les tranches d'enfants de la période sélectionnée.
+ Nom du service : nom du service qui a enregistré l'intervalle.
+ Nom de l'opération : nom de l'opération représentée par cette plage.
+ Barre de durée de l'intervalle : représentation visuelle de la durée de l'opération dans le tracé.

**Détails de l'envergure**

Le choix de la ligne d'intervalle affiche les détails de l'intervalle, notamment les suivants.
+ Nom de l’opération
+ Métadonnées Span
+ Balises : toutes les balises associées à cette plage.
+ Métadonnées du processus : métadonnées relatives au processus qui a enregistré cette période.
+ Journaux : liste des journaux enregistrés par cette plage et des valeurs clés associées. Dans le cas des journaux Zipkin, la section affiche les annotations Zipkin.

**Trace vers les journaux**

Vous pouvez accéder directement à une plage dans une vue de trace aux journaux correspondant à cette période. Ceci est disponible pour les sources de données Tempo, Jaeger et Zipkin. Reportez-vous à leur documentation pertinente pour obtenir des instructions sur la façon de configurer chaque source de données.

Cliquez sur l'icône du document pour ouvrir une vue fractionnée dans Explore avec la source de données configurée et recherchez les journaux pertinents pour la période.

**Suivi des métriques**

**Note**  
Cette fonctionnalité est actuellement en version bêta

Vous pouvez passer d'une plage dans une vue de trace directement aux métriques pertinentes pour cette période. Cette fonctionnalité est disponible pour les sources de données Tempo, Jaeger et Zipkin. Reportez-vous à leur documentation appropriée pour plus de détails sur la configuration.

**Trace jusqu'aux profils**

En utilisant Trace to profiles, vous pouvez utiliser la capacité de Grafana à corréler différents signaux en ajoutant la fonctionnalité permettant de lier les traces aux profils.

## Graphe de nœuds
<a name="v10-explore-trace-node-graph"></a>

Vous pouvez éventuellement développer le graphe de nœuds pour le tracé affiché. En fonction de la source de données, cela peut afficher les étendues de la trace sous forme de nœuds dans le graphe ou ajouter du contexte supplémentaire, notamment le graphe de service basé sur la trace actuelle.

## Affichage du graphique des services
<a name="v10-explore-trace-graph"></a>

La vue Service Graph permet de visualiser les métriques de durée (trace les données relatives aux taux, aux taux d'erreur et aux durées (RED)) et les graphiques de service. Une fois les exigences définies, cette vue préconfigurée est immédiatement disponible.

Pour plus d'informations, consultez la page des sources de données [Tempo](tempo-data-source.md). Vous pouvez également consulter la [page d'affichage du graphique de service](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/) dans la documentation *Tempo de Grafana Labs*.

## API de données
<a name="v10-explore-trace-dataapi"></a>

Cette visualisation nécessite une forme spécifique des données à renvoyer depuis la source de données afin de les afficher correctement.

La source de données doit renvoyer une trame de données et un ensemble`frame.meta.preferredVisualisationType = 'trace'`.

**Structure du bloc de données**

Les champs obligatoires ;


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| ID de trace | chaîne | Identifiant de l'ensemble de la trace. Il ne doit y avoir qu'une seule trace dans le bloc de données. | 
| ID d'Espagne | chaîne | Identifiant de la plage en cours. L'étendue IDs doit être unique par trace. | 
| Panid des parents | chaîne | SpanID de l'espace parent pour créer une relation enfant-parent dans la vue de trace. Peut être undefined pour Root Span sans parent. | 
| serviceName | chaîne | Nom du service dont fait partie cette période. | 
| Étiquettes de service | TraceKeyValuePair[] | Liste des balises pertinentes pour le service. | 
| startTime | number | Heure de début de la période en millisecondes. | 
| duration | number | Durée de l'intervalle en millisecondes. | 

 Champs facultatifs : 


| Nom de champ | Type | Description | 
| --- | --- | --- | 
| journaux | TraceLog[] | Liste des journaux associés à la période en cours. | 
| tags | TraceKeyValuePair[] | Liste des balises associées à la plage en cours. | 
| warnings | chaîne [] | Liste des avertissements associés à la période en cours. | 
| Stack Traces | chaîne [] | Liste des traces de pile associées à l'intervalle actuel. | 
| errorIconColor | chaîne | Couleur de l'icône d'erreur au cas où span est marqué avecerror: true. | 

Pour plus de détails sur les types [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28), voir, [TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)et ainsi de [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)suite GitHub.

# Éditeur de corrélations dans Explore
<a name="v10-explore-correlations"></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 corrélations permettent aux utilisateurs d'établir un lien entre deux sources de données. Pour plus d'informations, y compris un aperçu des corrélations, voir[Corrélations dans Grafana version 10](v10-correlations.md).

## Création d'une corrélation
<a name="v10-explore-corr-create-a-correlation"></a>

Vous pouvez créer des corrélations à partir de la page Explorer.

**Pour créer une corrélation**

1. Dans votre espace de travail Amazon Managed Grafana, accédez à la page Explore.

1. Sélectionnez la source de données que vous souhaitez utiliser comme source pour une nouvelle corrélation.

1. Exécutez une requête produisant des données dans une visualisation prise en charge.
**Note**  
Les visualisations prises en charge sont [Logs](v10-panels-logs.md) et [Table.](v10-panels-table.md)

1. Choisissez **\$1 Ajouter** dans la barre d'outils supérieure, puis sélectionnez **Ajouter une corrélation** (vous pouvez également sélectionner l'**éditeur de corrélations** dans la [palette de commandes](v10-search.md#v10-search-palette)).

   Explore est désormais en mode éditeur de corrélations, indiqué par une bordure bleue et une barre supérieure. Vous pouvez quitter l'éditeur de corrélations en choisissant **Exit** dans la barre supérieure.

1. Vous pouvez désormais créer les nouvelles corrélations suivantes pour la visualisation à l'aide de liens attachés aux données que vous pouvez utiliser pour créer une nouvelle requête :
   + *Journaux* : les liens sont affichés à côté des valeurs des champs dans les détails du journal pour chaque ligne du journal.
   + *Tableau* : chaque cellule du tableau est un lien.

1. Choisissez un lien pour ajouter une nouvelle corrélation. Les liens sont associés à un champ utilisé comme champ de résultat d'une corrélation. Pour en savoir plus, consultez [Configuration de corrélation](v10-correlations-config.md).

1. Dans la vue divisée qui s'ouvre, utilisez le volet droit pour configurer la source de requête cible de la corrélation. Pour en savoir plus, consultez [Requête cible](v10-correlations-config.md#v10-correlations-config-target-query).

1. Créez une requête cible à l'aide de [la syntaxe](v10-dash-variable-syntax.md) des variables avec les variables de la liste fournie en haut du volet. La liste contient des exemples de valeurs provenant de la ligne de données sélectionnée.

1. Fournissez une étiquette et une description (facultatif). Une étiquette sera utilisée comme nom du lien dans la visualisation et peut contenir des variables.

1. Fournissez des transformations (facultatif ; voir ci-dessous pour plus de détails).

1. Choisissez **Enregistrer** dans la barre d'outils supérieure pour enregistrer la corrélation et quitter le mode Éditeur de corrélations. Le lien utilisé pour créer la corrélation est remplacé par un lien de données dans chaque ligne. Lorsque le lien est sélectionné, la requête que vous avez définie s'exécute dans un autre volet, les variables étant remplacées dynamiquement par les valeurs de la ligne sélectionnée.

## Transformations
<a name="v10-explore-corr-transformations"></a>

Les transformations vous permettent d'extraire des valeurs qui existent dans un champ avec d'autres données. Par exemple, à l'aide d'une transformation, vous pouvez extraire une partie d'une ligne de log à utiliser dans une corrélation. Pour plus de détails sur les transformations des corrélations, voir[Transformations de corrélation](v10-correlations-config.md#v10-correlations-config-transformations).

Après avoir sélectionné l'un des liens générés en mode éditeur, vous pouvez ajouter des transformations en sélectionnant **Ajouter une transformation** dans le menu déroulant **Transformations**.

**Pour utiliser une transformation dans une corrélation**

1. Sélectionnez un champ auquel appliquer la transformation. Sélectionnez la partie du champ que vous souhaitez utiliser pour la transformation. Par exemple, une ligne de journal. Une fois sélectionnée, la valeur de ce champ sera utilisée pour vous aider à créer la transformation.

1. Sélectionnez le type de transformation. Consultez [Transformations de corrélation](v10-correlations-config.md#v10-correlations-config-transformations) les options et les paramètres appropriés. 

1. En fonction de votre sélection, il se peut qu'une ou plusieurs variables soient renseignées ou que vous deviez fournir des spécifications supplémentaires dans les options affichées.

1. Sélectionnez **Ajouter une transformation à la corrélation** pour ajouter les variables spécifiées à la liste des variables disponibles.

**Note**  
Pour les expressions régulières de cette boîte de dialogue, les expressions `mapValue` mentionnées dans d'autres documents sont appelées `Variable Name` ici. Grafana met en surbrillance tout texte correspondant à l'expression contenue dans la valeur du champ. Utilisez des groupes de capture d'expressions régulières pour sélectionner la partie de la correspondance à extraire. Lorsqu'une expression régulière valide est fournie, la variable et sa valeur apparaissent sous le `Variable Name` champ.

## Exemples de corrélations
<a name="v10-explore-corr-examples"></a>

Les exemples suivants montrent comment créer des corrélations à l'aide de l'éditeur de corrélations dans Explore. Si vous souhaitez suivre ces exemples, veillez à configurer une [source de données de test](testdata-data-source.md).

### Création d'une corrélation entre le texte et le graphique
<a name="v10-explore-corr-text-to-graph"></a>

Cet exemple montre comment créer une corrélation à l'aide de l'éditeur de corrélations dans Explore.

Les corrélations vous permettent d'utiliser les résultats d'une requête pour exécuter une nouvelle requête dans n'importe quelle source de données. Dans cet exemple, vous allez exécuter une requête qui affiche des données tabulaires. Les données seront utilisées pour exécuter une requête différente qui produira un résultat graphique.

Pour suivre cet exemple, assurez-vous d'avoir configuré une [source de données de test](testdata-data-source.md).

**Pour créer une corrélation entre le texte et le graphique**

1. **Dans Grafana, accédez à Explore.**

1. Sélectionnez la **source de données de test** dans le menu déroulant en haut à gauche de la page.

1. Choisissez **\$1 Ajouter** dans le menu déroulant à droite, puis sélectionnez **Ajouter une corrélation**.

1. Explore est désormais en mode éditeur de corrélations, indiqué par une bordure bleue.

1. Sélectionnez le scénario suivant dans le menu déroulant des scénarios : **Fichier CSV**.

1. Sélectionnez le fichier **population\$1by\$1state.csv**. Chaque cellule est un lien sur lequel vous pouvez cliquer pour commencer à créer une nouvelle corrélation.

1. Cliquez sur n'importe quelle cellule de la `State` colonne pour créer une nouvelle corrélation qui associe un lien de données à cette entrée. Par exemple, sélectionnez`California`.

1. Dans la vue divisée, sélectionnez la même source de données que celle que vous avez sélectionnée dans le volet de gauche. L'assistant situé au-dessus de l'éditeur de requêtes contient toutes les variables disponibles que vous pouvez utiliser pour la requête cible. Les variables contiennent tous les champs de données (colonnes de table) de la ligne sélectionnée.

1. Dans le menu **Scénario**, sélectionnez **Valeurs métriques CSV**. Le `String Input` champ de l'éditeur de requête fournit des variables avec des valeurs de population pour chaque année :`${1980},${2000},${2020}`. Cela générera un graphique utilisant des valeurs variables.

1. Dans le champ **Alias** de l'éditeur de requêtes, entrez`${State}`.

   Exécutez une requête pour vérifier qu'elle produit un graphique en utilisant des exemples de valeurs provenant des variables.

1. Choisissez **Enregistrer** pour enregistrer la corrélation et quitter l'éditeur de corrélations.

   Une fois la corrélation enregistrée, Explore réexécute la requête dans le volet de gauche. En cliquant sur le nom d'un état, la requête de droite est réexécutée avec les valeurs de la ligne insérées dans le CSV, modifiant ainsi le graphique. La requête est réexécutée avec des valeurs mises à jour chaque fois que vous cliquez sur le nom d'un État.

Vous pouvez appliquer les mêmes étapes à n'importe quelle source de données. Les corrélations vous permettent de créer des liens dans les visualisations afin d'exécuter des requêtes dynamiques basées sur des données sélectionnées. Dans cet exemple, nous avons utilisé les données renvoyées par une requête pour créer une nouvelle requête générant une visualisation différente à partir de la même source de données. Vous pouvez toutefois créer des corrélations entre toutes les sources de données afin de créer des flux d'exploration personnalisés.

### Création d'une corrélation entre les journaux et les tables
<a name="v10-explore-corr-logs-to-table"></a>

Dans cet exemple, vous allez créer une corrélation pour montrer comment utiliser les transformations pour extraire des valeurs de la ligne du journal et d'un autre champ.

Pour suivre cet exemple, assurez-vous d'avoir configuré une [source de données de test](testdata-data-source.md).

**Pour créer une corrélation entre les journaux et les tables**

1. **Dans Grafana, accédez à Explore.**

1. Sélectionnez la **source de données de test** dans le menu déroulant en haut à gauche de la page.

1. Choisissez **\$1 Ajouter** dans le menu déroulant à droite, puis sélectionnez **Ajouter une corrélation**.

1. Explore est désormais en mode éditeur de corrélations, indiqué par une bordure bleue.

1. Dans le menu **Scénario**, sélectionnez **Logs**.

1. Développez une ligne de journal pour voir les liens de corrélation. Sélectionnez `Correlate with hostname`.

1. Explore s'ouvre en mode partagé. Sélectionnez la même source de données que celle que vous avez sélectionnée dans le volet de gauche. L'assistant situé au-dessus de l'éditeur de requêtes contient toutes les variables disponibles que vous pouvez utiliser pour la requête cible.

1. Développez la section des transformations, puis cliquez sur **Ajouter une transformation**.

1. Dans le menu déroulant **Champ**, sélectionnez le **message**. La ligne du journal s'affiche à titre d'exemple de données.

1. Sous **Type**, sélectionnez **Logfmt**. Cela permet de remplir la liste des variables.

1. Choisissez **Ajouter une transformation à la corrélation**.

1. Choisissez à nouveau **Ajouter une transformation** et sous **Champ**, sélectionnez le **nom d'hôte**.

1. Sous **Type**, sélectionnez **Expression régulière**.

1. Sous **Expression**, entrez ce qui suit : `-([0-9]\*)` Cela permet de sélectionner n'importe quel chiffre situé à droite du tiret.

1. Sous **Nom de la variable**, entrez ce qui suit : `hostNumber` Cela permet de remplir la liste des variables. 

1. Choisissez **Ajouter une transformation à la corrélation** pour l'ajouter aux autres variables.

1. Dans l'éditeur de source de données, ouvrez le menu déroulant **Scénario** et sélectionnez **Contenu CSV**.

1. Dans la zone de texte ci-dessous, saisissez les informations suivantes et enregistrez la corrélation :

   ```
   time,msg,hostNumber,status
   ${time},${msg},${hostNumber},${status}
   ```

   Cela ferme la vue divisée et réexécute la requête de gauche. Développez n'importe quelle ligne du journal pour voir le bouton de corrélation. Le bouton de corrélation ouvre la vue divisée avec le `time` (un champ), `msg` (extrait avec *logfmt* de la ligne du journal), `host number` (extrait avec *regex* depuis le`hostname`) et le `status` (extrait avec *logfmt* depuis la ligne du journal).

# Inspector dans Explore
<a name="v10-explore-inspector"></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)

L'inspecteur vous aide à comprendre vos requêtes et à les résoudre. Vous pouvez inspecter les données brutes, les exporter vers un fichier de valeurs séparées par des virgules (CSV), exporter les résultats du journal au format TXT et consulter les demandes de requête.

## Interface utilisateur de l'inspecteur
<a name="v10-explore-inspector-ui"></a>

L'inspecteur comporte les onglets suivants :
+ **Onglet Statistiques** : indique le temps que prend votre requête et le montant qu'elle renvoie.
+ **Onglet Requête** — Affiche les demandes envoyées au serveur lorsque Grafana interroge la source de données.
+ **Onglet JSON** — Vous permet de visualiser et de copier les données JSON et la structure du bloc de données JSON.
+ **Onglet Données** : affiche les données brutes renvoyées par la requête.
+ **Onglet Erreur** : affiche l'erreur. Visible uniquement lorsque la requête renvoie une erreur.

## Tâches de l'Inspecteur
<a name="v10-explore-inspector-tasks"></a>

Vous pouvez effectuer diverses tâches dans l'inspecteur Explore.

**Ouvrez l'Inspector**

Après avoir exécuté la requête que vous souhaitez inspecter, cliquez sur le bouton **Inspector**.

Le volet de l'inspecteur s'ouvre en bas de l'écran.

**Inspecter les résultats bruts des requêtes**

Vous pouvez afficher les résultats bruts de la requête, c'est-à-dire les données renvoyées par la requête dans une table.

Dans l'onglet **Inspector**, cliquez sur l'onglet **Data**.

Pour les requêtes multiples ou pour les requêtes impliquant plusieurs nœuds, des options supplémentaires sont disponibles.
+ **Afficher le bloc de données :** sélectionnez les données de l'ensemble de résultats que vous souhaitez afficher.
+ **Séries jointes par heure :** visualisez les données brutes de toutes vos requêtes en une seule fois, un ensemble de résultats par colonne. Vous pouvez cliquer sur l'en-tête d'une colonne pour trier les données.

**Télécharger les résultats bruts des requêtes au format CSV**

Grafana génère un fichier CSV dans l'emplacement de téléchargement par défaut de votre navigateur. Vous pouvez l'ouvrir dans le visualiseur de votre choix.

1. Dans l'onglet **Inspector**, obtenez les résultats bruts des requêtes en suivant les instructions ci-dessus.

1. Affinez les paramètres de requête jusqu'à ce que vous puissiez voir les données brutes que vous souhaitez exporter.

1. Choisissez **Télécharger le rapport CSV**.

Pour télécharger un fichier CSV spécialement formaté pour Excel, développez les **options de données**, puis activez le bouton **Télécharger pour Excel** avant de sélectionner l'option **Télécharger le CSV**.

**Télécharger les résultats du journal au format TXT**

Vous pouvez générer un fichier TXT contenant les journaux que vous êtes en train de consulter en sélectionnant **Download logs** dans l'onglet **Inspector**.

**Télécharger les résultats de suivi**

En fonction du type de source de données, Grafana génère un fichier JSON pour les résultats de suivi dans l'un des formats pris en charge : formats Jaeger, Zipkin ou OTLP.

1. Ouvrez l'Inspector.

1. Inspectez les résultats de la requête du journal. Affinez les résultats jusqu'à ce que vous voyiez les journaux bruts que vous souhaitez exporter.

1. Choisissez **Télécharger les journaux**.

**Inspectez les performances des requêtes**

L'onglet **Statistiques** affiche des statistiques qui indiquent la durée de votre requête, le nombre de requêtes que vous envoyez et le nombre de lignes renvoyées. Ces informations peuvent vous aider à résoudre vos requêtes, en particulier si l'un des chiffres est élevé ou faible de façon inattendue.

Les statistiques sont affichées en lecture seule.

**Afficher le modèle JSON**

Vous pouvez explorer et exporter des données ainsi que des modèles JSON de blocs de données.

**Pour afficher le modèle JSON**

1. Dans le panneau Inspector, cliquez sur l'onglet **JSON**.

1. **Dans le menu déroulant Sélectionner la source**, choisissez l'une des options suivantes :
   + **Données** — Affiche un objet JSON représentant les données renvoyées à Explore.
   + **DataFrame structure** — Affiche le jeu de résultats bruts.

1. Vous pouvez développer ou réduire des parties du JSON pour afficher des sections distinctes. Vous pouvez également sélectionner l'option **Copier dans le presse-papiers pour** copier le corps du fichier JSON et le coller dans une autre application.

**Afficher la demande brute et la réponse à la source de données**

Lorsque vous utilisez Explore et l'onglet Inspector, vous pouvez consulter les données brutes de demande et de réponse que vous générez avec une requête. Dans l'Inspector, sélectionnez l'onglet **Requête** et choisissez **Actualiser** pour afficher les données brutes.

Grafana envoie la requête au serveur et affiche le résultat. Vous pouvez accéder à des parties spécifiques de la requête, les développer ou les réduire toutes, ou copier les données dans le presse-papiers pour les utiliser dans d'autres applications.

# Corrélations dans Grafana version 10
<a name="v10-correlations"></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 créer des liens interactifs pour les visualisations Explore afin d'exécuter des requêtes relatives aux données présentées en configurant des corrélations.

Une corrélation définit la manière dont les données d'une source de données sont utilisées pour interroger les données d'une autre source de données. Voici quelques exemples :
+ Le nom d'une application renvoyé dans une source de données de journaux peut être utilisé pour interroger les métriques associées à cette application dans une source de données de métriques.
+ Un nom d'utilisateur renvoyé par une source de données SQL peut être utilisé pour interroger les journaux relatifs à cet utilisateur en particulier dans une source de données de journaux.

Explore utilise des corrélations définies par l'utilisateur pour afficher des liens dans les visualisations. Vous pouvez cliquer sur un lien pour exécuter la requête correspondante et voir les résultats dans Explore Split View.

Explorez les visualisations qui prennent actuellement en charge l'affichage de liens en fonction de corrélations :
+ [Journaux](v10-panels-logs.md)
+ [Table](v10-panels-table.md)

[Vous pouvez configurer les corrélations à l'aide de la page **Administration > Plug-ins et données > Corrélations** dans Grafana ou directement dans Explore.](v10-explore-correlations.md)

**Topics**
+ [Configuration de corrélation](v10-correlations-config.md)
+ [Création d'une nouvelle corrélation](v10-correlations-create.md)

# Configuration de corrélation
<a name="v10-correlations-config"></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 corrélation est configurée avec les options suivantes : 

**Étiquette**  
Libellé du lien, affiché dans la visualisation.

**Description**  
Description facultative.

**Source de données source**  
Source des résultats dont les liens sont affichés.

**Champ de résultats**  
Définit l'endroit où le lien est affiché dans une visualisation.

**Requête cible**  
La requête cible est exécutée lorsqu'un lien est cliqué.

**Transformations**  
Manipulations facultatives des données source incluses transmises à la requête cible.

Pour plus de détails sur la création d'une corrélation, voir [Création d'une corrélation](v10-correlations-create.md).

## Source de données source et champ de résultat
<a name="v10-correlations-config-source-and-result"></a>

Les liens apparaissent dans les visualisations Explore pour les résultats issus de la source de données source de la corrélation. Un lien est attribué à l'un des champs à partir du résultat fourni dans la configuration de corrélation (le champ des résultats). Chaque visualisation affiche les champs avec des liens d'une manière différente. 

## Requête cible
<a name="v10-correlations-config-target-query"></a>

La requête cible est exécutée lorsqu'un lien est cliqué dans la visualisation. Vous pouvez utiliser l'éditeur de requêtes de la source de données cible sélectionnée pour spécifier la requête cible. Les résultats des données source sont accessibles dans la requête cible à l'aide de variables.

### Variables de corrélation
<a name="v10-correlations-config-variables"></a>

Vous pouvez utiliser des variables dans la requête cible pour accéder aux données source associées à la requête. Les corrélations utilisent la syntaxe des [variables Grafana](v10-dash-variable-syntax.md). Les variables sont remplies avec les valeurs issues des résultats source lorsque le lien est sélectionné. Vous pouvez utiliser deux types de variables :
+ [Variables de champ](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (pour accéder aux valeurs et aux étiquettes des champs).
+ Variables de corrélation (pour accéder aux valeurs des champs et aux transformations).

Exemple : Si les résultats de la source contiennent un champ appelé`employee`, la valeur du champ est accessible avec :
+ Une variable de champ`${__data.fields.employee}`.
+ Variable de corrélation qui fait correspondre la valeur du champ ci-dessus à`${employee}`.

Outre le mappage des valeurs de champ avec des noms de variables plus courts, il est possible de créer davantage de variables de corrélation en appliquant des transformations aux champs existants.

La corrélation crée un lien de données uniquement si toutes les variables ont des valeurs dans la ligne de données sélectionnée. Les [variables globales](v10-dash-variable-add.md#v10-dash-variable-add-global) font exception à cette règle et il n'est pas nécessaire de les renseigner à partir des données renvoyées. Ces variables sont interpolées automatiquement par les sources de données.

### Transformations de corrélation
<a name="v10-correlations-config-transformations"></a>

Les transformations permettent d'extraire davantage de variables des valeurs de champ. Le résultat des transformations est un ensemble de nouvelles variables accessibles comme n'importe quelle autre variable.

Il existe deux types de transformations : logfmt et expression régulière.

Chaque transformation utilise une valeur de champ sélectionnée comme entrée. Le résultat d'une transformation est un ensemble de nouvelles variables basées sur le type et les options de la transformation.

### Transformation de Logfmt
<a name="v10-correlations-config-logfmt-transformation"></a>

[La transformation logfmt déconstruit une valeur de champ contenant du texte formaté avec des paires clé/valeur logfmt.](https://brandur.org/logfmt) Chaque paire devient une variable, la clé étant le nom de la variable.

La transformation logfmt nécessite uniquement de spécifier le nom du champ de saisie si vous souhaitez que la transformation s'applique à un champ différent du champ de résultats. Exemples de variables de sortie pour `field = "host=srv001 endpoint=/test app=foo"` :


| name | value | 
| --- | --- | 
| hôte | srv001 | 
| point de terminaison | /tester | 
| app | foo | 

### Transformation d'expressions régulières
<a name="v10-correlations-config-regular-expression-transformation"></a>

La transformation de l'expression régulière déconstruit une valeur de champ en fonction de l'expression régulière fournie.

Options de transformation des expressions régulières :

**champ**  
Nom du champ de saisie

**expression**  
Expression régulière. Les groupes de capture nommés sont mappés aux variables correspondant au nom du groupe. Si des groupes correspondants non nommés sont utilisés, une variable est créée à partir de la première correspondance. La valeur remplace la variable correspondant au champ de saisie ou une nouvelle variable est créée si MapValue est fourni (voir les exemples dans le tableau suivant).

**Valeur de la carte**  
Utilisé avec des groupes regex simples sans groupes correspondants nommés. Par défaut, la première correspondance remplace la variable par le nom du champ utilisé comme entrée. Pour modifier ce comportement par défaut, vous pouvez spécifier la propriété MapValue. Le nom fourni est utilisé pour créer une nouvelle variable. Cela peut être utile si votre requête cible nécessite à la fois la valeur exacte et une partie de la valeur extraite avec la transformation.

Exemple : en supposant que le nom du champ sélectionné est `employee` et que la valeur du champ est`John Doe`.

Diverses variables de sortie basées sur les options d'expression et de MapValue :


| expression | Valeur de la carte | variables de sortie | comment | 
| --- | --- | --- | --- | 
| /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | Aucune valeur MapValue n'a été fournie. La première correspondance est mappée à la variable de nom de champ existante (employee). | 
| /(\$1w\$1) (\$1w\$1)/ | name | name=John | La première correspondance est mappée à une nouvelle variable appeléename.  | 
| /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | Lorsque des groupes nommés sont utilisés, ils sont les noms des variables de sortie et MapValue est ignoré. | 
| /(?\$1w\$1) (?\$1w\$1)/ | name | firstName=John, lastName=Doe | Comme ci-dessus | 

# Création d'une nouvelle corrélation
<a name="v10-correlations-create"></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 créer des corrélations dans l'éditeur de corrélations Explore ou en utilisant la page d'**administration** de Grafana dans votre espace de travail Amazon Managed Grafana.

**Conditions préalables**

Vous devez être autorisé à ajouter de nouvelles corrélations. Seuls les utilisateurs autorisés à écrire sur les sources de données peuvent définir de nouvelles corrélations.

## Création d'une corrélation dans l'éditeur de corrélations d'Explore
<a name="v10-correlations-create-explore"></a>

Vous pouvez créer une corrélation dans l'éditeur de corrélation Explore. Pour en savoir plus, consultez [Création d'une corrélation](v10-explore-correlations.md#v10-explore-corr-create-a-correlation).

## Création d'une corrélation dans la page Administration
<a name="v10-correlations-create-administration"></a>

Vous pouvez utiliser la page d'**administration** de la console Grafana pour créer une corrélation.

**Pour créer une corrélation dans la page Administration**

1. Accédez à la section **Administration** de Grafana.

1. Sous **Plugins et données**, ouvrez la page **Corrélations**.

1. Cliquez sur le bouton **Ajouter** dans le coin supérieur droit.

1. Fournissez une **étiquette** pour la corrélation.

1. (Facultatif) Fournissez une **description**.

1. Passez à la page suivante.

1. Fournissez une **source de données cible**.

1. Fournissez une **requête cible** à l'aide de variables.

1. Passez à la page suivante.

1. Fournissez **la source de données source**.

1. Fournissez un **champ de résultats**.

1. Ajoutez des transformations si vous avez besoin de variables autres que des champs dans la source de données source.

1. Choisissez **Ajouter** pour ajouter une nouvelle transformation.

1. Sélectionnez le type de transformation.

1. Configurez la transformation en fonction du type sélectionné.

1. Enregistrez la corrélation.

Vous pouvez modifier une corrélation de la même manière, mais lors de la modification, vous ne pouvez pas modifier les sources de données sélectionnées.

# Alertes dans la version 10 de Grafana
<a name="v10-alerts"></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)

Avec Grafana v10, Amazon Managed Grafana inclut l'accès à un système d'alerte mis à jour, Grafana alerting, qui centralise les *informations d'alerte dans une vue* unique consultable. L'alerte Grafana a été introduite en tant que fonctionnalité optionnelle dans Grafana v8 et GrafanaLabs a annoncé la suppression des anciennes alertes dans la version 11.

**Note**  
Cette documentation couvre les alertes Grafana. Pour plus d'informations sur les anciennes alertes, consultez[Alertes classiques sur le tableau](old-alerts-overview.md).

Grafana Alerting vous permet de vous renseigner sur les problèmes de vos systèmes quelques instants après leur apparition.

Surveillez vos données de mesures entrantes ou vos entrées de journal et configurez votre système d'alerte pour qu'il surveille des événements ou des circonstances spécifiques, puis envoie des notifications lorsque ces éléments sont détectés.

De cette façon, vous éliminez le besoin de surveillance manuelle et vous offrez une première ligne de défense contre les pannes ou les modifications du système susceptibles de se transformer en incidents majeurs.

Grafana Alerting vous permet de créer des requêtes et des expressions à partir de plusieurs sources de données, quel que soit l'endroit où vos données sont stockées, ce qui vous permet de combiner vos données et d'émettre des alertes sur vos indicateurs et journaux de manière nouvelle et unique. Vous pouvez ensuite créer, gérer et agir sur vos alertes à partir d'une vue consolidée unique, et améliorer la capacité de votre équipe à identifier et à résoudre les problèmes rapidement.

Avec les règles d'alerte Mimir et Loki, vous pouvez exécuter des expressions d'alerte au plus près de vos données et à grande échelle, le tout géré par l'interface utilisateur de Grafana que vous connaissez déjà.

**Note**  
Si vous migrez depuis une version antérieure de Grafana, dans laquelle vous utilisiez l'ancienne alerte Grafana, vous trouverez peut-être utile de voir les [différences entre l'ancienne alerte et la nouvelle alerte](v10-alerting-use-grafana-alerts.md#v10-alerting-diff-old-new) Grafana.

## Caractéristiques et avantages clés
<a name="v10-alerting-key-features"></a>

**Une seule page pour toutes les alertes**

Une seule page d'alerte Grafana regroupe en un seul endroit les alertes gérées par Grafana et les alertes résidant dans votre source de données compatible avec Prometheus.

**Alertes multidimensionnelles**

Les règles d'alerte peuvent créer plusieurs instances d'alerte individuelles par règle d'alerte, appelées alertes multidimensionnelles, ce qui vous donne la puissance et la flexibilité nécessaires pour obtenir une visibilité sur l'ensemble de votre système avec une seule règle d'alerte. Pour ce faire, ajoutez des étiquettes à votre requête afin de spécifier le composant surveillé et de générer plusieurs instances d'alerte pour une seule règle d'alerte. Par exemple, si vous souhaitez surveiller chaque serveur d'un cluster, une alerte multidimensionnelle alertera sur chaque processeur, tandis qu'une alerte standard alertera sur l'ensemble du serveur.

**Alertes d'itinéraire**

Acheminez chaque instance d'alerte vers un point de contact spécifique en fonction des étiquettes que vous définissez. Les politiques de notification sont un ensemble de règles indiquant où, quand et comment les alertes sont acheminées vers les points de contact.

**Alertes de silence**

Les silences empêchent la création de notifications et ne durent que pendant une période spécifiée. Les silences vous permettent de ne plus recevoir de notifications persistantes provenant d'une ou de plusieurs règles d'alerte. Vous pouvez également suspendre partiellement une alerte en fonction de certains critères. Les silences disposent de leur propre section dédiée pour une meilleure organisation et une meilleure visibilité, afin que vous puissiez analyser les règles relatives aux alertes suspendues sans encombrer la vue principale des alertes.

**Horaire du mode muet**

Un temps de sourdine est un intervalle de temps récurrent pendant lequel aucune nouvelle notification relative à une politique n'est générée ou envoyée. Utilisez-les pour empêcher les alertes de se déclencher pendant une période spécifique et récurrente, par exemple une période de maintenance régulière.

À l'instar des silences, le temps de mise en sourdine n'empêche pas l'évaluation des règles d'alerte, ni l'affichage des instances d'alerte dans l'interface utilisateur. Ils empêchent uniquement la création de notifications.

## Concevez votre système d'alerte
<a name="v10-alerting-design"></a>

Il est difficile de surveiller des systèmes informatiques complexes et de déterminer si tout fonctionne correctement. La mise en place d'un système de gestion des alertes efficace est donc essentielle pour vous informer en cas de problème avant que cela n'ait un impact sur les résultats de votre entreprise.

La conception et la configuration d'une configuration de gestion des alertes qui fonctionne prennent du temps.

Voici quelques conseils pour créer une configuration de gestion des alertes efficace pour votre entreprise :

**Quels sont les indicateurs clés de votre entreprise que vous souhaitez surveiller et sur lesquels vous souhaitez émettre des alertes ?**
+ Trouvez les événements qu'il est important de connaître et qui ne sont pas anodins ou fréquents au point que les destinataires les ignorent.
+ Les alertes ne doivent être créées que pour les grands événements nécessitant une attention ou une intervention immédiate.
+ Privilégiez la qualité à la quantité.

**Quel type d'alerte souhaitez-vous utiliser ?**
+ Choisissez entre les alertes gérées par Grafana ou les alertes gérées par Grafana Mimir ou Loki, ou les deux.

**Comment souhaitez-vous organiser vos alertes et notifications ?**
+ Soyez sélectif quant aux personnes que vous configurez pour recevoir les alertes. Envisagez de les envoyer à la personne qui vous appelle ou à une chaîne Slack spécifique.
+ Automatisez autant que possible en utilisant l'API d'alerte ou les alertes sous forme de code (Terraform).

**Comment réduire la fatigue liée aux alertes ?**
+ Évitez les alertes bruyantes et inutiles en utilisant des silences, des temporisations muettes ou en interrompant l'évaluation des règles d'alerte.
+ Ajustez en permanence vos règles d'alerte pour vérifier leur efficacité. Supprimez les règles d'alerte pour éviter les doublons ou les alertes inefficaces.
+ Réfléchissez bien aux niveaux de priorité et de gravité.
+ Passez en revue en permanence vos seuils et vos règles d'évaluation.

## Limites des alertes Grafana
<a name="v10-alerting-limitations"></a>
+ Lors de l'agrégation de règles provenant d'autres systèmes, le système d'alerte Grafana peut récupérer les règles de toutes les sources de données Amazon Managed Service pour Prometheus, Prometheus, Loki et Alertmanager disponibles. Il se peut qu'il ne soit pas en mesure d'extraire les règles d'autres sources de données prises en charge.

**Topics**
+ [Caractéristiques et avantages clés](#v10-alerting-key-features)
+ [Concevez votre système d'alerte](#v10-alerting-design)
+ [Limites des alertes Grafana](#v10-alerting-limitations)
+ [Présentation de](v10-alerting-overview.md)
+ [Configurer les alertes](v10-alerting-setup.md)
+ [Configuration des alertes](v10-alerting-configure.md)
+ [Gérez vos alertes](v10-alerting-manage.md)

# Présentation de
<a name="v10-alerting-overview"></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)

Que vous débutiez ou que vous soyez un utilisateur plus expérimenté de Grafana Alerting, découvrez les principes fondamentaux et les fonctionnalités disponibles qui vous aident à créer, gérer et répondre aux alertes, et à améliorer la capacité de votre équipe à résoudre rapidement les problèmes.

## Principes
<a name="v10-alerting-overview-principles"></a>

Dans les systèmes d'alerte basés sur Prometheus, vous disposez d'un générateur d'alertes qui crée des alertes et d'un récepteur d'alertes qui reçoit les alertes. Par exemple, Prometheus est un générateur d'alertes chargé d'évaluer les règles d'alerte, tandis qu'Alertmanager est un récepteur d'alertes chargé de regrouper, d'inhiber, de désactiver et d'envoyer des notifications concernant le déclenchement et la résolution des alertes.

Grafana Alerting est basé sur le modèle Prometheus de conception de systèmes d'alerte. Il dispose d'un générateur d'alertes interne chargé de planifier et d'évaluer les règles d'alerte, ainsi que d'un récepteur d'alertes interne chargé de regrouper, d'inhiber, de désactiver et d'envoyer des notifications. Grafana n'utilise pas Prometheus comme générateur d'alertes car Grafana Alerting doit fonctionner avec de nombreuses autres sources de données en plus de Prometheus. Cependant, il utilise Alertmanager comme récepteur d'alertes.

Les alertes sont envoyées au récepteur d'alertes où elles sont acheminées, groupées, inhibées, réduites au silence et notifiées. Dans Grafana Alerting, le récepteur d'alerte par défaut est le gestionnaire d'alertes intégré à Grafana, appelé Grafana Alertmanager. Cependant, vous pouvez également utiliser d'autres gestionnaires d'alertes, appelés gestionnaires d'alertes [externes](v10-alerting-setup-alertmanager.md).

## Principes fondamentaux
<a name="v10-alerting-overview-fundamentals"></a>

Vous trouverez ci-dessous un aperçu des différentes parties de l'alerte Grafana.

### Règles d'alerte
<a name="v10-alerting-overview-alert-rules"></a>

Une règle d'alerte est un ensemble de critères qui déterminent le moment où une alerte doit être déclenchée. Il comprend une ou plusieurs requêtes et expressions, une condition qui doit être remplie, un intervalle qui détermine la fréquence à laquelle la règle d'alerte est évaluée et une durée pendant laquelle la condition doit être remplie pour qu'une alerte se déclenche.

Les règles d'alerte sont évaluées sur leur intervalle, et chaque règle d'alerte peut être déclenchée par zéro, une ou plusieurs alertes à la fois. L'état de la règle d'alerte est déterminé par le niveau `severe` d'alerte le plus élevé, qui peut être normal, en attente ou en cours de déclenchement. Par exemple, si au moins une des alertes d'une règle d'alerte est déclenchée, la règle d'alerte est également déclenchée. L'état d'une règle d'alerte est déterminé par le statut de sa dernière évaluation. Elles peuvent être OK, Error et NoData.

Une caractéristique très importante des règles d'alerte est qu'elles prennent en charge les annotations et les étiquettes personnalisées. Ils vous permettent d'instrumenter les alertes à l'aide de métadonnées supplémentaires telles que des résumés et des descriptions, et d'ajouter des étiquettes supplémentaires pour acheminer les alertes vers des politiques de notification spécifiques.

### Alerts (Alertes)
<a name="v10-alerting-overview-alerts"></a>

Les alertes sont identifiées de manière unique par des ensembles de key/value paires appelés étiquettes. Chaque clé est un nom d'étiquette et chaque valeur est une valeur d'étiquette. Par exemple, une alerte peut avoir les étiquettes `foo=bar` et une autre les avoir`foo=baz`. Une alerte peut avoir plusieurs étiquettes, par exemple`foo=bar,bar=baz`, mais elle ne peut pas avoir deux fois la même étiquette, par exemple`foo=bar,foo=baz`. Deux alertes ne peuvent pas non plus avoir les mêmes étiquettes, et si deux alertes ont les mêmes étiquettes, telles `foo=bar,bar=baz` que `foo=bar,bar=baz` et, l'une des alertes sera supprimée. Les alertes sont résolues lorsque la condition de la règle d'alerte n'est plus remplie ou lorsque la règle d'alerte est supprimée.

Dans Grafana Managed Alerts, les alertes peuvent être en état normal, en attente, en alerte, sans données ou en état d'erreur. Dans les alertes gérées par des sources de données, telles que Mimir et Loki, les alertes peuvent être en mode normal, en attente et en mode alerte, mais pas NoData ou en erreur.

### Points de contact
<a name="v10-alerting-overview-contact-points"></a>

Les points de contact déterminent où les notifications sont envoyées. Par exemple, vous pouvez avoir un point de contact qui envoie des notifications à une adresse e-mail, à Slack, à un système de gestion des incidents (IRM) tel que Grafana OnCall ou Pagerduty, ou à un webhook.

Les notifications envoyées depuis les points de contact peuvent être personnalisées à l'aide de modèles de notification. Vous pouvez utiliser des modèles de notification pour modifier le titre, le message et la structure de la notification. Les modèles de notification ne sont pas spécifiques à des intégrations ou à des points de contact individuels.

### Politiques de notification
<a name="v10-alerting-overview-notification-policies"></a>

Les politiques de notification regroupent les alertes puis les acheminent vers les points de contact. Ils déterminent à quel moment les notifications sont envoyées et à quelle fréquence les notifications doivent être répétées.

Les alertes sont mises en correspondance avec les politiques de notification à l'aide de correcteurs d'étiquettes. Il s'agit d'expressions lisibles par l'homme qui indiquent si les libellés de l'alerte correspondent exactement, ne correspondent pas exactement, contiennent ou ne contiennent pas le texte attendu. Par exemple, le matcher fait `foo=bar` correspondre les alertes à l'étiquette `foo=bar` tandis qu'il `foo=~[a-zA-Z]+` associe les alertes à n'importe quelle étiquette appelée foo dont la valeur correspond à l'expression régulière. `[a-zA-Z]+`

Par défaut, une alerte ne peut correspondre qu'à une seule politique de notification. Cependant, grâce à `continue` cette fonctionnalité, des alertes peuvent être créées pour correspondre à un certain nombre de politiques de notification en même temps. Pour plus d'informations sur les politiques de notification, consultez la section [Politiques de notification](v10-alerting-explore-notifications-policies-details.md).

### Silences et temps de sourdine
<a name="v10-alerting-overview-silences-and-mute-timings"></a>

Les silences et les durées de sourdine vous permettent de suspendre les notifications pour des alertes spécifiques ou même pour des politiques de notification complètes. Utilisez le silence pour suspendre les notifications de manière ponctuelle, par exemple lorsque vous travaillez sur le correctif d'une alerte, et utilisez le mode muet pour suspendre les notifications à intervalles réguliers, par exemple pendant les fenêtres de maintenance planifiées régulièrement.

**Topics**
+ [Principes](#v10-alerting-overview-principles)
+ [Principes fondamentaux](#v10-alerting-overview-fundamentals)
+ [Sources de données et alertes Grafana](v10-alerting-overview-datasources.md)
+ [Alertes sur les données numériques](v10-alerting-overview-numeric.md)
+ [Étiquettes et annotations](v10-alerting-overview-labels.md)
+ [À propos des règles d'alerte](v10-alerting-explore-rules.md)
+ [Gestionnaire d'alertes](v10-alerting-explore-alertmanager.md)
+ [Points de contact](v10-alerting-explore-contacts.md)
+ [Notifications](v10-alerting-explore-notifications.md)
+ [Alerter la haute disponibilité](v10-alerting-explore-high-availability.md)

# Sources de données et alertes Grafana
<a name="v10-alerting-overview-datasources"></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 certain nombre de sources de données sont compatibles avec Grafana Alerting. Chaque source de données est prise en charge par un plugin. Les alertes Grafana nécessitent que les plugins de source de données soient des plugins de *backend*, afin d'évaluer les règles à l'aide de la source de données, car le moteur d'évaluation s'exécute sur le backend. Les plugins doivent également spécifier qu'ils sont compatibles avec les alertes Grafana.

Les sources de données sont ajoutées et mises à jour au fil du temps. Les sources de données suivantes sont connues pour être compatibles avec les alertes Grafana.
+ [Connect à une source de CloudWatch données Amazon](using-amazon-cloudwatch-in-AMG.md)
+ [Connectez-vous à une source de données Azure Monitor](using-azure-monitor-in-AMG.md)
+ [Connectez-vous à une source OpenSearch de données Amazon Service](using-Amazon-OpenSearch-in-AMG.md)
+ [Connectez-vous à une source de données Google Cloud Monitoring](using-google-cloud-monitoring-in-grafana.md)
+ [Connectez-vous à une source de données Graphite](using-graphite-in-AMG.md)
+ [Connect à une source de données InfluxDB](using-influxdb-in-AMG.md)
+ [Se connecter à une source de données Loki](using-loki-in-AMG.md)
+ [Connectez-vous à une source de données Microsoft SQL Server](using-microsoft-sql-server-in-AMG.md)
+ [Connect à une source de données MySQL](using-mysql-in-AMG.md)
+ [Connectez-vous à une source de données OpenTSDB](using-opentsdb-in-AMG.md)
+ [Connect à une source de données PostgreSQL](using-postgresql-in-AMG.md)
+ [Connectez-vous à Amazon Managed Service for Prometheus et aux sources de données open source Prometheus](prometheus-data-source.md)
+ [Connectez-vous à une source de données Jaeger](jaeger-data-source.md)
+ [Connect à une source de données Zipkin](zipkin-data-source.md)
+ [Connectez-vous à une source de données Tempo](tempo-data-source.md)
+ [Configuration d'une source TestData de données à des fins de test](testdata-data-source.md)

Pour des informations plus détaillées sur les sources de données et les plug-ins de sources de données dans Amazon Managed Grafana, consultez. [Connexion aux sources de données](AMG-data-sources.md)

# Alertes sur les données numériques
<a name="v10-alerting-overview-numeric"></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)

Cette rubrique décrit comment Grafana gère les alertes basées sur des données numériques plutôt que sur des séries chronologiques.

Parmi certaines sources de données, les données numériques qui ne sont pas des séries chronologiques peuvent être directement alertées ou transmises aux expressions côté serveur (SSE). Cela permet d'améliorer le traitement et l'efficacité qui en résulte au sein de la source de données, tout en simplifiant les règles d'alerte. Lorsque vous lancez une alerte sur des données numériques plutôt que sur des données de séries chronologiques, il n'est pas nécessaire de réduire chaque série chronologique étiquetée en un seul chiffre. Au lieu de cela, les numéros étiquetés sont renvoyés à Grafana.

## Données tabulaires
<a name="v10-alerting-numeric-tabular"></a>

Cette fonctionnalité est prise en charge par les sources de données principales qui interrogent des données tabulaires :
+ Sources de données SQL telles que MySQL, Postgres, MSSQL et Oracle.
+ Les services basés sur Azure Kusto : Azure Monitor (Logs), Azure Monitor (Azure Resource Graph) et Azure Data Explorer.

Une requête avec des alertes gérées par Grafana ou SSE est considérée comme numérique avec ces sources de données, si :
+ L'option « Format AS » est définie sur « Table » dans la requête de source de données.
+ La réponse de table renvoyée à Grafana par la requête inclut une seule colonne numérique (par exemple int, double, float) et éventuellement des colonnes de chaîne supplémentaires.

S'il existe des colonnes de chaînes, ces colonnes deviennent des étiquettes. Le nom d'une colonne devient le nom de l'étiquette, et la valeur de chaque ligne devient la valeur de l'étiquette correspondante. Si plusieurs lignes sont renvoyées, chaque ligne doit être identifiée de manière unique avec son étiquette.

## Exemple
<a name="v10-alerting-numeric-tabexample"></a>

Pour une table MySQL appelée « DiskSpace » :


| Heure | Host (Hôte) | Disk | PercentFree | 
| --- | --- | --- | --- | 
| 7 juin 2021 | web1 | /etc | 3 | 
| 7 juin 2021 | web2 | /var | 4 | 
| 7 juin 2021 | web3 | /var | 8 | 
| ... | ... | ... | ... | 

Vous pouvez interroger le filtrage des données à temps, mais sans renvoyer les séries chronologiques à Grafana. Par exemple, une alerte qui se déclencherait par hôte et par disque lorsqu'il y a moins de 5 % d'espace libre :

```
SELECT Host , Disk , CASE WHEN PercentFree  < 5.0 THEN PercentFree  ELSE 0 END FROM ( 
       SELECT
          Host, 
          Disk, 
          Avg(PercentFree) 
       FROM DiskSpace
       Group By
          Host, 
          Disk 
       Where __timeFilter(Time)
```

Cette requête renvoie la réponse de table suivante à Grafana :


| Host (Hôte) | Disk | PercentFree | 
| --- | --- | --- | 
| web1 | /etc | 3 | 
| web2 | /var | 4 | 
| web3 | /var | 0 | 

Lorsque cette requête est utilisée comme **condition** dans une règle d'alerte, une valeur différente de zéro sera signalée. Par conséquent, trois instances d'alerte sont produites :


| Étiquettes | Statut | 
| --- | --- | 
| \$1Host=Web1, disk=/etc\$1 | Alerte | 
| \$1Host=Web2, disk=/var\$1 | Alerte | 
| \$1Host=Web3, disk=/var\$1 | Normal | 

# Étiquettes et annotations
<a name="v10-alerting-overview-labels"></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)

Les étiquettes et les annotations contiennent des informations sur une alerte. Les étiquettes et les annotations ont la même structure : un ensemble de valeurs nommées, mais leurs utilisations prévues sont différentes. Un exemple d'étiquette, ou d'annotation équivalente, pourrait être`alertname="test"`.

La principale différence entre une étiquette et une annotation est que les étiquettes sont utilisées pour différencier une alerte de toutes les autres alertes, tandis que les annotations sont utilisées pour ajouter des informations supplémentaires à une alerte existante.

Par exemple, considérez deux alertes de niveau élevé du processeur : une pour `server1` et une autre pour`server2`. Dans un tel exemple, nous pourrions avoir une étiquette appelée `server` où la première alerte possède l'étiquette `server="server1"` et la deuxième alerte possède l'étiquette`server="server2"`. Cependant, nous souhaiterons peut-être également ajouter une description à chaque alerte`"The CPU usage for server1 is above 75%."`, par exemple où `server1` et où `75%` sont remplacés par le nom et l'utilisation du processeur du serveur (veuillez consulter la documentation [Création de modèles d'étiquettes et d'annotations](v10-alerting-overview-labels-templating.md) pour savoir comment procéder). Ce type de description serait plus approprié sous forme d'annotation.

## Étiquettes
<a name="v10-alerting-overview-labels-labels"></a>

Les étiquettes contiennent des informations qui identifient une alerte. Un exemple d'étiquette pourrait être`server=server1`. Chaque alerte peut avoir plusieurs étiquettes, et l'ensemble complet d'étiquettes d'une alerte est appelé son ensemble d'étiquettes. C'est ce jeu d'étiquettes qui identifie l'alerte.

Par exemple, une alerte peut avoir l'étiquette définie `{alertname="High CPU usage",server="server1"}` alors qu'une autre alerte peut avoir l'étiquette définie`{alertname="High CPU usage",server="server2"}`. Il s'agit de deux alertes distinctes, car même si leurs `alertname` étiquettes sont identiques, elles sont différentes. `server`

L'étiquette définie pour une alerte est une combinaison des étiquettes de la source de données, des étiquettes personnalisées de la règle d'alerte et d'un certain nombre d'étiquettes réservées telles que`alertname`.

**Étiquettes personnalisées**

Les libellés personnalisés sont des libellés supplémentaires issus de la règle d'alerte. Tout comme les annotations, les étiquettes personnalisées doivent avoir un nom, et leur valeur peut contenir une combinaison de texte et de code modèle qui est évalué lorsqu'une alerte est déclenchée. La documentation sur la façon de modéliser des étiquettes personnalisées est disponible [ici](v10-alerting-overview-labels-templating.md).

Lorsque vous utilisez des étiquettes personnalisées avec des modèles, il est important de veiller à ce que la valeur de l'étiquette ne change pas entre les évaluations consécutives de la règle d'alerte, car cela finira par créer un grand nombre d'alertes distinctes. Cependant, le modèle peut générer différentes valeurs d'étiquette pour différentes alertes. Par exemple, ne mettez pas la valeur de la requête dans une étiquette personnalisée car cela finira par créer un nouvel ensemble d'alertes chaque fois que la valeur change. Utilisez plutôt des annotations.

Il est également important de s'assurer que l'étiquette définie pour une alerte ne comporte pas deux étiquettes ou plus portant le même nom. Si une étiquette personnalisée porte le même nom qu'une étiquette de la source de données, elle remplacera cette étiquette. Toutefois, si une étiquette personnalisée porte le même nom qu'une étiquette réservée, l'étiquette personnalisée sera omise de l'alerte.

## Annotations
<a name="v10-alerting-overview-labels-annotations"></a>

Les annotations sont des paires nommées qui ajoutent des informations supplémentaires aux alertes existantes. Il existe un certain nombre d'annotations suggérées dans Grafana`summary`, `description` telles que,`runbook_url`, `dashboardUId` et. `panelId` Tout comme les étiquettes personnalisées, les annotations doivent avoir un nom, et leur valeur peut contenir une combinaison de texte et de code modèle qui est évalué lorsqu'une alerte est déclenchée. Si une annotation contient un code de modèle, le modèle est évalué une seule fois lorsque l'alerte est déclenchée. Elle n'est pas réévaluée, même lorsque l'alerte est résolue. La documentation sur la façon de modéliser des annotations est disponible [ici](v10-alerting-overview-labels-templating.md).

**Topics**
+ [Étiquettes](#v10-alerting-overview-labels-labels)
+ [Annotations](#v10-alerting-overview-labels-annotations)
+ [Comment fonctionne la correspondance des étiquettes](v10-alerting-overview-labels-matching.md)
+ [Étiquettes dans Grafana Alerting](v10-alerting-overview-labels-alerting.md)
+ [Création de modèles d'étiquettes et d'annotations](v10-alerting-overview-labels-templating.md)

# Comment fonctionne la correspondance des étiquettes
<a name="v10-alerting-overview-labels-matching"></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)

Utilisez des étiquettes et des outils de comparaison d'étiquettes pour lier les règles d'alerte aux politiques de notification et aux silences. Cela permet de gérer vos instances d'alerte de manière très flexible, de spécifier la politique qui doit les gérer et les alertes à désactiver.

Un analyseur d'étiquettes se compose de 3 parties distinctes : l'**étiquette**, la **valeur** et l'**opérateur**.
+ Le champ **Label** est le nom de l'étiquette à associer. Il doit correspondre exactement au nom de l'étiquette.
+ Le champ **Valeur** correspond à la valeur correspondante pour le nom d'**étiquette** spécifié. La correspondance dépend de la valeur de l'**opérateur**.
+ Le champ **Opérateur** est l'opérateur à comparer à la valeur de l'étiquette. Les opérateurs disponibles sont les suivants :


| Opérateur | Description | 
| --- | --- | 
| `=` | Sélectionnez des étiquettes exactement égales à la valeur. | 
| `!=` | Sélectionnez des étiquettes qui ne sont pas égales à la valeur. | 
| `=~` | Sélectionnez les libellés qui correspondent à la valeur par regex. | 
| `!~` | Sélectionnez les libellés qui ne correspondent pas à la valeur par regex. | 

Si vous utilisez plusieurs correspondants d'étiquettes, ils sont combinés à l'aide de l'opérateur logique AND. Cela signifie que tous les matchers doivent correspondre afin de lier une règle à une politique.

## Exemple
<a name="v10-alerting-overview-labels-matching-ex"></a>

Si vous définissez le jeu d'étiquettes suivant pour votre alerte :

```
{ foo=bar, baz=qux, id=12 }
```

puis :
+ Un comparateur d'étiquettes défini comme `foo=bar` correspond à cette règle d'alerte.
+ Un comparateur d'étiquettes défini comme `foo!=bar` ne correspond *pas* à cette règle d'alerte.
+ Un comparateur d'étiquettes défini comme `id=~[0-9]+` correspond à cette règle d'alerte.
+ Un comparateur d'étiquettes défini comme `baz!~[0-9]+` correspond à cette règle d'alerte.
+ Deux marqueurs d'étiquettes définis `foo=bar` et conformes à `id=~[0-9]+` cette règle d'alerte.

## Exclure les étiquettes
<a name="v10-alerting-overview-labels-matching-exclude"></a>

Vous pouvez également écrire des correspondances d'étiquettes pour exclure des étiquettes.

Voici un exemple qui montre comment exclure l'étiquette`team`. Vous pouvez choisir l'une de ces valeurs pour exclure l'étiquette.
+ `team=""`
+ `team!~.+`
+ `team=~^$`

# Étiquettes dans Grafana Alerting
<a name="v10-alerting-overview-labels-alerting"></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 explique pourquoi les étiquettes sont un élément fondamental des alertes.
+ L'ensemble complet d'étiquettes pour une alerte est ce qui identifie de manière unique une alerte dans les alertes Grafana.
+ Le gestionnaire d'alertes utilise des étiquettes pour faire correspondre les alertes relatives aux silences et aux groupes d'alertes dans les politiques de notification.
+ L'interface utilisateur d'alerte affiche des étiquettes pour chaque instance d'alerte générée lors de l'évaluation de cette règle.
+ Les points de contact peuvent accéder aux étiquettes pour générer dynamiquement des notifications contenant des informations spécifiques à l'alerte qui entraîne une notification.
+ Vous pouvez ajouter des libellés à une [règle d'alerte](v10-alerting-configure.md). Les étiquettes sont configurables manuellement, utilisent des fonctions de modèle et peuvent faire référence à d'autres étiquettes. Les étiquettes ajoutées à une règle d'alerte ont priorité en cas de collision entre étiquettes (sauf dans le cas des étiquettes réservées Grafana, voir ci-dessous pour plus d'informations).

## Compatibilité avec Alertmanager externe
<a name="v10-alerting-overview-labels-alerting-external"></a>

Le gestionnaire d'alertes intégré de Grafana prend en charge à la fois les clés et les valeurs d'étiquette Unicode. [Si vous utilisez un Prometheus Alertmanager externe, les clés d'étiquette doivent être compatibles avec leur modèle de données.](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) Cela signifie que les clés d'étiquette ne doivent contenir que des **lettres ASCII, des** **chiffres** et des traits de **soulignement** et correspondre à l'expression régulière. `[a-zA-Z_][a-zA-Z0-9_]*` Tout caractère non valide sera supprimé ou remplacé par le moteur d'alerte Grafana avant d'être envoyé au gestionnaire d'alertes externe conformément aux règles suivantes :
+ `Whitespace`sera supprimé.
+ `ASCII characters`sera remplacé par`_`.
+ `All other characters`seront remplacés par leur représentation hexadécimale en minuscules. S'il s'agit du premier caractère, il sera préfixé par`_`.

**Note**  
Si plusieurs clés d'étiquette sont nettoyées à la même valeur, les doublons porteront un court hachage de l'étiquette d'origine ajouté en tant que suffixe.

## Étiquettes réservées Grafana
<a name="v10-alerting-overview-labels-alerting-reserved"></a>

**Note**  
Les étiquettes préfixées par `grafana_` sont réservées par Grafana pour un usage spécial. Si une étiquette configurée manuellement est ajoutée en commençant par, `grafana_` elle sera remplacée en cas de collision.

Les étiquettes réservées Grafana peuvent être utilisées de la même manière que les étiquettes configurées manuellement. La liste actuelle des labels réservés disponibles est la suivante :


| Étiquette | Description | 
| --- | --- | 
| dossier grafana | Titre du dossier contenant l'alerte. | 

# Création de modèles d'étiquettes et d'annotations
<a name="v10-alerting-overview-labels-templating"></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 modèles pour inclure des données issues de requêtes et d'expressions dans des étiquettes et des annotations. Par exemple, vous pouvez définir l'étiquette de gravité d'une alerte en fonction de la valeur de la requête, ou utiliser l'étiquette d'instance de la requête dans une annotation récapitulative afin de savoir quel serveur utilise beaucoup le processeur.

Tous les modèles doivent être écrits en [texte/modèle](https://pkg.go.dev/text/template). Que vous modélisiez une étiquette ou une annotation, vous devez écrire chaque modèle en ligne à l'intérieur de l'étiquette ou de l'annotation que vous modélisez. Cela signifie que vous ne pouvez pas partager de modèles entre les étiquettes et les annotations, mais que vous devez copier les modèles là où vous souhaitez les utiliser.

Chaque modèle est évalué chaque fois que la règle d'alerte est évaluée, et est évalué séparément pour chaque alerte. Par exemple, si votre règle d'alerte comporte un modèle d'annotation récapitulative et qu'elle comporte 10 alertes déclenchées, le modèle sera exécuté 10 fois, une fois pour chaque alerte. Vous devriez essayer d'éviter autant que possible d'effectuer des calculs coûteux dans vos modèles.

## Exemples
<a name="v10-alerting-overview-labels-templating-examples"></a>

Plutôt que d'écrire un didacticiel complet, text/template, the following examples attempt to show the most common use-cases we have seen for templates. You can use these examples verbatim, or adapt them as necessary for your use case. For more information about how to write text/template consultez la documentation [texte/modèle](https://pkg.go.dev/text/template).

**Imprimer toutes les étiquettes, séparées par des virgules**

Pour imprimer toutes les étiquettes, séparées par des virgules, imprimez la `$labels` variable :

```
{{ $labels }}
```

Par exemple, si vous recevez une alerte avec les étiquettes `alertname=High CPU usage``instance=server1`, `grafana_folder=CPU alerts` cela imprimerait : 

```
alertname=High CPU usage, grafana_folder=CPU alerts, instance=server1
```

**Note**  
Si vous utilisez `$labels` des conditions classiques, la requête ne contiendra aucune étiquette. Reportez-vous à [la variable \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) pour plus d'informations.

**Imprimez toutes les étiquettes, une par ligne**

Pour imprimer toutes les étiquettes, une par ligne, utilisez a `range` pour itérer sur chaque key/value paire et imprimez-les individuellement. Ici `$k` fait référence au nom et `$v` à la valeur de l'étiquette actuelle : 

```
{{ range $k, $v := $labels -}}
{{ $k }}={{ $v }}
{{ end }}
```

Par exemple, si vous recevez une alerte avec les étiquettes `alertname=High CPU usage``instance=server1`, `grafana_folder=CPU alerts` cela imprimerait :

```
alertname=High CPU usage
grafana_folder=CPU alerts
instance=server1
```

**Note**  
Si vous utilisez `$labels` des conditions classiques, la requête ne contiendra aucune étiquette. Reportez-vous à [la variable \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) pour plus d'informations.

**Imprimer une étiquette individuelle**

Pour imprimer une étiquette individuelle, utilisez la `index` fonction avec la `$labels` variable : 

```
The host {{ index $labels "instance" }} has exceeded 80% CPU usage for the last 5 minutes
```

Par exemple, étant donné une alerte avec l'étiquette`instance=server1`, cela imprimerait :

```
The host server1 has exceeded 80% CPU usage for the last 5 minutes
```

**Note**  
Si vous utilisez `$labels` des conditions classiques, la requête ne contiendra aucune étiquette. Reportez-vous à [la variable \$1labels](#v10-alerting-overview-labels-templating-the-labels-variable) pour plus d'informations.

**Imprimer la valeur d'une requête**

Pour imprimer la valeur d'une requête instantanée, vous pouvez imprimer son ID de référence à l'aide de la `index` fonction et de la `$values` variable : 

```
{{ index $values "A" }}
```

Par exemple, étant donné une requête instantanée qui renvoie la valeur 81,2345, ceci affichera :

```
81.2345
```

Pour imprimer la valeur d'une requête par plage, vous devez d'abord la réduire d'une série chronologique à un vecteur instantané avec une expression de réduction. Vous pouvez ensuite imprimer le résultat de l'expression de réduction en utilisant plutôt son ID de référence. Par exemple, si l'expression de réduction prend la moyenne de A et a l'ID de référence B, vous devez écrire : 

```
{{ index $values "B" }}
```

**Imprimer la valeur humanisée d'une requête**

Pour imprimer la valeur humanisée d'une requête instantanée, utilisez la `humanize` fonction :

```
{{ humanize (index $values "A").Value }}
```

Par exemple, étant donné une requête instantanée qui renvoie la valeur 81,2345, ceci affichera : 

```
81.234
```

Pour imprimer la valeur humanisée d'une requête par plage, vous devez d'abord la réduire d'une série chronologique à un vecteur instantané avec une expression de réduction. Vous pouvez ensuite imprimer le résultat de l'expression de réduction en utilisant plutôt son ID de référence. Par exemple, si l'expression de réduction prend la moyenne de A et a l'ID de référence B, vous devez écrire : 

```
{{ humanize (index $values "B").Value }}
```

**Imprimer la valeur d'une requête sous forme de pourcentage**

Pour imprimer la valeur d'une requête instantanée sous forme de pourcentage, utilisez la `humanizePercentage` fonction :

```
{{ humanizePercentage (index $values "A").Value }}
```

Cette fonction s'attend à ce que la valeur soit un nombre décimal compris entre 0 et 1. Si la valeur est plutôt un nombre décimal compris entre 0 et 100, vous pouvez la diviser par 100 dans votre requête ou à l'aide d'une expression mathématique. Si la requête est une requête par plage, vous devez d'abord la réduire d'une série chronologique à un vecteur instantané avec une expression de réduction.

**Définir une sévérité à partir de la valeur d'une requête**

Pour définir une étiquette de gravité à partir de la valeur d'une requête, utilisez une instruction if et la fonction de comparaison supérieure à celle de comparaison. Assurez-vous d'utiliser des décimales (`80.0`,, `50.0``0.0`, etc.) lorsque vous effectuez des comparaisons avec `$values` car cela text/template ne prend pas en charge la coercition de type. Vous trouverez une liste de toutes les fonctions de comparaison prises en charge [ici](https://pkg.go.dev/text/template#hdr-Functions).

```
{{ if (gt $values.A.Value 80.0) -}}
high
{{ else if (gt $values.A.Value 50.0) -}}
medium
{{ else -}}
low
{{- end }}
```

**Imprimez toutes les étiquettes à partir d'un état classique**

Vous ne pouvez pas utiliser `$labels` pour imprimer des étiquettes à partir de la requête si vous utilisez des conditions classiques et vous devez les utiliser à la `$values` place. Cela s'explique par le fait que les conditions classiques suppriment ces étiquettes pour imposer un comportement unidimensionnel (au plus une alerte par règle d'alerte). Si les conditions classiques n'éliminaient pas ces étiquettes, les requêtes renvoyant de nombreuses séries chronologiques provoqueraient des interruptions entre le déclenchement et la résolution constante des alertes, car les étiquettes changeaient à chaque fois que la règle d'alerte était évaluée.

Au lieu de cela, la `$values` variable contient les valeurs réduites de toutes les séries chronologiques pour toutes les conditions qui se déclenchent. Par exemple, si vous avez une règle d'alerte avec une requête A qui renvoie deux séries chronologiques, et une condition B classique avec deux conditions, alors `$values` contiendrait `B0``B1`, `B2` et`B3`. Si la condition B classique ne comportait qu'une seule condition, `$values` elle contiendrait uniquement `B0` et`B1`.

Pour imprimer toutes les étiquettes de toutes les séries chronologiques de cuisson, utilisez le modèle suivant (assurez-vous de remplacer `B` l'expression régulière par l'ID de référence de la condition classique s'il est différent) : 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Labels }}{{ end }}
{{ end }}
```

Par exemple, une condition classique pour deux séries chronologiques dépassant une seule condition imprimerait : 

```
B0: instance=server1
B1: instance=server2
```

Si la condition classique comporte deux conditions ou plus et qu'une série chronologique dépasse plusieurs conditions en même temps, ses étiquettes seront dupliquées pour chaque condition dépassée : 

```
B0: instance=server1
B1: instance=server2
B2: instance=server1
B3: instance=server2
```

Si vous devez imprimer des étiquettes uniques, vous devriez plutôt envisager de modifier vos règles d'alerte en les remplaçant par des règles unidimensionnelles par des règles multidimensionnelles. Vous pouvez le faire en remplaçant votre condition classique par des expressions de réduction et mathématiques.

**Imprimer toutes les valeurs d'une condition classique**

Pour imprimer toutes les valeurs d'une condition classique, prenez l'exemple précédent et remplacez-le `$v.Labels` par `$v.Value` : 

```
{{ range $k, $v := $values -}}
{{ if (match "B[0-9]+" $k) -}}
{{ $k }}: {{ $v.Value }}{{ end }}
{{ end }}
```

Par exemple, une condition classique pour deux séries chronologiques dépassant une seule condition imprimerait : 

```
B0: 81.2345
B1: 84.5678
```

Si la condition classique comporte au moins deux conditions et qu'une série chronologique dépasse plusieurs conditions en même temps, elle `$values` contiendra les valeurs de toutes les conditions : 

```
B0: 81.2345
B1: 92.3456
B2: 84.5678
B3: 95.6789
```

## Variables
<a name="v10-alerting-overview-labels-templating-variables"></a>

Les variables suivantes sont à votre disposition lors de la création de modèles d'étiquettes et d'annotations :

### La variable labels
<a name="v10-alerting-overview-labels-templating-the-labels-variable"></a>

La `$labels` variable contient tous les libellés de la requête. Supposons, par exemple, que vous ayez une requête qui renvoie l'utilisation du processeur pour tous vos serveurs, et que vous disposiez d'une règle d'alerte qui se déclenche lorsque l'un de vos serveurs a dépassé 80 % d'utilisation du processeur au cours des 5 dernières minutes. Vous souhaitez ajouter une annotation récapitulative à l'alerte qui indique quel serveur utilise beaucoup le processeur. Avec la `$labels` variable, vous pouvez écrire un modèle qui imprime une phrase lisible par l'homme, telle que : 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes
```

**Note**  
Si vous utilisez une condition classique, `$labels` elle ne contiendra aucune étiquette provenant de la requête. Les conditions classiques suppriment ces étiquettes afin d'imposer un comportement unidimensionnel (au maximum une alerte par règle d'alerte). Si vous souhaitez utiliser les étiquettes de la requête dans votre modèle, suivez l'exemple précédent *Imprimer toutes les étiquettes à partir d'un exemple de condition classique*.

### La variable de valeur
<a name="v10-alerting-overview-labels-templating-the-value-variable"></a>

La `$value` variable est une chaîne contenant les libellés et les valeurs de toutes les requêtes instantanées, les expressions de seuil, de réduction et mathématiques, ainsi que les conditions classiques de la règle d'alerte. Il ne contient pas les résultats des requêtes de plage, car celles-ci peuvent renvoyer de 10 à 10 000 lignes ou métriques. Si tel était le cas, pour des requêtes particulièrement volumineuses, une seule alerte pourrait utiliser des dizaines de secondes MBs de mémoire et Grafana manquerait de mémoire très rapidement.

Pour imprimer la `$value` variable dans le résumé, vous devez écrire quelque chose comme ceci : 

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ $value }}
```

Et cela ressemblerait à ceci :

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: [ var='A' labels={instance=instance1} value=81.234 ]
```

Ici, il `var='A'` fait référence à la requête instantanée avec l'ID de `labels={instance=instance1}` référence A, aux étiquettes et `value=81.234` à l'utilisation moyenne du processeur au cours des 5 dernières minutes.

Si vous souhaitez imprimer une partie de la chaîne au lieu de la chaîne complète, utilisez la `$values` variable. Il contient les mêmes informations que`$value`, mais dans un tableau structuré, et il est beaucoup plus facile à utiliser que d'écrire une expression régulière correspondant exactement au texte souhaité.

### La variable de valeurs
<a name="v10-alerting-overview-labels-templating-the-values-variable"></a>

La `$values` variable est une table contenant les étiquettes et les valeurs à virgule flottante de toutes les requêtes et expressions instantanées, indexées par leur référence. IDs

Pour imprimer la valeur de la requête instantanée avec l'ID de référence A :

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "A" }}
```

Par exemple, à partir d'une alerte avec les libellés `instance=server1` et d'une requête instantanée avec la valeur`81.2345`, ceci imprimerait :

```
CPU usage for instance1 has exceeded 80% for the last 5 minutes: 81.2345
```

Si la requête dans l'ID de référence A est une requête de plage plutôt qu'une requête instantanée, ajoutez une expression de réduction avec l'ID de référence B et remplacez-la par `(index $values "A")` `(index $values "B")` :

```
CPU usage for {{ index $labels "instance" }} has exceeded 80% for the last 5 minutes: {{ index $values "B" }}
```

## Fonctions
<a name="v10-alerting-overview-labels-templating-functions"></a>

Les fonctions suivantes sont à votre disposition lors de la création de modèles d'étiquettes et d'annotations :

**args**

La `args` fonction traduit une liste d'objets en une carte avec les clés arg0, arg1, etc. Cela a pour but de permettre la transmission de plusieurs arguments aux modèles.

```
{{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}
```

```
1 2
```

**URL externe**

La `externalURL` fonction renvoie l'URL externe du serveur Grafana.

```
{{ externalURL }}
```

```
https://example.com/grafana
```

**GraphLink**

La `graphLink` fonction renvoie le chemin d'accès à la vue graphique [Explorez dans la version 10 de Grafana](v10-explore.md) pour l'expression et la source de données données.

```
{{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]
```

**humaniser**

La `humanize` fonction humanise les nombres décimaux.

```
{{ humanize 1000.0 }}
```

```
1k
```

**humaniser 1024**

Il `humanize1024` fonctionne de manière similaire `humanize` mais utilise 1024 comme base au lieu de 1000.

```
{{ humanize1024 1024.0 }}
```

```
1ki
```

**Humaniser la durée**

La `humanizeDuration` fonction humanise une durée en secondes.

```
{{ humanizeDuration 60.0 }}
```

```
1m 0s
```

**Pourcentage d'humanisation**

La `humanizePercentage` fonction humanise une valeur de ratio par rapport à un pourcentage.

```
{{ humanizePercentage 0.2 }}
```

```
20%
```

**Humaniser l'horodatage**

La `humanizeTimestamp` fonction humanise un horodatage Unix.

```
{{ humanizeTimestamp 1577836800.0 }}
```

```
2020-01-01 00:00:00 +0000 UTC
```

**match**

La `match` fonction compare le texte à un modèle d'expression régulière.

```
{{ match "a.*" "abc" }}
```

```
true
```

**Préfixe de chemin**

La `pathPrefix` fonction renvoie le chemin du serveur Grafana.

```
{{ pathPrefix }}
```

```
/grafana
```

**Tableau Link**

La `tableLink` fonction renvoie le chemin d'accès à la vue tabulaire [Explorez dans la version 10 de Grafana](v10-explore.md) pour l'expression et la source de données données.

```
{{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}
```

```
/explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]
```

**title**

La `title` fonction met en majuscule le premier caractère de chaque mot.

```
{{ title "hello, world!" }}
```

```
Hello, World!
```

**ToLower**

La `toLower` fonction renvoie tout le texte en minuscules.

```
{{ toLower "Hello, world!" }}
```

```
hello, world!
```

**ToupPper**

La `toUpper` fonction renvoie tout le texte en majuscules.

```
{{ toUpper "Hello, world!" }}
```

```
HELLO, WORLD!
```

**reReplaceAll**

La `reReplaceAll` fonction remplace le texte correspondant à l'expression régulière.

```
{{ reReplaceAll "localhost:(.*)" "example.com:$1" "localhost:8080" }}
```

```
example.com:8080
```

# À propos des règles d'alerte
<a name="v10-alerting-explore-rules"></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 règle d'alerte est un ensemble de critères d'évaluation qui déterminent si une instance d'alerte va se déclencher. La règle comprend une ou plusieurs requêtes et expressions, une condition, la fréquence d'évaluation et la durée pendant laquelle la condition doit être remplie pour commencer à se déclencher.

Alors que les requêtes et les expressions sélectionnent l'ensemble de données à évaluer, une *condition* définit le seuil que les données doivent atteindre ou dépasser pour créer une alerte.

Un *intervalle* indique la fréquence à laquelle une règle d'alerte est évaluée. *La durée*, lorsqu'elle est configurée, indique la durée pendant laquelle une condition doit être remplie. Les règles d'alerte peuvent également définir le comportement des alertes en l'absence de données.

**Topics**
+ [Types de règles d'alerte](v10-alerting-explore-rules-types.md)
+ [Règles d'enregistrement](v10-alerting-explore-rule-recording.md)
+ [Requêtes et conditions](v10-alerting-explore-rules-queries.md)
+ [Instances d'alerte](v10-alerting-rules-instances.md)
+ [Espaces de noms, dossiers et groupes](v10-alerting-rules-grouping.md)
+ [Évaluation des règles d'alerte](v10-alerting-rules-evaluation.md)
+ [État et état des règles d'alerte](v10-alerting-explore-state.md)
+ [Modèle de notification](v10-alerting-rules-notification-templates.md)

# Types de règles d'alerte
<a name="v10-alerting-explore-rules-types"></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 prend en charge plusieurs types de règles d'alerte. Apprenez-en davantage sur chacun des types de règles d'alerte, leur fonctionnement et déterminez celle qui convient le mieux à votre cas d'utilisation.

## Règles gérées par Grafana
<a name="v10-alerting-explore-rule-types-grafana"></a>

Les règles gérées par Grafana sont le type de règle d'alerte le plus flexible. Ils vous permettent de créer des alertes qui peuvent agir sur les données provenant de n'importe laquelle de vos sources de données existantes.

Outre la prise en charge de plusieurs sources de données, vous pouvez ajouter [des expressions](v10-panels-query-xform-expressions.md) pour transformer vos données et exprimer les conditions d'alerte.

Dans Grafana, gestion des alertes :
+ Les règles d'alerte sont créées dans Grafana, sur la base d'une ou de plusieurs sources de données.
+ Les règles d'alerte sont évaluées par le moteur d'évaluation des règles d'alerte depuis Grafana.
+ Les alertes sont diffusées à l'aide du Grafana Alertmanager interne.

**Note**  
Vous pouvez également configurer les alertes à diffuser à l'aide d'un gestionnaire d'alertes externe, ou utiliser à la fois des gestionnaires d'alertes internes et externes. Pour plus d'informations, voir [Ajouter un gestionnaire d'alertes externe](v10-alerting-setup-alertmanager.md).

## Règles de gestion des sources de données
<a name="v10-alerting-explore-rule-types-datasource"></a>

Pour créer des règles d'alerte gérées par une source de données, vous devez disposer d'une source de données Prometheus ou Loki compatible. Vous pouvez vérifier si votre source de données prend en charge la création de règles via Grafana en testant la source de données et en observant si l'API Ruler est prise en charge.

Dans les alertes gérées par les sources de données :
+ Les règles d'alerte sont créées et stockées dans la source de données elle-même.
+ Les règles d'alerte ne peuvent être créées que sur la base des données Prometheus.
+ L'évaluation et la diffusion des règles d'alerte sont réparties sur plusieurs nœuds pour garantir une haute disponibilité et une tolérance aux pannes.

## Choisissez un type de règle d'alerte
<a name="v10-alerting-explore-rule-types-choose"></a>

Lorsque vous choisissez le type de règle d'alerte à utiliser, considérez la comparaison suivante entre les règles d'alerte gérées par Grafana et les règles d'alerte gérées par les sources de données.


| Fonctionnalité | Règle d'alerte gérée par Grafana | Règle d'alerte gérée par Loki/Mimir | 
| --- | --- | --- | 
| Créez des règles d'alerte basées sur les données provenant de l'une de nos sources de données prises en charge | Oui | Non : vous pouvez uniquement créer des règles d'alerte basées sur les données Prometheus. L'API Ruler doit être activée dans la source de données.  | 
| Combinez et associez les sources de données | Oui | Non | 
| Inclut la prise en charge des règles d'enregistrement | Non | Oui | 
| Ajoutez des expressions pour transformer vos données et définir des conditions d'alerte | Oui | Non | 
| Utiliser des images dans les notifications d'alerte | Oui | Non | 
| Mise à l’échelle | Plus gourmands en ressources, dépendent de la base de données et sont susceptibles de présenter des erreurs transitoires. Ils ne sont redimensionnés que verticalement. | Stockez les règles d'alerte dans la source de données elle-même et permettez une mise à l'échelle « infinie ». Générez et envoyez des notifications d'alerte depuis l'emplacement de vos données. | 
| Évaluation et diffusion des règles d'alerte | L'évaluation et la diffusion des règles d'alerte sont effectuées depuis Grafana, en utilisant un Alertmanager externe, ou les deux. | L'évaluation des règles d'alerte et la diffusion des alertes sont distribuées, ce qui signifie qu'il n'existe aucun point de défaillance unique. | 

# Règles d'enregistrement
<a name="v10-alerting-explore-rule-recording"></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)

*Les règles d'enregistrement ne sont disponibles que pour les sources de données Prometheus ou Loki compatibles.*

Une règle d'enregistrement vous permet de précalculer des expressions fréquemment nécessaires ou coûteuses en termes de calcul et d'enregistrer leur résultat sous la forme d'un nouvel ensemble de séries chronologiques. Cela est utile si vous souhaitez exécuter des alertes sur des données agrégées ou si vous disposez de tableaux de bord qui interrogent à plusieurs reprises des expressions coûteuses en termes de calcul.

L'interrogation de cette nouvelle série chronologique est plus rapide, en particulier pour les tableaux de bord, car ils demandent la même expression à chaque actualisation des tableaux de bord.

En savoir plus sur les [règles d'enregistrement](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) dans Prometheus.

# Requêtes et conditions
<a name="v10-alerting-explore-rules-queries"></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)

Dans Grafana, les requêtes jouent un rôle essentiel dans la récupération et la transformation des données à partir de sources de données prises en charge, notamment des bases de données telles que MySQL et PostgreSQL, des bases de données de séries chronologiques telles que Prometheus, InfluxDB et Graphite, et des services tels qu'Amazon, Azure Monitor et Google Cloud Monitoring. OpenSearch CloudWatch

Pour plus d'informations sur les sources de données prises en charge, consultez[Sources de données et alertes Grafana](v10-alerting-overview-datasources.md).

Le processus d'exécution d'une requête implique de définir la source de données, de spécifier les données à récupérer et d'appliquer des filtres ou des transformations appropriés. Des langages de requête ou des syntaxes spécifiques à la source de données choisie sont utilisés pour construire ces requêtes.

Dans Alerting, vous définissez une requête pour obtenir les données que vous souhaitez mesurer et une condition qui doit être remplie avant qu'une règle d'alerte ne soit déclenchée.

Une règle d'alerte consiste en une ou plusieurs requêtes et expressions qui sélectionnent les données que vous souhaitez mesurer.

Pour plus d'informations sur les requêtes et les expressions, consultez[Interrogez et transformez les données](v10-panels-query-xform.md).

## Requêtes sur les sources de données
<a name="v10-alerting-explore-rules-queries-data-source-queries"></a>

Les requêtes dans Grafana peuvent être appliquées de différentes manières, en fonction de la source de données et du langage de requête utilisés. L'éditeur de requêtes de chaque source de données fournit une interface utilisateur personnalisée qui vous permet de rédiger des requêtes qui tirent parti de ses fonctionnalités uniques.

En raison des différences entre les langages de requête, chaque éditeur de requêtes de source de données présente une apparence et un fonctionnement différents. En fonction de votre source de données, l'éditeur de requêtes peut fournir des fonctionnalités de saisie automatique, des noms de métriques, des suggestions de variables ou une interface visuelle de création de requêtes.

Parmi les types courants de composants de requête, on peut citer : 

**Métriques ou champs de données** : spécifiez les métriques ou les champs de données spécifiques que vous souhaitez récupérer, tels que l'utilisation du processeur, le trafic réseau ou les relevés des capteurs.

**Plage de temps** : définissez la plage de temps pour laquelle vous souhaitez récupérer des données, telle que la dernière heure, un jour spécifique ou une plage horaire personnalisée.

**Filtres** : appliquez des filtres pour affiner les données en fonction de critères spécifiques, tels que le filtrage des données en fonction d'une balise, d'un hôte ou d'une application spécifique.

**Agrégations** : effectuez des agrégations sur les données pour calculer des indicateurs tels que des moyennes, des sommes ou des dénombrements sur une période donnée.

**Regroupement : regroupez** les données selon des dimensions ou des balises spécifiques pour créer des vues agrégées ou des ventilations.

**Note**  
Grafana ne prend pas en charge les requêtes d'alerte avec des variables de modèle. Plus d'informations sont disponibles [ici](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) dans les forums de Grafana Labs.

## Requêtes d'expression
<a name="v10-alerting-explore-rules-queries-expression-queries"></a>

Dans Grafana, une expression est utilisée pour effectuer des calculs, des transformations ou des agrégations sur les données demandées par la source de données. Il vous permet de créer des métriques personnalisées ou de modifier des métriques existantes en fonction d'opérations mathématiques, de fonctions ou d'expressions logiques.

En utilisant les requêtes d'expression, les utilisateurs peuvent effectuer des tâches telles que le calcul de la variation en pourcentage entre deux valeurs, l'application de fonctions telles que les fonctions logarithmiques ou trigonométriques, l'agrégation de données sur des plages de temps ou des dimensions spécifiques et la mise en œuvre d'une logique conditionnelle pour gérer différents scénarios.

Dans Alerting, vous ne pouvez utiliser des expressions que pour les règles d'alerte gérées par Grafana. Pour chaque expression, vous pouvez choisir entre les expressions mathématiques, réduire ou rééchantillonner. Ces règles sont appelées règles multidimensionnelles, car elles génèrent une alerte distincte pour chaque série.

Vous pouvez également utiliser une condition classique, qui crée une règle d'alerte qui déclenche une seule alerte lorsque sa condition est remplie. Grafana n'envoie donc qu'une seule alerte, même lorsque les conditions d'alerte sont remplies pour plusieurs séries.

**Note**  
Les conditions classiques existent principalement pour des raisons de compatibilité et doivent être évitées dans la mesure du possible.

**Réduire**

Regroupe les valeurs des séries chronologiques dans la plage de temps sélectionnée en une seule valeur.

**Math**

Effectue des calculs de forme libre functions/operations sur les séries chronologiques et les données numériques. Peut être utilisé pour prétraiter des données de séries chronologiques ou pour définir une condition d'alerte pour les données numériques.

**Rééchantillonner**

Réaligne une plage de temps sur un nouvel ensemble d'horodatages, ce qui est utile lorsque vous comparez des données de séries chronologiques provenant de différentes sources de données où les horodatages ne seraient pas alignés autrement.

**Threshold**

Vérifie si des données de séries chronologiques correspondent à la condition de seuil.

L'expression de seuil vous permet de comparer deux valeurs uniques. Il est renvoyé `0` lorsque la condition est fausse et `1` si la condition est vraie. Les fonctions de seuil suivantes sont disponibles :
+ Est supérieur à (x > y)
+ Est inférieur à (x < y)
+ Se situe dans la plage (x > y1 ET x < y2)
+ Est hors de portée (x < y1 AND x > y2)

**État classique**

Vérifie si des données de séries chronologiques correspondent à la condition d'alerte.

**Note**  
Les requêtes d'expression de condition classiques ne produisent toujours qu'une seule instance d'alerte, quel que soit le nombre de séries chronologiques répondant à la condition. Les conditions classiques existent principalement pour des raisons de compatibilité et doivent être évitées dans la mesure du possible.

## Agrégations
<a name="v10-alerting-explore-rules-queries-aggregations"></a>

Grafana Alerting fournit les fonctions d'agrégation suivantes pour vous permettre d'affiner davantage votre requête.

Ces fonctions sont disponibles uniquement pour **les expressions de condition Reduce** **et Classic**.


| Fonction | Expression | Ce qu'il fait | 
| --- | --- | --- | 
| avg | Réduire/Classique | Affiche la moyenne des valeurs | 
| min | Réduire/Classique | Affiche la valeur la plus faible | 
| max | Réduire/Classique | Affiche la valeur la plus élevée | 
| sum | Réduire/Classique | Affiche la somme de toutes les valeurs | 
| count | Réduire/Classique | Compte le nombre de valeurs dans le résultat | 
| last | Réduire/Classique | Affiche la dernière valeur | 
| median | Réduire/Classique | Affiche la valeur médiane | 
| diff | Classique | Affiche la différence entre la valeur la plus récente et la plus ancienne | 
| diff\$1abs | Classique | Affiche la valeur absolue de diff | 
| percent\$1diff | Classique | Affiche la valeur en pourcentage de la différence entre la valeur la plus récente et la plus ancienne | 
| pourcent\$1diff\$1abs | Classique | Affiche la valeur absolue de percent\$1diff | 
| count\$1non\$1null | Classique | Affiche le nombre de valeurs du jeu de résultats qui ne sont pas null | 

## État d'alerte
<a name="v10-alerting-explore-rules-queries-alert-condition"></a>

Une condition d'alerte est la requête ou l'expression qui détermine si l'alerte se déclenchera ou non en fonction de la valeur qu'elle produit. Il ne peut y avoir qu'une seule condition qui déterminera le déclenchement de l'alerte.

Après avoir défini les and/or expressions de vos requêtes, choisissez l'une d'entre elles comme condition de règle d'alerte.

Lorsque les données demandées répondent à la condition définie, Grafana déclenche l'alerte associée, qui peut être configurée pour envoyer des notifications via différents canaux tels que le courrier électronique, Slack ou. PagerDuty Les notifications vous informent que la condition est remplie, vous permettant de prendre les mesures appropriées ou d'étudier le problème sous-jacent.

Par défaut, la dernière expression ajoutée est utilisée comme condition d'alerte.

## Seuil de récupération
<a name="v10-alerting-explore-rules-queries-recovery-threshold"></a>

Pour réduire le bruit des alertes, vous pouvez définir un seuil de récupération différent du seuil d'alerte.

Les alertes clignotantes se produisent lorsqu'une métrique passe au-dessus de la condition de seuil d'alerte et peuvent entraîner de fréquents changements d'état, entraînant la génération d'un trop grand nombre de notifications.

Les règles d'alerte gérées par Grafana sont évaluées pour un intervalle de temps spécifique. Lors de chaque évaluation, le résultat de la requête est vérifié par rapport au seuil défini dans la règle d'alerte. Si la valeur d'une métrique est supérieure au seuil, une règle d'alerte est déclenchée et une notification est envoyée. Lorsque la valeur passe en dessous du seuil et qu'une alerte est active pour cette métrique, l'alerte est résolue et une autre notification est envoyée.

Il peut être difficile de créer une règle d'alerte pour une métrique bruyante. C'est-à-dire lorsque la valeur d'une métrique passe continuellement au-dessus et en dessous d'un seuil. Ce phénomène, appelé battement, donne lieu à une série de notifications de déclenchement résolues et à un historique de l'état des alertes bruyantes.

Par exemple, si vous recevez une alerte de latence avec un seuil de 1 000 ms et que le nombre fluctue autour de 1 000 (disons 980 -> 1010 -> 990 -> 1020, etc.), chacune de ces alertes déclenchera une notification.

Pour résoudre ce problème, vous pouvez définir un seuil de récupération (personnalisé), ce qui signifie essentiellement avoir deux seuils au lieu d'un. Une alerte est déclenchée lorsque le premier seuil est franchi et n'est résolue que lorsque le second seuil est franchi.

Par exemple, vous pouvez définir un seuil de 1 000 ms et un seuil de récupération de 900 ms. Ainsi, une règle d'alerte ne cessera de se déclencher que lorsqu'elle passe en dessous de 900 ms et que les battements seront réduits.

# Instances d'alerte
<a name="v10-alerting-rules-instances"></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 alertes gérées par Grafana prennent en charge les alertes multidimensionnelles. Chaque règle d'alerte peut créer plusieurs instances d'alerte. C'est très utile si vous observez plusieurs séries dans une seule expression.

Considérez l'expression ProMQL suivante :

```
sum by(cpu) (
  rate(node_cpu_seconds_total{mode!="idle"}[1m])
)
```

Une règle utilisant cette expression créera autant d'instances d'alerte que le nombre d' CPUs alertes observées après la première évaluation, permettant ainsi à une seule règle de signaler l'état de chaque processeur.

# Espaces de noms, dossiers et groupes
<a name="v10-alerting-rules-grouping"></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 alertes peuvent être organisées à l'aide de dossiers pour les règles gérées par Grafana et d'espaces de noms pour les règles et les noms de groupes Mimir, Loki ou Prometheus.

**Espaces de noms et dossiers**

Lors de la création de règles gérées par Grafana, le dossier peut être utilisé pour contrôler l'accès et accorder ou refuser l'accès à toutes les règles d'un dossier spécifique.

Un espace de noms contient un ou plusieurs groupes. Les règles d'un groupe sont exécutées séquentiellement à intervalles réguliers. L'intervalle par défaut est d'une minute. Vous pouvez renommer les espaces de noms et les groupes de règles Grafana Mimi ou Loki, et modifier les intervalles d'évaluation des groupes.

**Groups** (Groupes)

Les règles d'un groupe sont exécutées séquentiellement à intervalles réguliers, ce qui signifie qu'aucune règle ne sera évaluée en même temps et par ordre d'apparition. L'intervalle par défaut est d'une minute. Vous pouvez renommer les espaces de noms de règles Grafana Mimir ou Loki ou les espaces de noms et groupes de règles Loki, et modifier les intervalles d'évaluation des groupes.

**Astuce**  
Si vous souhaitez que les règles soient évaluées simultanément et à des intervalles différents, pensez à les stocker dans différents groupes.

**Note**  
Les règles d'alerte gérées par Grafana sont évaluées simultanément plutôt que séquentiellement.

# Évaluation des règles d'alerte
<a name="v10-alerting-rules-evaluation"></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)

Utilisez l'évaluation des règles d'alerte pour déterminer à quelle fréquence une règle d'alerte doit être évaluée et à quelle vitesse elle doit changer d'état.

Pour ce faire, vous devez vous assurer que votre règle d'alerte se trouve dans le bon groupe d'évaluation et définir une période d'attente adaptée à votre cas d'utilisation.

## Groupe d'évaluation
<a name="v10-alerting-rules-evaluation-group"></a>

Chaque règle d'alerte fait partie d'un groupe d'évaluation. Chaque groupe d'évaluation contient un intervalle d'évaluation qui détermine la fréquence à laquelle la règle d'alerte est vérifiée.

Les règles d'alerte **gérées par les sources de données** au sein d'un même groupe sont évaluées les unes après les autres, tandis que les règles d'alerte des différents groupes peuvent être évaluées simultanément. Cette fonctionnalité est particulièrement utile lorsque vous souhaitez vous assurer que les règles d'enregistrement sont évaluées avant toute règle d'alerte.

Les règles d'alerte **gérées par Grafana** sont évaluées en même temps, quel que soit le groupe de règles d'alerte. L'intervalle d'évaluation par défaut est fixé à 10 secondes, ce qui signifie que les règles d'alerte gérées par Grafana sont évaluées toutes les 10 secondes jusqu'à la fenêtre de 10 secondes la plus proche de l'horloge, par exemple 10:00:00, 10:00:10, 10:00:20, etc. Vous pouvez également configurer votre propre intervalle d'évaluation, si nécessaire.

**Note**  
Les groupes d'évaluation et le regroupement des alertes dans les politiques de notification sont deux choses distinctes. Le regroupement dans les politiques de notification permet d'envoyer plusieurs alertes partageant les mêmes étiquettes dans le même message horaire.

## Période d'attente
<a name="v10-alerting-rules-evaluation-pending-period"></a>

En définissant une période d'attente, vous pouvez éviter les alertes inutiles en cas de problèmes temporaires.

Pendant la période d'attente, vous sélectionnez la période pendant laquelle une règle d'alerte peut ne pas respecter la condition jusqu'à ce qu'elle se déclenche.

**Exemple**

Imaginez que l'intervalle d'évaluation des règles d'alerte est défini toutes les 30 secondes et que la période d'attente est fixée à 90 secondes.

L'évaluation se déroulera comme suit :

[00:30] Première évaluation - condition non remplie.

[01:00] Deuxième évaluation : violation de la condition. En attente de démarrage du compteur. **L'alerte commence à être en attente.**

[01:30] Troisième évaluation : violation de la condition. Compteur en attente = 30 s. **État en attente.**

[02:00] Quatrième évaluation : violation de la condition. Compteur en attente = 60 s **État en attente.**

[02:30] Cinquième évaluation : violation de la condition. Compteur en attente = 90 s. **L'alerte commence à se déclencher**

Si la règle d'alerte comporte une condition qui doit être enfreinte pendant un certain temps avant d'agir, son état change comme suit :
+ Lorsque la condition est violée pour la première fois, la règle passe à l'état « en attente ».
+ La règle reste dans l'état « en attente » jusqu'à ce que la condition soit rompue pendant la durée requise (période d'attente).
+ Une fois le temps requis écoulé, la règle passe en état de « déclenchement ».
+ Si la condition n'est plus rompue pendant la période d'attente, la règle revient à son état normal.

**Note**  
Si vous souhaitez ignorer l'état d'attente, vous pouvez simplement définir la période d'attente sur 0. Cela permet d'ignorer la période d'attente et votre règle d'alerte commence à se déclencher dès que la condition est violée.

Lorsqu'une règle d'alerte est déclenchée, des instances d'alerte sont produites, qui sont ensuite envoyées au gestionnaire d'alertes.

# État et état des règles d'alerte
<a name="v10-alerting-explore-state"></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)

L'état et l'état des règles d'alerte vous aident à comprendre plusieurs indicateurs clés relatifs à l'état de vos alertes.

Il existe trois éléments clés : l'état de la *règle d'alerte, l'état* de *l'instance d'alerte et l'état* de *la règle d'alerte*. Bien que lié, chaque composant transmet des informations subtilement différentes.

**État de la règle d'alerte**

Une règle d'alerte peut avoir l'un des états suivants :


| State | Description | 
| --- | --- | 
| Normal | Aucune des séries chronologiques renvoyées par le moteur d'évaluation n'est à `Firing` l'état `Pending` or. | 
| En attente | Au moins une série chronologique renvoyée par le moteur d'évaluation est`Pending`. | 
| Mise à feu | Au moins une série chronologique renvoyée par le moteur d'évaluation est`Firing`. | 

**Note**  
Les alertes passeront d'abord à `pending` puis`firing`, il faudra donc au moins deux cycles d'évaluation avant qu'une alerte ne soit déclenchée.

**État de l'instance d'alerte**

Une instance d'alerte peut se trouver dans l'un des états suivants :


| State | Description | 
| --- | --- | 
| Normal | L'état d'une alerte qui n'est ni en cours ni en attente indique que tout fonctionne correctement. | 
| En attente | État d'une alerte active pendant une durée inférieure au seuil configuré. | 
| Alerte | État d'une alerte active pendant une durée supérieure au seuil configuré. | 
| NoData | Aucune donnée n'a été reçue pour la fenêtre horaire configurée. | 
| Erreur | Erreur survenue lors de la tentative d'évaluation d'une règle d'alerte. | 

**Conserver le dernier état**

Une règle d'alerte peut être configurée pour conserver le dernier état lorsque `NoData` ou le dernier `Error` état est rencontré. Cela empêchera à la fois le déclenchement des alertes, leur résolution et leur réactivation. Tout comme dans le cas d'une évaluation normale, la règle d'alerte passera de `Pending` à une `Firing` fois la période d'attente écoulée.

**État des règles d'alerte**

Une règle d'alerte peut avoir l'un des états de santé suivants :


| State | Description | 
| --- | --- | 
| Ok | Aucune erreur lors de l'évaluation d'une règle d'alerte. | 
| Erreur | Une erreur s'est produite lors de l'évaluation d'une règle d'alerte. | 
| NoData | Absence de données dans au moins une série chronologique renvoyée lors de l'évaluation d'une règle. | 

**Alertes spéciales pour `NoData` et `Error`**

Lorsque l'évaluation d'une règle d'alerte produit un état `NoData``Error`, Grafana Alerting génère des instances d'alerte portant les étiquettes supplémentaires suivantes :


| Étiquette | Description | 
| --- | --- | 
| nom de l'alerte | Soit, `DatasourceNoData` soit `DatasourceError` selon l'État. | 
| dataource\$1uid | L'UID de la source de données à l'origine de l'état. | 

Vous pouvez gérer ces alertes de la même manière que les alertes classiques en ajoutant un silence, un itinéraire vers un point de contact, etc.

# Modèle de notification
<a name="v10-alerting-rules-notification-templates"></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 notifications envoyées via les points de contact sont créées à l'aide de modèles de notification. Les modèles par défaut de Grafana sont basés sur le [système de modèles Go dans](https://golang.org/pkg/text/template) lequel certains champs sont évalués sous forme de texte, tandis que d'autres sont évalués sous forme de HTML (ce qui peut affecter l'évasion).

Le modèle par défaut [default\$1template.go](https://github.com/grafana/alerting/blob/main/templates/default_template.go) est une référence utile pour les modèles personnalisés.

Comme la plupart des champs des points de contact peuvent être modélisés, vous pouvez créer des modèles personnalisés réutilisables et les utiliser dans plusieurs points de contact. Pour en savoir plus sur les notifications personnalisées à l'aide de modèles, consultez[Personnaliser les notifications](v10-alerting-manage-notifications.md).

**Modèles imbriqués**

Vous pouvez intégrer des modèles dans d'autres modèles.

Par exemple, vous pouvez définir un fragment de modèle à l'aide du `define` mot clé.

```
{{ define "mytemplate" }}
  {{ len .Alerts.Firing }} firing. {{ len .Alerts.Resolved }} resolved.
{{ end }}
```

Vous pouvez ensuite intégrer des modèles personnalisés dans ce fragment à l'aide du `template` mot clé. Par exemple :

```
Alert summary:
{{ template "mytemplate" . }}
```

Vous pouvez utiliser l'une des options de modèle intégrées suivantes pour intégrer des modèles personnalisés.


| Nom | Remarques | 
| --- | --- | 
| `default.title` | Affiche des informations d'état de haut niveau. | 
| `default.message` | Fournit un résumé formaté des alertes déclenchées et résolues. | 
| `teams.default.message` | Similaire à`default.messsage`, formaté pour Microsoft Teams. | 

**HTML dans les modèles de notification**

Le code HTML des modèles de notification d'alerte est évité. Nous ne prenons pas en charge le rendu du code HTML dans la notification qui en résulte.

Certains notificateurs proposent d'autres méthodes pour modifier l'apparence de la notification qui en résulte. Par exemple, Grafana installe le modèle de base pour envoyer des alertes aux e-mails. `<grafana-install-dir>/public/emails/ng_alert_notification.html` Vous pouvez modifier ce fichier pour modifier l'apparence de tous les e-mails d'alerte.

# Gestionnaire d'alertes
<a name="v10-alerting-explore-alertmanager"></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)

Alertmanager vous permet de gérer les alertes et d'y répondre rapidement et efficacement. Il reçoit les alertes, gère les mutings, l'inhibition, le regroupement et le routage en envoyant des notifications via le canal de votre choix, par exemple par e-mail ou Slack.

Dans Grafana, vous pouvez utiliser le Grafana Alertmanager ou un Alertmanager externe. Vous pouvez également exécuter plusieurs gestionnaires d'alertes ; votre décision dépend de votre configuration et de l'endroit où vos alertes sont générées.

**Responsable des alertes Grafana**

Grafana Alertmanager est un gestionnaire d'alertes interne préconfiguré et disponible à la sélection par défaut.

Le Grafana Alertmanager peut recevoir des alertes de Grafana, mais il ne peut pas recevoir d'alertes provenant de l'extérieur de Grafana, par exemple de Mimir ou de Loki.

**Note**  
Les règles d'inhibition ne sont pas prises en charge dans le Grafana Alertmanager.

**Gestionnaire d'alertes externe**

Si vous souhaitez utiliser un seul gestionnaire d'alertes pour recevoir toutes vos alertes Grafana, Loki, Mimir et Prometheus, vous pouvez configurer Grafana pour qu'il utilise un Alertmanager externe. Ce gestionnaire d'alertes externe peut être configuré et administré depuis Grafana même.

Voici deux exemples de situations dans lesquelles vous pouvez configurer votre propre gestionnaire d'alertes externe et y envoyer vos alertes au lieu du gestionnaire d'alertes Grafana :

1. Vous disposez déjà de gestionnaires d'alertes sur site dans votre propre infrastructure cloud que vous avez configurée et que vous souhaitez toujours utiliser, car vous disposez d'autres générateurs d'alertes, tels que Prometheus.

1. Vous souhaitez utiliser Prometheus sur site et Grafana hébergé pour envoyer des alertes au même gestionnaire d'alertes qui s'exécute dans votre infrastructure cloud.

Les gestionnaires d'alertes sont visibles dans le menu déroulant des pages Alerte, Points de contact et Politiques de notification.

Si vous approvisionnez votre source de données, définissez l'indicateur `handleGrafanaManagedAlerts` dans le `jsonData` champ sur pour envoyer des alertes gérées par Grafana `true` à ce gestionnaire d'alertes.

# Points de contact
<a name="v10-alerting-explore-contacts"></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)

Les points de contact contiennent la configuration pour envoyer des notifications. Un point de contact est une liste d'intégrations, chacune d'entre elles envoyant une notification à une adresse e-mail, un service ou une URL en particulier. Les points de contact peuvent avoir plusieurs intégrations du même type ou une combinaison d'intégrations de différents types. Par exemple, un point de contact peut contenir une intégration Pagerduty, une intégration Amazon SNS et Slack, ou une intégration Pagerduty, une intégration Slack et deux intégrations Amazon SNS. Vous pouvez également configurer un point de contact sans intégrations ; dans ce cas, aucune notification n'est envoyée.

Un point de contact ne peut pas envoyer de notifications tant qu'il n'a pas été ajouté à une politique de notification. Une politique de notification ne peut envoyer des alertes qu'à un seul point de contact, mais un point de contact peut être ajouté à plusieurs politiques de notification en même temps. Lorsqu'une alerte correspond à une politique de notification, l'alerte est envoyée au point de contact indiqué dans cette politique de notification, qui envoie ensuite une notification à chaque intégration dans sa configuration.

Les points de contact peuvent être configurés pour le Grafana Alertmanager ainsi que pour les alertmanagers externes.

Vous pouvez également utiliser des modèles de notification pour personnaliser les messages de notification en fonction des types de points de contact.

**Types de points de contact pris en charge**

Le tableau suivant répertorie les types de points de contact pris en charge par Grafana.


| Name | Type | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Devoir de téléavertisseur | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

Pour plus d'informations sur les points de contact, reportez-vous [Configuration des points de contact](v10-alerting-configure-contactpoints.md) aux sections et[Personnaliser les notifications](v10-alerting-manage-notifications.md).

# Notifications
<a name="v10-alerting-explore-notifications"></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)

Choisir comment, quand et où envoyer vos notifications d'alerte est un élément important de la configuration de votre système d'alerte. Ces décisions auront un impact direct sur votre capacité à résoudre les problèmes rapidement et à ne rien manquer d'important.

Dans un premier temps, définissez vos [points de contact](v10-alerting-explore-contacts.md), qui définissent où envoyer vos notifications d'alerte. Un point de contact est un ensemble d'une ou de plusieurs intégrations utilisées pour envoyer des notifications. Ajoutez des modèles de notification aux points de contact afin de les réutiliser et de diffuser des messages cohérents dans vos notifications.

Créez ensuite une politique de notification qui est un ensemble de règles indiquant où, quand et comment vos alertes sont acheminées vers les points de contact. Dans une politique de notification, vous définissez où envoyer vos notifications d'alerte en choisissant l'un des points de contact que vous avez créés.

## Gestionnaires d'alertes
<a name="v10-alerting-explore-notifications-alertmanager"></a>

Grafana utilise Alertmanagers pour envoyer des notifications en cas de déclenchement et de résolution d'alertes. **[Grafana possède son propre Alertmanager, appelé Grafana dans l'interface utilisateur, mais prend également en charge l'envoi de notifications depuis d'autres Alertmanagers, tels que le Prometheus Alertmanager.](https://prometheus.io/docs/alerting/latest/alertmanager/)** Le Grafana Alertmanager utilise des politiques de notification et des points de contact pour configurer comment et où une notification est envoyée, à quelle fréquence une notification doit être envoyée et si les alertes doivent toutes être envoyées dans la même notification, envoyées dans des notifications groupées basées sur un ensemble d'étiquettes ou sous forme de notifications distinctes.

## Politiques de notification
<a name="v10-alerting-explore-notifications-policies"></a>

Les politiques de notification contrôlent quand et où les notifications sont envoyées. Une politique de notification peut choisir d'envoyer toutes les alertes ensemble dans la même notification, d'envoyer les alertes sous forme de notifications groupées en fonction d'un ensemble d'étiquettes ou d'envoyer des alertes sous forme de notifications distinctes. Vous pouvez configurer chaque politique de notification pour contrôler la fréquence à laquelle les notifications doivent être envoyées, ainsi que pour désactiver les notifications à certains moments de la journée et certains jours de la semaine.

Les politiques de notification sont organisées dans une arborescence où, à la racine de l'arborescence, se trouve une politique de notification appelée politique par défaut. Il ne peut y avoir qu'une seule stratégie par défaut et la stratégie par défaut ne peut pas être supprimée.

Les politiques de routage spécifiques sont dérivées de la politique racine et peuvent être utilisées pour faire correspondre toutes les alertes ou un sous-ensemble d'alertes en fonction d'un ensemble d'étiquettes correspondantes. Une politique de notification correspond à une alerte lorsque ses libellés correspondants correspondent à ceux de l'alerte.

Une politique imbriquée peut avoir ses propres politiques imbriquées, ce qui permet une correspondance supplémentaire des alertes. Par exemple, une politique imbriquée peut être l'envoi d'alertes relatives à l'infrastructure à l'équipe des opérations, tandis qu'une politique secondaire peut envoyer des alertes prioritaires à Pagerduty et des alertes de faible priorité à Slack.

Toutes les alertes, quel que soit leur libellé, sont conformes à la politique par défaut. Toutefois, lorsque la stratégie par défaut reçoit une alerte, elle examine chaque stratégie imbriquée et envoie l'alerte à la première stratégie imbriquée qui correspond à l'alerte. Si la stratégie imbriquée comporte d'autres politiques imbriquées, elle peut tenter de faire correspondre l'alerte à l'une de ses politiques imbriquées. Si aucune politique imbriquée ne correspond à l'alerte, la stratégie elle-même est la stratégie correspondante. S'il n'existe aucune politique imbriquée ou si aucune politique imbriquée ne correspond à l'alerte, la stratégie par défaut est la stratégie correspondante.

Pour des informations plus détaillées sur les politiques de notification, consultez[Politiques de notification](v10-alerting-explore-notifications-policies-details.md).

## Modèles de notification
<a name="v10-alerting-explore-notifications-templating"></a>

Vous pouvez personnaliser les notifications à l'aide de modèles. Par exemple, les modèles peuvent être utilisés pour modifier le titre et le message des notifications envoyées à Slack.

Les modèles ne se limitent pas à une intégration ou à un point de contact individuel, mais peuvent être utilisés dans un certain nombre d'intégrations au sein d'un même point de contact et même dans des intégrations entre différents points de contact. Par exemple, un utilisateur de Grafana peut créer un modèle appelé `custom_subject_or_title` et l'utiliser à la fois pour modéliser les sujets dans Pager Duty et les titres des messages Slack sans avoir à créer deux modèles distincts.

Tous les modèles de notifications sont rédigés dans le [langage de modélisation de Go](https://pkg.go.dev/text/template) et se trouvent dans l'onglet Points de contact de la page Alertes.

Pour des informations plus détaillées sur la personnalisation des notifications, consultez[Personnaliser les notifications](v10-alerting-manage-notifications.md).

## Silences
<a name="v10-alerting-explore-notifications-silences"></a>

Vous pouvez utiliser les silences pour désactiver les notifications relatives à une ou plusieurs règles de déclenchement. Les silences n'empêchent pas les alertes de se déclencher ou d'être résolues, ni ne masquent les alertes de déclenchement dans l'interface utilisateur. Un silence dure aussi longtemps que sa durée, qui peut être configurée en minutes, heures, jours, mois ou années.

Pour des informations plus détaillées sur l'utilisation des silences, consultez[Désactiver les notifications d'alerte](v10-alerting-silences.md).

# Politiques de notification
<a name="v10-alerting-explore-notifications-policies-details"></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)

Les politiques de notification vous offrent un moyen flexible d'acheminer les alertes vers différents destinataires. À l'aide des analyseurs d'étiquettes, vous pouvez modifier la diffusion des notifications d'alerte sans avoir à mettre à jour chaque règle d'alerte individuelle.

Dans cette section, vous en apprendrez davantage sur le fonctionnement et la structure des politiques de notification, afin de tirer le meilleur parti de la configuration de vos politiques de notification.

## Arborescence des politiques
<a name="v10-alerting-explore-notifications-policy-tree"></a>

Les politiques de notification *ne sont pas* une liste, mais sont structurées selon une structure arborescente. Cela signifie que chaque politique peut comporter des politiques relatives aux enfants, etc. La racine de l'arborescence des politiques de notification s'appelle la **stratégie de notification par défaut**.

Chaque politique consiste en un ensemble de correspondants d'étiquettes (0 ou plus) qui spécifient les étiquettes qu'elles souhaitent ou ne souhaitent pas gérer.

Pour plus d'informations sur la correspondance des étiquettes, consultez[Comment fonctionne la correspondance des étiquettes](v10-alerting-overview-labels-matching.md).

**Note**  
Si vous n'avez configuré aucun outil de correspondance d'étiquettes pour votre politique de notification, celle-ci correspondra à *toutes les* instances d'alerte. Cela peut empêcher l'évaluation des politiques relatives aux enfants, sauf si vous avez activé l'option **Continuer à associer les frères et sœurs** dans la politique de notification.

## Routage
<a name="v10-alerting-explore-notifications-routing"></a>

Pour déterminer quelle politique de notification gérera quelles instances d'alerte, vous devez commencer par examiner l'ensemble de politiques de notification existant, en commençant par la politique de notification par défaut.

Si aucune politique autre que la stratégie par défaut n'est configurée, la stratégie par défaut gérera l'instance d'alerte.

Si des politiques autres que la politique par défaut sont définies, il évaluera ces politiques de notification dans l'ordre dans lequel elles sont affichées.

Si une politique de notification comporte des indicateurs d'étiquettes qui correspondent aux libellés de l'instance d'alerte, elle passe aux politiques relatives aux enfants et, le cas échéant, continue à rechercher les politiques relatives aux enfants susceptibles d'avoir des critères de correspondance permettant de restreindre davantage le jeu d'étiquettes, et ainsi de suite jusqu'à ce qu'aucune autre politique relative aux enfants ne soit trouvée.

Si aucune politique enfant n'est définie dans une stratégie de notification ou si aucune des politiques enfant ne possède de correspondance d'étiquettes correspondant aux étiquettes de l'instance d'alerte, la stratégie de notification parent est utilisée.

Dès qu'une politique correspondante est trouvée, le système ne continue pas à rechercher d'autres politiques correspondantes. Si vous souhaitez continuer à rechercher d'autres politiques susceptibles de correspondre, activez **Continuer à associer les frères et sœurs à** cette politique en particulier.

Enfin, si aucune des politiques de notification n'est sélectionnée, la politique de notification par défaut est utilisée.

### Exemple de routage
<a name="v10-alerting-explore-notifications-routing-example"></a>

Voici un exemple d'arborescence de politiques de notification relativement simple et de quelques instances d'alerte.

![\[Image illustrant un ensemble de politiques de notification dans une arborescence, ainsi qu'un ensemble d'instances d'alerte avec différentes étiquettes correspondant aux politiques.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/notification-routing.png)


Voici un aperçu de la manière dont ces politiques sont sélectionnées :

**Pod stuck in CrashLoop** ne possède pas d'`severity`étiquette, donc aucune de ses politiques relatives aux enfants ne correspond. Il possède une `team=operations` étiquette, de sorte que la première politique correspond.

La `team=security` politique n'est pas évaluée car nous avons déjà trouvé une correspondance et l'option **Continuer à faire correspondre les frères et sœurs** n'a pas été configurée pour cette politique.

**Utilisation du disque : 80 %** possèdent à la fois une `severity` étiquette `team` et et correspondent à une politique relative aux enfants définie par l'équipe des opérations.

Une **entrée de journal non autorisée** possède une `team` étiquette mais ne correspond pas à la première politique (`team=operations`) car les valeurs ne sont pas les mêmes. La recherche sera donc poursuivie et correspondra à la `team=security` politique. Il n'a aucune politique relative aux enfants, de sorte que l'`severity=high`étiquette supplémentaire est ignorée.

## Héritage
<a name="v10-alerting-explore-notifications-inheritance"></a>

Outre le fait que les politiques enfants constituent un concept utile pour le routage des instances d'alerte, elles héritent également des propriétés de leur politique parent. Cela s'applique également à toutes les politiques qui sont des politiques secondaires de la politique de notification par défaut.

Les propriétés suivantes sont héritées par les politiques relatives aux enfants :
+ Point de contact
+ Options de regroupement
+ Options de chronométrage
+ Horaire du mode muet

Chacune de ces propriétés peut être remplacée par une politique individuelle si vous souhaitez remplacer les propriétés héritées.

Pour hériter d'un point de contact de la politique parent, laissez ce champ vide. Pour annuler les options de regroupement héritées, activez l'option **Remplacer** le regroupement. Pour annuler les options de chronométrage héritées, activez l'option Annuler **les horaires généraux**.

### Exemple d'héritage
<a name="v10-alerting-explore-notifications-inheritance-example"></a>

L'exemple ci-dessous montre comment l'arborescence des politiques de notification de notre exemple précédent permet aux politiques enfants du d'`team=operations`hériter de son point de contact.

De cette façon, nous pouvons éviter d'avoir à spécifier plusieurs fois le même point de contact pour chaque politique relative aux enfants.

![\[Image illustrant un ensemble de politiques de notification dans une arborescence, avec des points de contact affectés à certaines politiques, mais certaines politiques relatives aux enfants héritant des points de contact de leurs parents au lieu de définir les leurs.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/notification-inheritance.png)


## Options de configuration supplémentaires
<a name="v10-alerting-explore-notifications-additional-configuration-options"></a>

### Regroupement
<a name="v10-alerting-explore-notifications-grouping"></a>

Le regroupement est une fonctionnalité importante de Grafana Alerting car il vous permet de regrouper les alertes pertinentes en un plus petit nombre de notifications. Cela est particulièrement important si les notifications sont envoyées aux premiers intervenants, tels que les ingénieurs de garde, où la réception d'un grand nombre de notifications en peu de temps peut être accablante et, dans certains cas, peut avoir un impact négatif sur la capacité des premiers intervenants à répondre à un incident. Par exemple, imaginez une panne importante au cours de laquelle un grand nombre de vos systèmes sont en panne. Dans ce cas, le regroupement peut faire la différence entre la réception d'un appel téléphonique et de 100 appels téléphoniques.

Vous choisissez la manière dont les alertes sont regroupées à l'aide de l'option Regrouper par dans une politique de notification. Par défaut, les politiques de notification de Grafana regroupent les alertes par règle d'alerte en utilisant les `grafana_folder` étiquettes `alertname` et (car les noms des alertes ne sont pas uniques dans plusieurs dossiers). Si vous souhaitez regrouper les alertes selon une autre méthode que la règle d'alerte, remplacez le regroupement par une autre combinaison d'étiquettes.

#### Désactiver le regroupement
<a name="v10-alerting-explore-notifications-disable-grouping"></a>

Si vous souhaitez recevoir chaque alerte sous forme de notification séparée, vous pouvez le faire en les regroupant par une étiquette spéciale appelée`...`. Cela est utile lorsque vos alertes sont transmises à un système automatisé plutôt qu'à un premier intervenant.

#### Un seul groupe pour toutes les alertes
<a name="v10-alerting-explore-notifications-a-single-group-for-all-alerts"></a>

Si vous souhaitez recevoir toutes les alertes dans une seule notification, vous pouvez le faire en laissant le champ Groupe vide.

### Options de chronométrage
<a name="v10-alerting-explore-notifications-timing-options"></a>

Les options de synchronisation déterminent la fréquence d'envoi des notifications pour chaque groupe d'alertes. Il existe trois minuteries que vous devez connaître : l'attente de groupe, l'intervalle de groupe et l'intervalle de répétition.

#### Attente en groupe
<a name="v10-alerting-explore-notifications-group-wait"></a>

L'attente de groupe est le temps que Grafana attend avant d'envoyer la première notification pour un nouveau groupe d'alertes. Plus l'attente du groupe est longue, plus vous avez de temps pour que les autres alertes arrivent. Plus l'attente du groupe est courte, plus la première notification sera envoyée tôt, mais au risque d'envoyer des notifications incomplètes. Vous devez toujours choisir l'attente de groupe la plus adaptée à votre cas d'utilisation.

**Par défaut** : 30 secondes

#### Intervalle de groupe
<a name="v10-alerting-explore-notifications-group-interval"></a>

Une fois que la première notification a été envoyée pour un nouveau groupe d'alertes, Grafana lance le chronomètre de groupe. Il s'agit du temps que Grafana attend avant d'envoyer des notifications concernant les modifications apportées au groupe. Par exemple, une autre alerte de déclenchement vient peut-être d'être ajoutée au groupe alors qu'une alerte existante a peut-être été résolue. Si une alerte est arrivée trop tard pour être incluse dans la première notification en raison de l'attente du groupe, elle sera incluse dans les notifications suivantes après l'intervalle de groupe. Une fois l'intervalle de groupe écoulé, Grafana réinitialise le temporisateur d'intervalle de groupe. Cela se répète jusqu'à ce qu'il n'y ait plus d'alertes dans le groupe, après quoi le groupe est supprimé.

**Par défaut** : 5 minutes

#### Intervalle de répétition
<a name="v10-alerting-explore-notifications-repeat-interval"></a>

L'intervalle de répétition détermine la fréquence à laquelle les notifications sont répétées si le groupe n'a pas changé depuis la dernière notification. Vous pouvez les considérer comme des rappels indiquant que certaines alertes sont toujours en cours de déclenchement. L'intervalle de répétition est étroitement lié à l'intervalle de groupe, ce qui signifie que votre intervalle de répétition doit non seulement être supérieur ou égal à l'intervalle de groupe, mais également être un multiple de l'intervalle de groupe. Si l'intervalle de répétition n'est pas un multiple de l'intervalle de groupe, il sera réduit à un. Par exemple, si votre intervalle de groupe est de 5 minutes et que votre intervalle de répétition est de 9 minutes, l'intervalle de répétition sera arrondi au multiple de 5 le plus proche, soit 10 minutes.

**Par défaut** : 4 heures

# Alerter la haute disponibilité
<a name="v10-alerting-explore-high-availability"></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)

Amazon Managed Grafana est configuré pour une haute disponibilité, notamment pour exécuter plusieurs instances dans plusieurs zones de disponibilité pour chaque espace de travail que vous créez.

Grafana Alerting utilise le modèle Prometheus qui permet de séparer l'évaluation des règles d'alerte de l'envoi des notifications. Dans ce modèle, l'évaluation des règles d'alerte est effectuée dans le générateur d'alertes et l'envoi des notifications est effectué dans le récepteur d'alertes. Dans Grafana Alerting, le générateur d'alertes est le planificateur et le récepteur est le gestionnaire d'alertes.

Avec les configurations de haute disponibilité, toutes les règles d'alerte sont évaluées sur toutes les instances. Vous pouvez considérer que l'évaluation des règles d'alerte est dupliquée. C'est ainsi que Grafana Alerting garantit que tant qu'au moins une instance Grafana fonctionne, les règles d'alerte seront toujours évaluées et les notifications d'alertes seront toujours envoyées. Vous verrez cette duplication dans l'historique des états, et c'est un bon moyen de savoir si vous utilisez la haute disponibilité.

# Configurer les alertes
<a name="v10-alerting-setup"></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)

Configurez les fonctionnalités et les intégrations dont vous avez besoin pour créer et gérer vos alertes.

**Conditions préalables**

Avant de configurer les alertes, vous devez effectuer les opérations suivantes.
+ Configurez vos [sources de données](AMG-data-sources.md).
+ Assurez-vous que la source de données que vous choisissez est compatible et prise en charge par les alertes [Grafana](v10-alerting-overview-datasources.md).

**Pour configurer les alertes**

1. Configurez [les règles d'alerte](v10-alerting-configure.md).
   + Créez des règles d'alerte et d'enregistrement gérées par Grafana ou gérées par des sources de données.

1. Configurez les [points de contact](v10-alerting-configure-contactpoints.md).
   + Vérifiez le point de contact par défaut et mettez-le à jour pour votre système.
   + Ajoutez éventuellement de nouveaux points de contact et intégrations.

1. Configuration des [politiques de notification](v10-alerting-explore-notifications-policies-details.md)
   + Vérifiez la politique de notification par défaut et mettez-la à jour pour votre système.
   + Ajoutez éventuellement des politiques imbriquées supplémentaires.
   + Ajoutez éventuellement des étiquettes et des correspondants d'étiquettes pour contrôler le routage des alertes.

Les rubriques suivantes vous fournissent des informations supplémentaires sur les options de configuration supplémentaires, notamment la configuration des gestionnaires d'alertes externes et le routage des alertes gérées par Grafana en dehors de Grafana.

**Topics**
+ [Migration des alertes classiques du tableau de bord vers les alertes Grafana](v10-alerting-use-grafana-alerts.md)
+ [Ajouter un gestionnaire d'alertes externe](v10-alerting-setup-alertmanager.md)
+ [Approvisionnement des ressources d'alerte Grafana](v10-alerting-setup-provision.md)

# Migration des alertes classiques du tableau de bord vers les alertes Grafana
<a name="v10-alerting-use-grafana-alerts"></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)

Les espaces de travail qui choisissent de ne pas utiliser les alertes Grafana utilisent le. [Alertes classiques sur le tableau](old-alerts-overview.md) Pour passer à la nouvelle alerte Grafana, vous devez activer cette fonctionnalité. Pour en savoir plus sur les différences entre les alertes classiques du tableau de bord et les alertes Grafana, voir. [Alertes Grafana et alertes du tableau de bord traditionnel](#v10-alerting-diff-old-new) GrafanaLabs a annoncé que les alertes classiques du tableau de bord seront supprimées dans la version 11.

Lorsque vous utilisez les alertes de tableau de bord classiques, Amazon Managed Grafana vous montre un aperçu des alertes Grafana, dans lequel vous pouvez consulter et modifier vos alertes mises à niveau avant de finaliser la mise à niveau.

## Prévisualisation des alertes Grafana
<a name="v10-alerting-preview-grafana-alerts"></a>

Vous pouvez prévisualiser vos alertes dans les alertes Grafana avant de procéder à la migration. Dans l'aperçu, vous pouvez apporter des modifications aux alertes qui modifieront la migration.

**Pour prévisualiser votre migration vers les alertes Grafana**

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

1. Dans le menu de gauche, choisissez **Alerting (legacy)** pour afficher vos alertes actuelles.

1. Dans le menu de gauche, choisissez **Mise à niveau des alertes** pour afficher vos alertes dans Grafana Alerting.

   Dans cette vue, vous pouvez voir à quoi ressembleront vos alertes après la migration.

**Note**  
Dans cette vue, vous pouvez également apporter des modifications qui auront une incidence sur votre migration. Pour annuler les modifications que vous apportez, choisissez **Réinitialiser la mise** à niveau en haut à droite de la page de mise à niveau.

Lorsque vous êtes prêt à mettre à jour vos alertes, consultez la section suivante.

## Migration vers le système d'alerte Grafana
<a name="v10-alerting-use-grafana-alerts-opt-in"></a>

Vous pouvez configurer votre instance Amazon Managed Grafana pour utiliser les alertes Grafana à l'aide de l'API Amazon Managed Grafana AWS CLI ou de l' AWS Management Console API Amazon Managed Grafana. Pour plus d'informations sur la configuration d'Amazon Managed Grafana, notamment sur l'activation ou la désactivation des alertes Grafana, consultez. [Configuration d'un espace de travail Grafana géré par Amazon](AMG-configure-workspace.md)

Lorsque les alertes Grafana sont activées, les alertes de tableau de bord classiques existantes migrent dans un format compatible avec les alertes Grafana. Sur la page d'alerte de votre instance Grafana, vous pouvez consulter les alertes migrées ainsi que les nouvelles alertes. Avec les alertes Grafana, vos règles d'alerte gérées par Grafana envoient plusieurs notifications plutôt qu'une seule alerte lorsqu'elles correspondent.

L'accès en lecture et en écriture aux alertes classiques du tableau de bord et aux alertes Grafana est régi par les autorisations des dossiers qui les stockent. Lors de la migration, les autorisations d'alerte classiques du tableau de bord sont associées aux nouvelles règles, comme suit :
+ Si le tableau de bord de l'alerte d'origine comporte des autorisations, la migration crée un dossier nommé dans ce format `Migrated {"dashboardUid": "UID", "panelId": 1, "alertId": 1}` afin de correspondre aux autorisations du tableau de bord d'origine (y compris les autorisations héritées du dossier).
+ S'il n'existe aucune autorisation de tableau de bord et que le tableau de bord se trouve sous un dossier, la règle est liée à ce dossier et hérite de ses autorisations.
+ S'il n'existe aucune autorisation de tableau de bord et que le tableau de bord se trouve dans le dossier Général, la règle est liée au dossier Alertes générales et la règle hérite des autorisations par défaut.

**Note**  
Comme il n'existe aucune `Keep Last State` option d'alerte `NoData` dans Grafana, cette option est utilisée `NoData` lors de la migration classique des règles. L'option `Keep Last State` de `Error` gestion est migrée vers une nouvelle option`Error`. Pour correspondre au comportement du`Keep Last State`, dans les deux cas, pendant la migration, Amazon Managed Grafana crée automatiquement un silence d'une durée d'un an pour chaque règle d'alerte.

Les canaux de notification sont migrés vers une configuration Alertmanager avec les itinéraires et les récepteurs appropriés. Les canaux de notification par défaut sont ajoutés en tant que points de contact à l'itinéraire par défaut. Les canaux de notification qui ne sont associés à aucune alerte du tableau de bord sont affectés à l'`autogen-unlinked-channel-recv`itinéraire.

### Limitations
<a name="v10-alerting-use-grafana-alerts-limitations"></a>
+ Le système d'alerte Grafana peut récupérer les règles de toutes les sources de données Prometheus, Loki et Alertmanager disponibles. Il se peut qu'il ne soit pas en mesure de récupérer les règles d'alerte à partir d'autres sources de données prises en charge.
+ La migration entre les alertes Grafana et les alertes classiques du tableau de bord peut entraîner une perte de données pour les fonctionnalités prises en charge dans un système, mais pas dans l'autre.
**Note**  
Si vous revenez aux alertes classiques du tableau de bord, vous perdez toutes les modifications apportées à la configuration des alertes alors que les alertes Grafana étaient activées, y compris les nouvelles règles d'alerte créées.

## Alertes Grafana et alertes du tableau de bord traditionnel
<a name="v10-alerting-diff-old-new"></a>

Introduite dans Grafana 8, l'alerte Grafana présente plusieurs améliorations par rapport aux anciennes alertes du tableau de bord.

### Alertes multidimensionnelles
<a name="v10-alerts-diff-multi-dimensional"></a>

Vous pouvez désormais créer des alertes qui vous offrent une visibilité à l'échelle du système à l'aide d'une seule règle d'alerte. Générez plusieurs instances d'alerte à partir d'une seule règle d'alerte. Par exemple, vous pouvez créer une règle pour surveiller l'utilisation du disque de plusieurs points de montage sur un même hôte. Le moteur d'évaluation renvoie plusieurs séries chronologiques à partir d'une seule requête, chaque série chronologique étant identifiée par son jeu d'étiquettes.

### Créez des alertes en dehors des tableaux de bord
<a name="v10-alerts-diff-alerts-outside-of-dashboards"></a>

Contrairement aux anciennes alertes de tableau de bord, les alertes Grafana vous permettent de créer des requêtes et des expressions qui combinent des données provenant de plusieurs sources de manière unique. Vous pouvez toujours associer les tableaux de bord et les panneaux aux règles d'alerte à l'aide de leur identifiant et dépanner rapidement le système observé.

Comme les alertes unifiées ne sont plus directement liées aux requêtes du panel, elles n'incluent pas d'images ni de valeurs de requête dans l'e-mail de notification. Vous pouvez utiliser des modèles de notification personnalisés pour afficher les valeurs des requêtes.

### Création de règles d'alerte pour Loki et Grafana Mimir
<a name="v10-alerts-diff-loki-mimir-alerting-rules"></a>

Dans Grafana Alerting, vous pouvez gérer les règles d'alerte de Loki et de Grafana Mimir en utilisant la même interface utilisateur et la même API que vos alertes gérées par Grafana.

### Afficher et rechercher des alertes provenant de sources de données compatibles avec Prometheus
<a name="v10-alerts-diff-view-alerts-from-prometheus"></a>

Les alertes pour les sources de données compatibles avec Prometheus sont désormais répertoriées dans la section Alertes Grafana. Vous pouvez rechercher des étiquettes dans plusieurs sources de données pour trouver rapidement les alertes pertinentes.

### Alertes spéciales concernant l'état de l'alerte NoData et l'erreur
<a name="v10-alerts-diff-special-alerts"></a>

Grafana Alerting a introduit un nouveau concept des états d'alerte. Lorsque l'évaluation d'une règle d'alerte produit un état NoData ou une erreur, Grafana Alerting génère des alertes spéciales portant les étiquettes suivantes :
+ `alertname`avec une valeur DatasourceNoData ou DatasourceError en fonction de l'état.
+ `rulename`nom de la règle d'alerte à laquelle appartient l'alerte spéciale.
+ `datasource_uid`aura l'UID de la source de données à l'origine de l'état.
+ Toutes les étiquettes et annotations de la règle d'alerte d'origine

Vous pouvez gérer ces alertes de la même manière que les alertes classiques en ajoutant un silence, un itinéraire vers un point de contact, etc.

**Note**  
Si la règle utilise de nombreuses sources de données et qu'une ou plusieurs ne renvoient aucune donnée, l'alerte spéciale sera créée pour chaque source de données à l'origine de l'état d'alerte.

# Ajouter un gestionnaire d'alertes externe
<a name="v10-alerting-setup-alertmanager"></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)

Configurez Grafana pour qu'il utilise un gestionnaire d'alertes externe en tant que gestionnaire d'alertes unique pour recevoir toutes vos alertes. Ce gestionnaire d'alertes externe peut ensuite être configuré et administré depuis Grafana même.

**Note**  
Vous ne pouvez pas utiliser Amazon Managed Service for Prometheus en tant que gestionnaire d'alertes externe.

Une fois que vous avez ajouté le gestionnaire d'alertes, vous pouvez utiliser l'interface utilisateur d'alerte de Grafana pour gérer les silences, les points de contact et les politiques de notification. Une option déroulante de ces pages vous permet de passer d'un gestionnaire d'alertes à un autre.

Les gestionnaires d'alertes externes sont configurés en tant que sources de données à l'aide de la configuration de Grafana depuis le menu de navigation principal de Grafana. Cela vous permet de gérer les points de contact et les politiques de notification des gestionnaires d'alertes externes depuis Grafana et de chiffrer les informations d'authentification HTTP de base qui étaient auparavant visibles lors de la configuration des gestionnaires d'alertes externes par URL.

**Note**  
À partir de Grafana 9.2, la configuration des URL des gestionnaires d'alertes externes depuis l'onglet Admin de la page d'alerte est obsolète. Il sera supprimé dans une future version.

**Pour ajouter un Alertmanager externe**

1. Choisissez **Connexions** dans le menu principal de gauche.

1. Recherchez `Alertmanager`.

1. Cliquez sur le bouton **Créer une nouvelle source de données**.

1. Remplissez les champs de la page, le cas échéant.

   Si vous approvisionnez votre source de données, définissez l'indicateur `handleGrafanaManagedAlerts` dans le `jsonData` champ sur pour envoyer des alertes gérées par Grafana `true` à ce gestionnaire d'alertes.
**Note**  
Les implémentations d'Alertmanager par Prometheus, Grafana Mimir et Cortex sont prises en charge. Pour Prometheus, les points de contact et les politiques de notification sont en lecture seule dans l'interface utilisateur de Grafana Alerting.

1. Choisissez **Enregistrer et tester**.

# Approvisionnement des ressources d'alerte Grafana
<a name="v10-alerting-setup-provision"></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)

L'infrastructure d'alerte est souvent complexe, de nombreux éléments du pipeline se trouvant souvent à des endroits différents. L'étendre à plusieurs équipes et organisations est une tâche particulièrement difficile. Le provisionnement de Grafana Alerting facilite ce processus en vous permettant de créer, de gérer et de maintenir vos données d'alerte de la manière la mieux adaptée à votre organisation.

Vous avez le choix entre deux options :

1. Approvisionnez vos ressources d'alerte à l'aide de l'API HTTP Alerting Provisioning.
**Note**  
En règle générale, vous ne pouvez pas modifier les règles d'alerte configurées par l'API depuis l'interface utilisateur de Grafana.  
Pour activer la modification, ajoutez l' x-disable-provenanceen-tête aux demandes suivantes lors de la création ou de la modification de vos règles d'alerte dans l'API :  

   ```
   POST /api/v1/provisioning/alert-rules
   PUT /api/v1/provisioning/alert-rules/{UID}
   ```

1. Provisionnez vos ressources d'alerte à l'aide de Terraform.

**Note**  
Actuellement, le provisionnement pour Grafana Alerting prend en charge les règles d'alerte, les points de contact, les horaires de mise en sourdine et les modèles. Les ressources d'alerte provisionnées à l'aide du provisionnement de fichiers ou de Terraform ne peuvent être modifiées que dans la source qui les a créées et non à partir de Grafana ou de toute autre source. Par exemple, si vous approvisionnez vos ressources d'alerte à l'aide de fichiers sur disque, vous ne pouvez pas modifier les données dans Terraform ou depuis Grafana.

**Topics**
+ [Créez et gérez des ressources d'alerte à l'aide de Terraform](v10-alerting-setup-provision-terraform.md)
+ [Afficher les ressources d'alerte provisionnées dans Grafana](v10-alerting-setup-provision-view.md)

# Créez et gérez des ressources d'alerte à l'aide de Terraform
<a name="v10-alerting-setup-provision-terraform"></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 le fournisseur Grafana de Terraform pour gérer vos ressources d'alerte et les intégrer à votre système Grafana. Le support des fournisseurs Terraform pour Grafana Alerting facilite la création, la gestion et la maintenance de l'ensemble de votre pile d'alertes Grafana sous forme de code.

Pour plus d'informations sur la gestion de vos ressources d'alerte à l'aide de Terraform, consultez la documentation du [fournisseur](https://registry.terraform.io/providers/grafana/grafana/latest/docs) Grafana dans la documentation Terraform.

Effectuez les tâches suivantes pour créer et gérer vos ressources d'alerte à l'aide de Terraform.

1. Créez une clé d'API pour le provisionnement.

1. Configurez le fournisseur Terraform.

1. Définissez vos ressources d'alerte dans Terraform.

1. Exécutez `terraform apply` pour approvisionner vos ressources d'alerte.

## Conditions préalables
<a name="v10-alerting-setup-provision-tf-prerequisites"></a>
+ Assurez-vous d'avoir le [fournisseur grafana/grafana Terraform](https://registry.terraform.io/providers/grafana/grafana/1.28.0) 1.27.0 ou supérieur.
+ Assurez-vous d'utiliser Grafana 9.1 ou une version ultérieure. Si vous avez créé votre instance Amazon Managed Grafana avec la version 9 de Grafana, cela sera vrai.

## Création d'une clé d'API pour le provisionnement
<a name="v10-alerting-setup-provision-tf-apikey"></a>

Vous pouvez [créer une clé d'API Grafana normale](Using-Grafana-APIs.md) pour authentifier Terraform auprès de Grafana. La plupart des outils existants utilisant des clés d'API devraient fonctionner automatiquement avec le nouveau support Grafana Alerting. Pour des informations spécifiques sur la création de clés à utiliser avec Terraform, consultez [Utilisation de Terraform pour l'automatisation d'Amazon Managed](https://aws-observability.github.io/observability-best-practices/recipes/recipes/amg-automation-tf/) Grafana.

**Pour créer une clé d'API pour le provisionnement**

1. Créez un nouveau compte de service pour votre pipeline CI.

1. Attribuez le rôle « Accéder à l'API de provisionnement des règles d'alerte ».

1. Créez un nouveau jeton de compte de service.

1. Nommez et enregistrez le jeton pour l'utiliser dans Terraform.

Vous pouvez également utiliser l'authentification de base. Pour voir tous les formats d'authentification pris en charge, voir [Authentification Grafana](https://registry.terraform.io/providers/grafana/grafana/latest/docs#authentication) dans la documentation Terraform.

## Configurer le fournisseur Terraform
<a name="v10-alerting-setup-provision-tf-configure"></a>

[Le support Grafana Alerting est inclus dans le fournisseur Grafana Terraform.](https://registry.terraform.io/providers/grafana/grafana/latest/docs)

Voici un exemple que vous pouvez utiliser pour configurer le fournisseur Terraform.

```
terraform {
    required_providers {
        grafana = {
            source = "grafana/grafana"
            version = ">= 1.28.2"
        }
    }
}

provider "grafana" {
    url = <YOUR_GRAFANA_URL>
    auth = <YOUR_GRAFANA_API_KEY>
}
```

## Fournir des points de contact et des modèles
<a name="v10-alerting-setup-provision-tf-contacts"></a>

Les points de contact relient une pile d'alertes au monde extérieur. Ils indiquent à Grafana comment se connecter à vos systèmes externes et où envoyer les notifications. Vous avez le choix entre plus de quinze [intégrations](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/contact_point#optional) différentes. Cet exemple utilise un point de contact Slack.

**Pour fournir des points de contact et des modèles**

1. Copiez ce bloc de code dans un fichier .tf sur votre machine locale. *<slack-webhook-url>*Remplacez-le par l'URL de votre webhook Slack (ou d'autres informations de point de contact).

   Cet exemple crée un point de contact qui envoie des notifications d'alerte à Slack.

   ```
   resource "grafana_contact_point" "my_slack_contact_point" {
       name = "Send to My Slack Channel"
   
       slack {
           url = <slack-webhook-url>
           text = <<EOT
   {{ len .Alerts.Firing }} alerts are firing!
   
   Alert summaries:
   {{ range .Alerts.Firing }}
   {{ template "Alert Instance Template" . }}
   {{ end }}
   EOT
       }
   }
   ```

1. Entrez le texte de votre notification dans le champ de texte.

   Le `text` champ prend en charge les [modèles de style GO.](https://pkg.go.dev/text/template) Cela vous permet de gérer vos modèles de notification Grafana Alerting directement dans Terraform.

1. Exécutez la commande `terraform apply`.

1. Accédez à l'interface utilisateur de Grafana et vérifiez les coordonnées de votre point de contact.

   Vous ne pouvez pas modifier les ressources fournies via Terraform depuis l'interface utilisateur. Cela garantit que votre pile d'alertes reste toujours synchronisée avec votre code.

1. Cliquez sur **Tester** pour vérifier que le point de contact fonctionne correctement.

**Note**  
Vous pouvez réutiliser les mêmes modèles pour de nombreux points de contact. Dans l'exemple ci-dessus, un modèle partagé est intégré à l'aide de l'instruction `{{ template "Alert Instance Template" . }}`  
Ce fragment peut ensuite être géré séparément dans Terraform :  

```
resource "grafana_message_template" "my_alert_template" {
    name = "Alert Instance Template"

    template = <<EOT
{{ define "Alert Instance Template" }}
Firing: {{ .Labels.alertname }}
Silence: {{ .SilenceURL }}
{{ end }}
EOT
}
```

## Provisionner les politiques de notification et le routage
<a name="v10-alerting-setup-provision-tf-notifications"></a>

Les politiques de notification indiquent à Grafana comment acheminer les instances d'alerte, et non leur localisation. Ils connectent les alertes de tir à vos points de contact préalablement définis à l'aide d'un système d'étiquettes et de matchers.

**Pour configurer les politiques de notification et le routage**

1. Copiez ce bloc de code dans un fichier .tf sur votre machine locale.

   Dans cet exemple, les alertes sont regroupées par`alertname`, ce qui signifie que toutes les notifications provenant d'alertes portant le même nom sont regroupées dans le même message Slack.

   Si vous souhaitez acheminer des notifications spécifiques différemment, vous pouvez ajouter des sous-politiques. Les sous-politiques vous permettent d'appliquer un routage à différentes alertes en fonction de la correspondance des étiquettes. Dans cet exemple, nous appliquons une temporisation muette à toutes les alertes portant le label a=b.

   ```
   resource "grafana_notification_policy" "my_policy" {
       group_by = ["alertname"]
       contact_point = grafana_contact_point.my_slack_contact_point.name
   
       group_wait = "45s"
       group_interval = "6m"
       repeat_interval = "3h"
   
       policy {
           matcher {
               label = "a"
               match = "="
               value = "b"
           }
           group_by = ["..."]
           contact_point = grafana_contact_point.a_different_contact_point.name
           mute_timings = [grafana_mute_timing.my_mute_timing.name]
   
           policy {
               matcher {
                   label = "sublabel"
                   match = "="
                   value = "subvalue"
               }
               contact_point = grafana_contact_point.a_third_contact_point.name
               group_by = ["..."]
           }
       }
   }
   ```

1. Dans le champ mute\$1timings, associez une temporisation muette à votre politique de notification.

1. Exécutez la commande `terraform apply`.

1. Accédez à l'interface utilisateur de Grafana et vérifiez les détails de votre politique de notification.
**Note**  
Vous ne pouvez pas modifier les ressources fournies par Terraform depuis l'interface utilisateur. Cela garantit que votre pile d'alertes reste toujours synchronisée avec votre code.

1. Cliquez sur **Tester** pour vérifier que le point de notification fonctionne correctement.

## Provisionner les horaires de mise en sourdine
<a name="v10-alerting-setup-provision-tf-mutetiming"></a>

Les horaires de mise en sourdine permettent de désactiver les notifications d'alerte pendant des périodes définies.

**Pour configurer les horaires de mise en sourdine**

1. Copiez ce bloc de code dans un fichier .tf sur votre machine locale.

   Dans cet exemple, les notifications d'alerte sont désactivées le week-end.

   ```
   resource "grafana_mute_timing" "my_mute_timing" {
       name = "My Mute Timing"
   
       intervals {
           times {
             start = "04:56"
             end = "14:17"
           }
           weekdays = ["saturday", "sunday", "tuesday:thursday"]
           months = ["january:march", "12"]
           years = ["2025:2027"]
       }
   }
   ```

1. Exécutez la commande `terraform apply`.

1. Accédez à l'interface utilisateur de Grafana et vérifiez les détails de votre temps de sourdine.

1. Référencez le délai de mise en sourdine que vous venez de créer dans une politique de notification à l'aide du `mute_timings` champ. Cela appliquera votre temps de sourdine à certaines ou à toutes vos notifications.
**Note**  
Vous ne pouvez pas modifier les ressources fournies par Terraform depuis l'interface utilisateur. Cela garantit que votre pile d'alertes reste toujours synchronisée avec votre code.

1. Cliquez sur **Tester** pour vérifier que le temps de sourdine fonctionne correctement.

## Règles d'alerte relatives aux approvisionnements
<a name="v10-alerting-setup-provision-tf-rules"></a>

[Les règles d'alerte](v10-alerting-configure.md) vous permettent d'émettre des alertes concernant n'importe quelle source de données Grafana. Il peut s'agir d'une source de données que vous avez déjà configurée, ou vous pouvez [définir vos sources de données dans Terraform](https://registry.terraform.io/providers/grafana/grafana/latest/docs/resources/data_source) parallèlement à vos règles d'alerte.

**Pour configurer des règles d'alerte**

1. Créez une source de données à interroger et un dossier dans lequel stocker vos règles.

   Dans cet exemple, la source de [Configuration d'une source TestData de données à des fins de test](testdata-data-source.md) données est utilisée.

   Les alertes peuvent être définies par rapport à n'importe quelle source de données principale dans Grafana.

   ```
   resource "grafana_data_source" "testdata_datasource" {
       name = "TestData"
       type = "testdata"
   }
   
   resource "grafana_folder" "rule_folder" {
       title = "My Rule Folder"
   }
   ```

1. Définissez une règle d'alerte.

   Pour plus d'informations sur les règles d'alerte, reportez-vous à la section [Comment créer des alertes gérées par Grafana.](https://grafana.com/blog/2022/08/01/grafana-alerting-video-how-to-create-alerts-in-grafana-9/)

1. Créez un groupe de règles contenant une ou plusieurs règles.

   Dans cet exemple, le groupe de `grafana_rule_group` ressources est utilisé.

   ```
   resource "grafana_rule_group" "my_rule_group" {
       name = "My Alert Rules"
       folder_uid = grafana_folder.rule_folder.uid
       interval_seconds = 60
       org_id = 1
   
       rule {
           name = "My Random Walk Alert"
           condition = "C"
           for = "0s"
   
           // Query the datasource.
           data {
               ref_id = "A"
               relative_time_range {
                   from = 600
                   to = 0
               }
               datasource_uid = grafana_data_source.testdata_datasource.uid
               // `model` is a JSON blob that sends datasource-specific data.
               // It's different for every datasource. The alert's query is defined here.
               model = jsonencode({
                   intervalMs = 1000
                   maxDataPoints = 43200
                   refId = "A"
               })
           }
   
           // The query was configured to obtain data from the last 60 seconds. Let's alert on the average value of that series using a Reduce stage.
           data {
               datasource_uid = "__expr__"
               // You can also create a rule in the UI, then GET that rule to obtain the JSON.
               // This can be helpful when using more complex reduce expressions.
               model = <<EOT
   {"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":["A"]},"reducer":{"params":[],"type":"last"},"type":"avg"}],"datasource":{"name":"Expression","type":"__expr__","uid":"__expr__"},"expression":"A","hide":false,"intervalMs":1000,"maxDataPoints":43200,"reducer":"last","refId":"B","type":"reduce"}
   EOT
               ref_id = "B"
               relative_time_range {
                   from = 0
                   to = 0
               }
           }
   
           // Now, let's use a math expression as our threshold.
           // We want to alert when the value of stage "B" above exceeds 70.
           data {
               datasource_uid = "__expr__"
               ref_id = "C"
               relative_time_range {
                   from = 0
                   to = 0
               }
               model = jsonencode({
                   expression = "$B > 70"
                   type = "math"
                   refId = "C"
               })
           }
       }
   }
   ```

1. Accédez à l'interface utilisateur de Grafana et vérifiez votre règle d'alerte.

   Vous pouvez voir si la règle d'alerte se déclenche. Vous pouvez également voir une visualisation de chacune des étapes de requête de la règle d'alerte.

   Lorsque l'alerte se déclenche, Grafana achemine une notification via la politique que vous avez définie.

   Par exemple, si vous avez choisi Slack comme point de contact, le [gestionnaire d'alertes](https://github.com/prometheus/alertmanager) intégré de Grafana publie automatiquement un message sur Slack.

# Afficher les ressources d'alerte provisionnées dans Grafana
<a name="v10-alerting-setup-provision-view"></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)

Vous pouvez vérifier que vos ressources d'alerte ont été créées dans Grafana.

**Pour consulter vos ressources approvisionnées dans Grafana**

1. Ouvrez votre instance Grafana.

1. Accédez à Alertes.

1. Cliquez sur un dossier de ressources d'alerte, par exemple, Règles d'alerte.

   Les ressources provisionnées sont étiquetées **Provisioned**, de sorte qu'il est clair qu'elles n'ont pas été créées manuellement.

**Note**  
Vous ne pouvez pas modifier les ressources provisionnées depuis Grafana. Vous ne pouvez modifier les propriétés des ressources qu'en modifiant le fichier de provisionnement et en redémarrant Grafana ou en effectuant un rechargement à chaud. Cela empêche les modifications apportées à la ressource qui seraient remplacées si un fichier était à nouveau provisionné ou si un rechargement à chaud était effectué.

# Configuration des alertes
<a name="v10-alerting-configure"></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)

Configurez les fonctionnalités et les intégrations dont vous avez besoin pour créer et gérer vos alertes.

**Topics**
+ [Configurer les règles d'alerte gérées par Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Configuration des règles d'alerte gérées par les sources de données](v10-alerting-configure-datasourcemanaged.md)
+ [Configuration des règles d'enregistrement](v10-alerting-configure-recordingrules.md)
+ [Configuration des points de contact](v10-alerting-configure-contactpoints.md)
+ [Configuration des politiques de notification](v10-alerting-configure-notification-policies.md)

# Configurer les règles d'alerte gérées par Grafana
<a name="v10-alerting-configure-grafanamanaged"></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 règles gérées par Grafana constituent le type de règle d'alerte le plus flexible. Ils vous permettent de créer des alertes qui peuvent agir sur les données provenant de l'une de nos sources de données prises en charge. Outre la prise en charge de plusieurs sources de données, vous pouvez également ajouter des expressions pour transformer vos données et définir des conditions d'alerte. L'utilisation d'images dans les notifications d'alerte est également prise en charge. Il s'agit du seul type de règle qui permet d'émettre des alertes à partir de plusieurs sources de données dans une seule définition de règle.

Plusieurs instances d'alerte peuvent être créées à la suite d'une seule règle d'alerte (également appelée alerte multidimensionnelle).

Les règles d'alerte gérées par Grafana ne peuvent être modifiées ou supprimées que par les utilisateurs disposant d'autorisations de modification pour le dossier contenant les règles.

Si vous supprimez une ressource d'alerte créée dans l'interface utilisateur, vous ne pouvez plus la récupérer. Pour effectuer une sauvegarde de votre configuration et pouvoir restaurer les ressources d'alerte supprimées, créez vos ressources d'alerte à l'aide de Terraform ou de l'API d'alerte.

Dans les procédures suivantes, nous allons passer en revue le processus de création de vos règles d'alerte gérées par Grafana.

Pour créer une règle d'alerte gérée par Grafana, utilisez le flux de création d'alertes intégré à l'espace de travail et suivez ces étapes pour vous aider.

**Définir le nom de la règle d'alerte**

1. Choisissez **Alerte** -> **Règles d'alerte** -> **\$1 Nouvelle règle d'alerte**.

1. Entrez un nom pour identifier votre règle d'alerte.

   Ce nom est affiché dans la liste des règles d'alerte. Il s'agit également de l'`alertname`étiquette de chaque instance d'alerte créée à partir de cette règle.

Définissez ensuite une requête pour obtenir les données que vous souhaitez mesurer et une condition qui doit être remplie avant qu'une règle d'alerte ne soit déclenchée.

**Pour définir la requête et la condition**

1. Sélectionnez une source de données.

1. Dans le menu déroulant **Options**, spécifiez une [plage de temps](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**Note**  
Grafana Alerting ne prend en charge que des plages de temps relatives fixes, par exemple. `now-24hr: now`  
Il ne prend pas en charge les plages de temps absolues : `2021-12-02 00:00:00 to 2021-12-05 23:59:592` ou les plages de temps semi-relatives :`now/d to: now`.

1. Ajoutez une requête.

   Pour ajouter plusieurs [requêtes](v10-panels-query-xform.md#v10-panels-query-xform-add), choisissez **Ajouter une requête**.

   Toutes les règles d'alerte sont gérées par Grafana par défaut. Si vous souhaitez passer à une règle d'alerte gérée par source de données, cliquez sur **Basculer vers une règle d'alerte gérée par source de données.**

1. Ajoutez une ou plusieurs [expressions](v10-panels-query-xform-expressions.md).

   1. Pour chaque expression, sélectionnez soit la **condition classique** pour créer une règle d'alerte unique, soit les options **Mathématiques**, **Réduire** et **Rééchantillonner** pour générer une alerte distincte pour chaque série.
**Note**  
Lorsque vous utilisez Prometheus, vous pouvez utiliser un vecteur instantané et des fonctions intégrées, vous n'avez donc pas besoin d'ajouter d'expressions supplémentaires.

   1. Choisissez **Aperçu** pour vérifier que l'expression est réussie.

1. [Facultatif] Pour ajouter un seuil de récupération, activez l'option **Seuil de récupération personnalisé** et saisissez une valeur indiquant à quel moment votre règle d'alerte doit cesser de se déclencher.

   Vous ne pouvez ajouter qu'un seul seuil de récupération dans une requête et il doit s'agir de la condition d'alerte.

1. Choisissez **Définir comme condition d'alerte** sur la requête ou l'expression que vous souhaitez définir comme condition d'alerte.

Utilisez l'évaluation des règles d'alerte pour déterminer à quelle fréquence une règle d'alerte doit être évaluée et à quelle vitesse elle doit changer d'état.

Pour ce faire, vous devez vous assurer que votre règle d'alerte se trouve dans le bon groupe d'évaluation et définir une période d'attente adaptée à votre cas d'utilisation.

**Pour définir le comportement d'évaluation des alertes**

1. Sélectionnez un dossier ou choisissez **\$1 Nouveau dossier**.

1. Sélectionnez un groupe d'évaluation ou cliquez sur **\$1 Nouveau groupe d'évaluation**.

   Si vous créez un nouveau groupe d'évaluation, spécifiez l'intervalle pour le groupe.

   Toutes les règles d'un même groupe sont évaluées simultanément sur le même intervalle de temps.

1. Entrez une période d'attente.

   La période d'attente est la période pendant laquelle une règle d'alerte peut enfreindre la condition jusqu'à ce qu'elle se déclenche.

   Une fois qu'une condition est remplie, l'alerte passe à l'état **En attente**. Si la condition reste active pendant la durée spécifiée, l'alerte passe à l'état de **déclenchement**, sinon elle revient à l'état **normal**.

1. Activez les notifications d'alerte de pause, si nécessaire.
**Note**  
Suspendez l'évaluation des règles d'alerte pour éviter les alertes bruyantes lors du réglage de vos alertes. La pause arrête l'évaluation des règles d'alerte et ne crée aucune instance d'alerte. Cela est différent des délais de mise en sourdine, qui interrompent l'envoi des notifications, tout en permettant l'évaluation des règles d'alerte et la création d'instances d'alerte.  
Vous pouvez suspendre l'évaluation des règles d'alerte pour éviter les alertes bruyantes lors du réglage de vos alertes. La pause arrête l'évaluation des règles d'alerte et ne crée aucune instance d'alerte. Cela est différent des délais de mise en sourdine, qui interrompent l'envoi des notifications, tout en permettant l'évaluation des règles d'alerte et la création d'instances d'alerte.

1. Dans **Configurer l'absence de données et la gestion des erreurs**, configurez le comportement des alertes en l'absence de données.

   Utilisez les directives présentées plus loin dans cette section.

Ajoutez des libellés à vos règles d'alerte pour définir la politique de notification qui doit gérer vos instances d'alerte de déclenchement.

Toutes les règles et instances d'alerte, quel que soit leur libellé, correspondent à la politique de notification par défaut. S'il n'existe aucune politique imbriquée ou si aucune politique imbriquée ne correspond aux libellés de la règle d'alerte ou de l'instance d'alerte, la stratégie de notification par défaut est la stratégie correspondante.

**Pour configurer des notifications**

1. Ajoutez des libellés si vous souhaitez modifier le mode d'acheminement de vos notifications.

   Ajoutez des étiquettes personnalisées en sélectionnant des paires clé-valeur existantes dans le menu déroulant, ou ajoutez de nouvelles étiquettes en saisissant la nouvelle clé ou valeur.

1. Prévisualisez la configuration du routage de votre instance d'alerte.

   Sur la base des étiquettes ajoutées, les instances d'alerte sont acheminées vers les politiques de notification affichées.

   Développez chaque politique de notification pour afficher plus de détails.

1. Choisissez **Voir les détails** pour afficher les détails du routage des alertes et un aperçu.

Ajoutez [des annotations](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) pour fournir plus de contexte sur l'alerte dans votre message de notification d'alerte.

Les annotations ajoutent des métadonnées pour fournir plus d'informations sur l'alerte dans votre message de notification d'alerte. Par exemple, ajoutez une annotation **récapitulative** pour vous indiquer la valeur à l'origine du déclenchement de l'alerte ou le serveur sur lequel elle s'est produite.

**Pour ajouter des annotations**

1. [Facultatif] Ajoutez un résumé.

   Bref résumé de ce qui s'est passé et pourquoi.

1. [Facultatif] Ajoutez une description.

   Description de l'action de la règle d'alerte.

1. [Facultatif] Ajoutez une URL Runbook.

   Page Web où vous conservez votre runbook pour l'alerte

1. [Facultatif] Ajouter une annotation personnalisée

1. [Facultatif] Ajoutez un tableau de bord et un lien vers un panneau.

   Lie les alertes aux panneaux d'un tableau de bord.

1. Choisissez **Enregistrer la règle**.

**Règle unique et multidimensionnelle**

Pour les alertes gérées par Grafana, vous pouvez créer une règle avec une condition classique ou vous pouvez créer une règle multidimensionnelle.
+ **Règle avec condition classique**

  Utilisez l'expression de condition classique pour créer une règle qui déclenche une seule alerte lorsque sa condition est remplie. Pour une requête qui renvoie plusieurs séries, Grafana ne suit pas l'état d'alerte de chaque série. Grafana n'envoie donc qu'une seule alerte, même lorsque les conditions d'alerte sont remplies pour plusieurs séries.
+ **Règle multidimensionnelle**

  Pour générer une alerte distincte pour chaque série, créez une règle multidimensionnelle. Utilisez `Math``Reduce`, ou `Resample` expressions pour créer une règle multidimensionnelle. Par exemple :
  + Ajoutez une `Reduce` expression pour chaque requête afin d'agréger les valeurs de la plage de temps sélectionnée en une seule valeur (inutile pour les [règles utilisant des données numériques](v10-alerting-overview-numeric.md)).
  + Ajoutez une `Math` expression avec la condition de la règle. Inutile dans le cas où une requête ou une expression de réduction renvoie déjà `0` si la règle ne doit pas être déclenchée, ou un nombre positif si elle doit se déclencher. Quelques exemples : `$B > 70` s'il doit se déclencher si la valeur de B query/expression est supérieure à 70. `$B < $C * 100`au cas où il devrait se déclencher si la valeur de B est inférieure à la valeur de C multipliée par 100. Si les requêtes comparées contiennent plusieurs séries dans leurs résultats, les séries issues de différentes requêtes sont mises en correspondance si elles ont les mêmes étiquettes ou si l'une est un sous-ensemble de l'autre.

**Note**  
Grafana ne prend pas en charge les requêtes d'alerte avec des variables de modèle. De plus amples informations sont disponibles sur [https://comtemplate-variables-are-notmunity.grafana.com/t/](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) - - /2514. supported-in-alert-queries while-setting-up-alert

**Configuration de l'absence de données et de la gestion des erreurs**

Configurez le comportement des alertes lorsque l'évaluation de vos règles d'alerte ne renvoie aucune donnée ou une erreur.

**Note**  
Les règles d'alerte configurées pour se déclencher lorsqu'une évaluation ne renvoie aucune donnée ou qu'une erreur ne s'affichent que lorsque toute la durée de la période d'évaluation est terminée. Cela signifie qu'au lieu de se déclencher immédiatement lorsque la condition de la règle d'alerte est violée, la règle d'alerte attend que l'heure définie pour le champ **Pour** soit terminée, puis se déclenche, ce qui réduit le bruit des alertes et permet de résoudre des problèmes temporaires de disponibilité des données.

Si l'évaluation de votre règle d'alerte ne renvoie aucune donnée, vous pouvez définir l'état de votre règle d'alerte pour qu'il apparaisse comme suit :


| Aucune donnée | Description | 
| --- | --- | 
| Aucune donnée | Crée une nouvelle alerte DatasourceNoData avec le nom et l'UID de la règle d'alerte, ainsi que l'UID de la source de données qui n'a renvoyé aucune donnée sous forme d'étiquette. | 
| Alerte | Définit l'état de la règle d'alerte surAlerting. La règle d'alerte attend la fin de l'heure définie dans le champ Pour avant de tirer. | 
| Ok | Définit l'état de la règle d'alerte surNormal. | 

Si votre évaluation renvoie une erreur, vous pouvez définir l'état de votre règle d'alerte pour qu'il apparaisse comme suit :


| Erreur | Description | 
| --- | --- | 
| Erreur | Crée une instance d'alerte DatasourceError avec le nom et l'UID de la règle d'alerte, ainsi que l'UID de la source de données qui n'a renvoyé aucune donnée sous forme d'étiquette. | 
| Alerte | Définit l'état de la règle d'alerte surAlerting. La règle d'alerte attend la fin de l'heure définie dans le champ Pour avant de tirer. | 
| Ok | Définit l'état de la règle d'alerte surNormal. | 

**Résoudre les instances d'alerte obsolètes**

Une instance d'alerte est considérée comme obsolète si sa dimension ou sa série a complètement disparu des résultats de la requête pendant deux intervalles d'évaluation.

Les instances d'alerte périmées qui sont dans l'`Error`état `Alerting``NoData`//sont automatiquement marquées comme `Resolved` et l'`grafana_state_reason`annotation est ajoutée à l'instance d'alerte avec le motif`MissingSeries`.

**Créez des alertes à partir de panneaux**

Créez des alertes à partir de n'importe quel type de panneau. Cela signifie que vous pouvez réutiliser les requêtes du panneau et créer des alertes en fonction de celles-ci.

1. Accédez à un tableau de bord dans la section **Tableaux de bord**.

1. Dans le coin supérieur droit du panneau, choisissez les trois points (ellipses).

1. Dans le menu déroulant, sélectionnez **Plus...** puis choisissez **Nouvelle règle d'alerte**.

Cela ouvrira le formulaire des règles d'alerte, vous permettant de configurer et de créer votre alerte en fonction de la requête du panneau actuel.

# Configuration des règles d'alerte gérées par les sources de données
<a name="v10-alerting-configure-datasourcemanaged"></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)

Créez des règles d'alerte pour une instance externe de Grafana Mimir ou Loki sur laquelle l'API Ruler est activée ; ces règles sont appelées règles d'alerte gérées par source de données.

**Note**  
Les règles d'alerte pour une instance externe de Grafana Mimir ou Loki peuvent être modifiées ou supprimées par les utilisateurs ayant des rôles d'éditeur ou d'administrateur.  
Si vous supprimez une ressource d'alerte créée dans l'interface utilisateur, vous ne pouvez plus la récupérer. Pour effectuer une sauvegarde de votre configuration et pouvoir restaurer les ressources d'alerte supprimées, créez vos ressources d'alerte à l'aide de Terraform ou de l'API d'alerte.

**Conditions préalables**
+ Vérifiez que vous disposez d'une autorisation d'écriture sur la source de données Prometheus ou Loki. Sinon, vous ne pourrez pas créer ou mettre à jour les règles d'alerte gérées par Grafana Mimir.
+ Pour les sources de données Grafana Mimir et Loki, activez l'API Ruler en configurant leurs services respectifs.
  + **Loki** - Le type de stockage des `local` règles, par défaut pour la source de données Loki, prend uniquement en charge l'affichage des règles. Pour modifier les règles, configurez l'un des autres types de stockage de règles.
  + **Grafana Mimir** - utilise le préfixe. `/prometheus` [https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) Vous ne pouvez pas fournir d'URL distincte pour l'API Ruler.

**Note**  
Si vous ne souhaitez pas gérer les règles d'alerte pour une source de données Loki ou Prometheus en particulier, accédez à ses paramètres et décochez la case **Gérer les alertes via l'interface utilisateur** d'alerte.

Dans les procédures suivantes, nous vous guiderons tout au long du processus de création de vos règles d'alerte gérées par les sources de données.

Pour créer une règle d'alerte gérée par une source de données, utilisez le flux de création d'alertes intégré à l'espace de travail et suivez ces étapes pour vous aider.

**Pour définir le nom de la règle d'alerte**

1. Choisissez **Alerte** -> **Règles d'alerte** -> **\$1 Nouvelle règle d'alerte**.

1. Entrez un nom pour identifier votre règle d'alerte.

   Ce nom est affiché dans la liste des règles d'alerte. Il s'agit également de l'`alertname`étiquette de chaque instance d'alerte créée à partir de cette règle.

Définissez une requête pour obtenir les données que vous souhaitez mesurer et une condition qui doit être remplie avant qu'une règle d'alerte ne soit déclenchée.

**Pour définir la requête et la condition**

1. Toutes les règles d'alerte sont gérées par Grafana par défaut. Pour passer à une règle d'alerte gérée par source de données, choisissez **Basculer vers une règle d'alerte gérée par source de données**.

1. Sélectionnez une source de données dans la liste déroulante.

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

1. Entrez une requête ProMQL ou LogQL.

1. Choisissez **Aperçu des alertes**.

Utilisez l'évaluation des règles d'alerte pour déterminer à quelle fréquence une règle d'alerte doit être évaluée et à quelle vitesse elle doit changer d'état.

**Pour définir le comportement d'évaluation des alertes**

1. Sélectionnez un espace de noms ou choisissez **\$1 Nouvel espace de noms**.

1. Sélectionnez un groupe d'évaluation ou choisissez **\$1 Nouveau groupe d'évaluation**.

   Si vous créez un nouveau groupe d'évaluation, spécifiez l'intervalle pour le groupe.

   Toutes les règles d'un même groupe sont évaluées séquentiellement sur le même intervalle de temps.

1. Entrez une période d'attente.

   La période d'attente est la période pendant laquelle une règle d'alerte peut enfreindre la condition jusqu'à ce qu'elle se déclenche.

   Une fois qu'une condition est remplie, l'alerte passe à l'`Pending`état. Si la condition reste active pendant la durée spécifiée, l'alerte passe à l'`Firing`état, sinon elle revient à l'`Normal`état.

Ajoutez des libellés à vos règles d'alerte pour définir la politique de notification qui doit gérer vos instances d'alerte de déclenchement.

Toutes les règles et instances d'alerte, quel que soit leur libellé, correspondent à la politique de notification par défaut. S'il n'existe aucune politique imbriquée ou si aucune politique imbriquée ne correspond aux libellés de la règle d'alerte ou de l'instance d'alerte, la stratégie de notification par défaut est la stratégie correspondante.

**Configuration des notifications**
+ Ajoutez des libellés si vous souhaitez modifier le mode d'acheminement de vos notifications.

  Ajoutez des étiquettes personnalisées en sélectionnant des paires clé-valeur existantes dans le menu déroulant, ou ajoutez de nouvelles étiquettes en saisissant la nouvelle clé ou valeur.

Ajoutez [des annotations](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) pour fournir plus de contexte sur l'alerte dans vos notifications d'alerte.

Les annotations ajoutent des métadonnées pour fournir plus d'informations sur l'alerte dans vos notifications d'alerte. Par exemple, ajoutez une `Summary` annotation pour vous indiquer quelle valeur a provoqué le déclenchement de l'alerte ou sur quel serveur elle s'est produite.

**Pour ajouter des annotations**

1. [Facultatif] Ajoutez un résumé.

   Bref résumé de ce qui s'est passé et pourquoi.

1. [Facultatif] Ajoutez une description.

   Description de l'action de la règle d'alerte.

1. [Facultatif] Ajoutez une URL Runbook.

   Page Web où vous conservez votre runbook pour l'alerte

1. [Facultatif] Ajouter une annotation personnalisée

1. [Facultatif] Ajoutez un tableau de bord et un lien vers un panneau.

   Lie les alertes aux panneaux d'un tableau de bord.

1. Choisissez **Enregistrer la règle**.

# Configuration des règles d'enregistrement
<a name="v10-alerting-configure-recordingrules"></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 créer et gérer des règles d'enregistrement pour une instance externe de Grafana Mimir ou Loki. Les règles d'enregistrement calculent à l'avance les expressions fréquemment nécessaires ou les expressions coûteuses en termes de calcul et enregistrent le résultat sous la forme d'un nouvel ensemble de séries chronologiques. L'interrogation de cette nouvelle série chronologique est plus rapide, en particulier pour les tableaux de bord, car ils demandent la même expression à chaque actualisation des tableaux de bord.

**Note**  
Les règles d'enregistrement sont exécutées en tant que règles d'instance et exécutées toutes les 10 secondes.

**Conditions préalables**
+ Vérifiez que vous disposez des autorisations d'écriture sur la source de données Prometheus ou Loki. Vous allez créer ou mettre à jour des règles d'alerte dans votre source de données.
+ Pour les sources de données Grafana Mimir et Loki, activez l'API Ruler en configurant leurs services respectifs.
  + **Loki** — Le type de stockage des `local` règles, par défaut pour la source de données Loki, prend uniquement en charge l'affichage des règles. Pour modifier les règles, configurez l'un des autres types de stockage.
  + **Grafana Mimir** — Utilisez le préfixe. `/prometheus` La source de données Prometheus prend en charge Grafana Mimir et Prometheus, et Grafana s'attend à ce que l'API Query et l'API Ruler se trouvent sous la même URL. Vous ne pouvez pas fournir d'URL distincte pour l'API Ruler.

**Note**  
Si vous ne souhaitez pas gérer les règles d'alerte pour une source de données Loki ou Prometheus en particulier, accédez à ses paramètres et décochez la case **Gérer les alertes** via l'interface utilisateur d'alerte.

**Pour créer des règles d'enregistrement**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez **Alerting, Alert** rules.**

1. Choisissez **Nouvelle règle d'enregistrement**.

1. Définissez le nom de la règle.

   Le nom de la règle d'enregistrement doit être un nom de métrique Prometheus et ne contenir aucun espace.

1. Définir la requête
   + Sélectionnez votre source de données Loki ou Prometheus.
   + Saisissez une requête.

1. Ajoutez un espace de noms et un groupe.
   + Dans le menu déroulant **Namespace**, sélectionnez un espace de noms de règles existant ou ajoutez-en un nouveau. Les espaces de noms peuvent contenir un ou plusieurs groupes de règles et n'ont qu'un objectif organisationnel.
   + Dans le menu déroulant **Groupe**, sélectionnez un groupe existant dans l'espace de noms sélectionné ou ajoutez-en un nouveau. Les règles nouvellement créées sont ajoutées à la fin du groupe. Les règles d'un groupe sont exécutées séquentiellement à intervalles réguliers, avec le même temps d'évaluation.

1. Ajoutez des étiquettes.
   + Ajoutez des étiquettes personnalisées en sélectionnant les paires clé-valeur existantes dans la liste déroulante, ou ajoutez de nouvelles étiquettes en saisissant la nouvelle clé ou valeur.

1. Choisissez **Enregistrer la règle** pour enregistrer la règle, ou **Enregistrer la règle et quitter** pour enregistrer la règle et revenir à la page d'alerte.

# Configuration des points de contact
<a name="v10-alerting-configure-contactpoints"></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)

Utilisez les points de contact pour définir la manière dont vos contacts sont avertis lorsqu'une règle d'alerte est déclenchée.

**Note**  
Vous pouvez créer et modifier des points de contact pour les alertes gérées par Grafana. Les points de contact pour les alertes gérées par les sources de données sont en lecture seule.

## Travailler avec les points de contact
<a name="v10-alerting-configure-contactpoints-working"></a>

Les procédures suivantes indiquent comment ajouter, modifier, supprimer et tester un point de contact.

**Pour ajouter un point de contact**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Points de contact**.

1. Dans le menu déroulant **Choisir un gestionnaire d'alertes**, sélectionnez un gestionnaire d'alertes. Le Grafana Alertmanager est sélectionné par défaut.

1. Dans l'onglet **Points de contact**, choisissez **\$1 Ajouter un point de contact**.

1. Entrez un **nom** pour le point de contact.

1. Dans **Intégration**, choisissez un type et remplissez les champs obligatoires en fonction de ce type. Par exemple, si vous choisissez Slack, entrez les chaînes Slack et les utilisateurs à contacter.

1. Si disponible pour le point de contact que vous avez sélectionné, choisissez **les paramètres facultatifs** souhaités pour définir des paramètres supplémentaires.

1. Dans **Paramètres de notification**, sélectionnez éventuellement **Désactiver le message résolu** si vous ne souhaitez pas être averti lorsqu'une alerte est résolue.

1. Pour ajouter une autre intégration de point de contact, choisissez **Ajouter une intégration de point de contact** et répétez les étapes pour chaque type de point de contact requis.

1. Enregistrez vos modifications.

**Pour modifier un point de contact**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Points de contact** pour voir la liste des points de contact existants.

1. Sélectionnez le point de contact à modifier, puis choisissez **Modifier**.

1. Mettez à jour le point de contact, puis enregistrez vos modifications.

Vous pouvez supprimer les points de contact qui ne sont pas utilisés par une politique de notification.

**Pour supprimer un point de contact**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Points de contact** pour ouvrir la liste des points de contact existants.

1. Dans les **points de contact**, sélectionnez le point de contact à supprimer, puis choisissez **Plus**, **Supprimer**.

1. Dans la boîte de dialogue de confirmation, choisissez **Oui, supprimer**.

**Note**  
Si le point de contact est utilisé par une politique de notification, vous devez supprimer la politique de notification ou la modifier pour utiliser un autre point de contact avant de supprimer le point de contact.

Une fois votre point de contact créé, vous pouvez envoyer une notification de test pour vérifier qu'il est correctement configuré.

**Pour envoyer une notification de test**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Points de contact** pour ouvrir la liste des points de contact existants.

1. Sur les **points de contact**, sélectionnez le point de contact à tester, puis choisissez **Modifier**. Vous pouvez également créer un nouveau point de contact si nécessaire.

1. Choisissez **Test** pour ouvrir la boîte de dialogue de test du point de contact.

1. Choisissez d'envoyer une notification de test prédéfinie ou de choisir **Personnalisé** pour ajouter vos propres annotations et étiquettes personnalisées dans la notification de test.

1. Choisissez **Envoyer une notification** de test pour tester l'alerte auprès des points de contact indiqués.

## Configurer les intégrations de points de contact
<a name="v10-alerting-configure-contactpoints-integration"></a>

Configurez les intégrations de points de contact dans Grafana pour sélectionner votre canal de communication préféré pour recevoir des notifications lorsque vos règles d'alerte se déclenchent. Chaque intégration possède ses propres options de configuration et processus de configuration. Dans la plupart des cas, cela implique de fournir une clé d'API ou une URL de webhook.

Une fois configurée, vous pouvez utiliser les intégrations dans le cadre de vos points de contact pour recevoir des notifications chaque fois que l'état de votre alerte change. Dans cette section, nous aborderons les étapes de base pour configurer une intégration, en prenant PagerDuty comme exemple le fait que vous puissiez commencer à recevoir des alertes en temps réel et rester au courant de vos données de surveillance.

**Liste des intégrations prises en charge**

Le tableau suivant répertorie les types de points de contact pris en charge par Grafana.


| Nom | Type | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Devoir de téléavertisseur | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**Configuration PagerDuty des alertes**

Pour le configurer PagerDuty, vous devez fournir une clé d'intégration. Fournissez les informations suivantes.


| Paramètre | Description | 
| --- | --- | 
| Clé d'intégration | Clé d'intégration pour PagerDuty | 
| Sévérité | Niveau pour les notifications dynamiques. La valeur par défaut est critical. | 
| Détails personnalisés | Informations supplémentaires sur l'événement | 

Le `CustomDetails` champ est un objet contenant des paires clé-valeur arbitraires. Les détails définis par l'utilisateur sont fusionnés avec ceux utilisés par défaut.

Les valeurs par défaut pour `CustomDetails` sont les suivantes :

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

En cas de double clé, les informations définies par l'utilisateur remplacent celles définies par défaut.

# Configuration des politiques de notification
<a name="v10-alerting-configure-notification-policies"></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)

Les politiques de notification déterminent la manière dont les alertes sont acheminées vers les points de contact.

Les politiques ont une structure arborescente, dans laquelle chaque politique peut avoir une ou plusieurs politiques imbriquées. Chaque politique, à l'exception de la stratégie par défaut, peut également correspondre à des étiquettes d'alerte spécifiques.

Chaque alerte est évaluée par la stratégie par défaut, puis par chaque stratégie imbriquée.

Si vous activez l'`Continue matching subsequent sibling nodes`option pour une politique imbriquée, l'évaluation se poursuit même après une ou plusieurs correspondances. Les paramètres de configuration et les informations du point de contact d'une politique parent régissent le comportement d'une alerte qui ne correspond à aucune des politiques enfant. Une politique par défaut régit toute alerte qui ne correspond pas à une politique imbriquée.

Pour plus d'informations sur les politiques de notification, consultez[Notifications](v10-alerting-explore-notifications.md).

Les procédures suivantes vous montrent comment créer et gérer des politiques de notification.

**Pour modifier la politique de notification par défaut**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Politiques de notification**.

1. Dans le menu déroulant **Choisir le gestionnaire d'alertes**, sélectionnez le gestionnaire d'alertes que vous souhaitez modifier.

1. Dans la section **Politique par défaut**, choisissez**...** , **Modifier**.

1. Dans **Point de contact par défaut**, mettez à jour le point de contact auquel les notifications doivent être envoyées pour les règles lorsque les règles d'alerte ne correspondent à aucune politique spécifique.

1. Dans **Regrouper par**, choisissez les libellés selon lesquels regrouper les alertes. Si plusieurs alertes correspondent à cette politique, elles sont regroupées selon ces étiquettes. Une notification est envoyée par groupe. Si le champ est vide (valeur par défaut), toutes les notifications sont envoyées dans un seul groupe. Utilisez une étiquette spéciale `...` pour regrouper les alertes en fonction de toutes les étiquettes (ce qui désactive efficacement le regroupement).

1. Dans **Options de chronométrage**, sélectionnez l'une des options suivantes.
   + **Patience de groupe** : temps d'attente nécessaire pour mettre en mémoire tampon les alertes d'un même groupe avant d'envoyer une notification initiale. Le durée par défaut est 30 secondes.
   + **Intervalle de groupe** : intervalle de temps minimum entre deux notifications pour un groupe. La valeur par défaut est de 5 minutes.
   + **Intervalle de répétition** : intervalle de temps minimal avant le renvoi d'une notification si aucune nouvelle alerte n'a été ajoutée au groupe. La valeur par défaut est de 4 heures.

1. Choisissez **Save** pour enregistrer les changements.

Pour créer une nouvelle politique de notification, vous devez suivre son arborescence. Les nouvelles politiques créées sur le tronc de l'arbre (la politique par défaut) sont les branches de l'arbre. Chaque branche peut avoir ses propres politiques imbriquées. C'est pourquoi vous ajouterez toujours une nouvelle politique **imbriquée**, soit dans le cadre de la stratégie par défaut, soit dans le cadre d'une politique déjà imbriquée.

**Pour ajouter une nouvelle politique imbriquée**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Politiques de notification**.

1. Dans le menu déroulant **Choisir le gestionnaire d'alertes**, sélectionnez le gestionnaire d'alertes que vous souhaitez modifier.

1. Pour ajouter une politique spécifique de haut niveau, rendez-vous dans la section Routage spécifique (soit vers la politique par défaut, soit vers une autre politique existante dans laquelle vous souhaitez ajouter une nouvelle politique imbriquée) et choisissez **\$1** Nouvelle politique imbriquée.

1. Dans la section des étiquettes correspondantes, ajoutez une ou plusieurs règles pour faire correspondre les étiquettes d'alerte.

1. Dans la liste déroulante **Point de contact**, sélectionnez le point de contact auquel envoyer des notifications si une alerte correspond uniquement à cette politique spécifique et à aucune des politiques imbriquées.

1. Activez éventuellement l'option **Continuer à faire correspondre les nœuds frères suivants** pour continuer à faire correspondre les politiques sœurs même après que l'alerte corresponde à la politique actuelle. Lorsque cette option est activée, vous pouvez recevoir plusieurs notifications pour une alerte.

1. Activez éventuellement le **regroupement Override** pour spécifier le même regroupement que la politique par défaut. Si l'option n'est pas activée, le regroupement de politiques par défaut est utilisé.

1. Activez éventuellement l'option **Ignorer les horaires généraux** pour annuler les options de chronométrage configurées dans la politique de notification de groupe.

1. Choisissez **Enregistrer la politique** pour enregistrer les changements.

**Pour modifier une politique imbriquée**

1. Dans le menu de gauche, choisissez **Alerting**.

1. Choisissez **Politiques de notification**.

1. Sélectionnez la politique que vous souhaitez modifier, puis choisissez**...** , **Modifier**.

1. Apportez des modifications (comme lors de l'ajout d'une politique imbriquée).

1. Enregistrez vos modifications.

**Recherche de politiques**

Vous pouvez effectuer une recherche dans l'arborescence des politiques par *Label Matchers* ou *points de contact*.
+ Pour effectuer une recherche par point de contact, entrez le nom partiel ou complet d'un point de contact dans le champ **Rechercher par point de contact**. Les politiques qui utilisent ce point de contact seront mises en évidence dans l'interface utilisateur.
+ Pour effectuer une recherche par étiquette, entrez une étiquette valide dans le champ **de saisie Recherche par étiquette**. Plusieurs correspondances peuvent être saisies, séparées par une virgule. Par exemple, une entrée de correspondance valide pourrait être. `severity=high, region=~EMEA|NA`
**Note**  
Lorsque vous effectuez une recherche par étiquette, toutes les politiques correspondantes correspondront exactement. Les correspondances partielles et les correspondances de style regex ne sont pas prises en charge.

# Gérez vos alertes
<a name="v10-alerting-manage"></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 défini vos règles d'alerte, vos points de contact et vos politiques de notification, vous pouvez utiliser les alertes Grafana pour gérer vos alertes dans la pratique.

**Topics**
+ [Personnaliser les notifications](v10-alerting-manage-notifications.md)
+ [Gérer les points de contact](v10-alerting-manage-contactpoints.md)
+ [Désactiver les notifications d'alerte](v10-alerting-silences.md)
+ [Afficher et filtrer les règles d'alerte](v10-alerting-manage-rules-viewfilter.md)
+ [Horaire du mode muet](v10-alerting-manage-muting.md)
+ [Afficher l'état et l'état des règles d'alerte](v10-alerting-manage-rulestate.md)
+ [Afficher et filtrer par groupes d'alertes](v10-alerting-manage-viewfiltergroups.md)
+ [Afficher les erreurs de notification](v10-alerting-manage-viewnotificationerrors.md)

# Personnaliser les notifications
<a name="v10-alerting-manage-notifications"></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)

Personnalisez vos notifications à l'aide de modèles de notifications.

Vous pouvez utiliser des modèles de notification pour modifier le titre, le message et le format du message dans vos notifications.

Les modèles de notification ne sont pas liés à des intégrations de points de contact spécifiques, telles qu'Amazon SNS ou Slack. Vous pouvez toutefois choisir de créer des modèles de notification distincts pour les différentes intégrations de points de contact.

Vous pouvez utiliser des modèles de notification pour :
+ Ajoutez, supprimez ou réorganisez les informations dans la notification, notamment le résumé, la description, les étiquettes et les annotations, les valeurs et les liens
+ Mettre en forme le texte en gras et en italique, et ajouter ou supprimer des sauts de ligne

Vous ne pouvez pas utiliser de modèles de notification pour :
+ Modifier le design des notifications dans les services de messagerie instantanée tels que Slack et Microsoft Teams

**Topics**
+ [Utilisation du langage de création de modèles de Go](v10-alerting-notifications-go-templating.md)
+ [Création de modèles de notification](v10-alerting-create-templates.md)
+ [Utilisation de modèles de notification](#v10-alerting-use-notification-templates)
+ [Référence de modèles](v10-alerting-template-reference.md)

# Utilisation du langage de création de modèles de Go
<a name="v10-alerting-notifications-go-templating"></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 rédigez des modèles de notification dans le langage de modélisation de Go, [texte/modèle](https://pkg.go.dev/text/template).

Cette section fournit un aperçu du langage de création de modèles de Go et des modèles d'écriture sous forme de texte/modèle.

## Point
<a name="v10-go-dot"></a>

 text/template Il y a un curseur spécial appelé point, écrit sous la forme`.`. Vous pouvez considérer ce curseur comme une variable dont la valeur change en fonction de l'endroit où il est utilisé dans le modèle. Par exemple, au début d'un modèle de notification, il `.` fait référence à l'`ExtendedData`objet, qui contient un certain nombre de champs`Alerts`, notamment`Status`,`GroupLabels`,`CommonLabels`, `CommonAnnotations` et`ExternalURL`. Cependant, le point peut faire référence à autre chose lorsqu'il est utilisé dans `range` une liste, lorsqu'il est utilisé dans un `with` ou lors de la rédaction de modèles de fonctionnalités à utiliser dans d'autres modèles. Vous pouvez en voir des exemples dans[Création de modèles de notification](v10-alerting-create-templates.md), ainsi que toutes les données et fonctions du[Référence de modèles](v10-alerting-template-reference.md).

## Étiquettes d'ouverture et de fermeture
<a name="v10-go-openclosetags"></a>

Dans le texte/le modèle, les modèles commencent par `{{` et se terminent par`}}`, qu'ils impriment une variable ou exécutent des structures de contrôle telles que des instructions if. Ceci est différent des autres langages de modélisation tels que Jinja où l'impression d'une variable utilise `{{` et et où les structures de contrôle utilisent `}}` `{%` et. `%}`

## Print
<a name="v10-go-print"></a>

Pour imprimer la valeur d'un élément, utilisez `{{` et`}}`. Vous pouvez imprimer la valeur d'un point, un champ de points, le résultat d'une fonction et la valeur d'une [variable](#v10-go-variables). Par exemple, pour imprimer le `Alerts` champ où le point fait référence, `ExtendedData` vous devez écrire ce qui suit :

```
{{ .Alerts }}
```

## Répéter les alertes
<a name="v10-go-iterate-alerts"></a>

Pour imprimer uniquement les étiquettes de chaque alerte, plutôt que toutes les informations relatives à l'alerte, vous pouvez utiliser a `range` pour itérer les alertes dans `ExtendedData` :

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

À l'intérieur de la plage, le point ne fait plus référence à`ExtendedData`, mais à un`Alert`. Vous pouvez l'utiliser `{{ .Labels }}` pour imprimer les étiquettes de chaque alerte. Cela fonctionne car le point `{{ range .Alerts }}` change pour faire référence à l'alerte en cours dans la liste des alertes. Lorsque la plage est terminée, le point est remis à la valeur qu'il avait avant le début de la plage, qui dans cet exemple est `ExtendedData` :

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Répéter sur les annotations et les étiquettes
<a name="v10-go-iterate-labels"></a>

Rédigons un modèle pour imprimer les étiquettes de chaque alerte au format`The name of the label is $name, and the value is $value`, où `$name` et `$value` contenant le nom et la valeur de chaque étiquette.

Comme dans l'exemple précédent, utilisez une plage pour parcourir les alertes de `.Alerts` manière à ce que le point fasse référence à l'alerte en cours dans la liste des alertes, puis utilisez une deuxième plage sur les étiquettes triées afin que le point soit mis à jour une deuxième fois pour faire référence à l'étiquette actuelle. Dans la deuxième plage, utilisez `.Name` et `.Value` pour imprimer le nom et la valeur de chaque étiquette :

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## Les fonctions d'index
<a name="v10-go-index"></a>

Pour imprimer une annotation ou une étiquette spécifique, utilisez la `index` fonction.

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## Si des déclarations
<a name="v10-go-if"></a>

Vous pouvez utiliser des instructions if dans les modèles. Par exemple, pour imprimer `There are no alerts` s'il n'y a aucune alerte, `.Alerts` vous devez écrire ce qui suit :

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## Avec
<a name="v10-go-with"></a>

with est similaire aux instructions if, mais contrairement aux instructions if, `with` met à jour le point pour faire référence à la valeur du with :

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

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

Les variables text/template doivent être créées dans le modèle. Par exemple, pour créer une variable appelée `$variable` avec la valeur actuelle de point, vous devez écrire ce qui suit :

```
{{ $variable := . }}
```

Vous pouvez `$variable` l'utiliser à l'intérieur d'une plage ou `with` cela fera référence à la valeur du point au moment où la variable a été définie, et non à la valeur actuelle du point.

Par exemple, vous ne pouvez pas écrire un modèle `{{ .Labels }}` à utiliser dans la deuxième plage car ici, le point fait référence à l'étiquette actuelle, et non à l'alerte en cours :

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Vous pouvez résoudre ce problème en définissant une variable appelée `$alert` dans la première plage et avant la deuxième plage :

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Gamme avec index
<a name="v10-go-rangeindex"></a>

Vous pouvez obtenir l'indice de chaque alerte au sein d'une plage en définissant des variables d'indice et de valeur au début de la plage :

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Définir des modèles
<a name="v10-go-define"></a>

Vous pouvez définir des modèles qui peuvent être utilisés dans d'autres modèles, `define` en utilisant le nom du modèle entre guillemets. Vous ne devez pas définir de modèles portant le même nom que les autres modèles, y compris les modèles par défaut tels que `__subject``__text_values_list`,`__text_alert_list`, `default.title` et`default.message`. Lorsqu'un modèle a été créé avec le même nom qu'un modèle par défaut, ou un modèle dans un autre modèle de notification, Grafana peut utiliser l'un ou l'autre modèle. Grafana n'empêche pas ou n'affiche pas de message d'erreur lorsqu'il existe deux modèles ou plus portant le même nom.

```
{{ define "print_labels" }}
{{ end }}
```

## Exécuter des modèles
<a name="v10-go-execute"></a>

Vous pouvez exécuter un modèle défini dans votre modèle en utilisant `template` le nom du modèle entre guillemets et le curseur qui doit être passé au modèle :

```
{{ template "print_labels" . }}
```

## Transmettre les données aux modèles
<a name="v10-go-passdata"></a>

Dans un modèle, le point fait référence à la valeur transmise au modèle.

Par exemple, si une liste d'alertes de déclenchement est transmise à un modèle, le point fait référence à cette liste d'alertes de déclenchement :

```
{{ template "print_alerts" .Alerts }}
```

Si le modèle reçoit les libellés triés d'une alerte, le point fait référence à la liste des libellés triés :

```
{{ template "print_labels" .SortedLabels }}
```

Cela est utile lors de la rédaction de modèles réutilisables. Par exemple, pour imprimer toutes les alertes, vous pouvez écrire ce qui suit :

```
{{ template "print_alerts" .Alerts }}
```

Ensuite, pour imprimer uniquement les alertes de déclenchement, vous pouvez écrire ceci :

```
{{ template "print_alerts" .Alerts.Firing }}
```

Cela fonctionne car `.Alerts` les deux `.Alerts.Firing` sont des listes d'alertes.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Commentaires
<a name="v10-go-comments"></a>

Vous pouvez ajouter des commentaires avec `{{/*` et `*/}}` :

```
{{/* This is a comment */}}
```

Pour empêcher les commentaires d'ajouter des sauts de ligne, utilisez :

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Indentation
<a name="v10-go-indentation"></a>

Vous pouvez utiliser l'indentation, à la fois des tabulations et des espaces, ainsi que des sauts de ligne, pour rendre les modèles plus lisibles :

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Cependant, l'indentation du modèle sera également présente dans le texte. Ensuite, nous verrons comment le supprimer.

## Supprimer les espaces et les sauts de ligne
<a name="v10-go-removespace"></a>

En cours text/template d'utilisation `{{-` et `-}}` pour supprimer les espaces de début et de fin et les sauts de ligne.

Par exemple, lorsque vous utilisez l'indentation et les sauts de ligne pour rendre un modèle plus lisible :

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

L'indentation et les sauts de ligne seront également présents dans le texte :

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Vous pouvez supprimer l'indentation et les sauts de ligne du texte en le `}}` remplaçant par le `-}}` début de chaque plage :

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

L'indentation et les sauts de ligne du modèle sont désormais absents du texte :

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Création de modèles de notification
<a name="v10-alerting-create-templates"></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éez des modèles de notification réutilisables à envoyer à vos points de contact.

Vous pouvez ajouter un ou plusieurs modèles à votre modèle de notification.

Le nom de votre modèle de notification doit être unique. Vous ne pouvez pas avoir deux modèles portant le même nom dans le même modèle de notification ou dans des modèles de notification différents. Évitez de définir des modèles portant le même nom que les modèles par défaut, tels que : `__subject``__text_values_list`,`__text_alert_list`, `default.title` et`default.message`.

Dans l'onglet Points de contact, vous pouvez voir la liste de vos modèles de notification.

## Création de modèles de notification
<a name="v10-alerting-creating-templates"></a>

**Pour créer un modèle de notification**

1. Choisissez **Alerte**, **Points de contact.**

1. Cliquez sur l'onglet **Modèles de notification**, puis sur **\$1 Ajouter un modèle de notification**.

1. Choisissez un nom pour le modèle de notification, par exemple`email.subject`.

1. Écrivez le contenu du modèle dans le champ de contenu.

   Par exemple :

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Enregistrez vos modifications.

   `{{ define "email.subject" }}`(où `email.subject` est le nom de votre modèle) et `{{ end }}` est automatiquement ajouté au début et à la fin du contenu.

**Pour créer un modèle de notification contenant plusieurs modèles**

1. Choisissez **Alerte**, **Points de contact.**

1. Cliquez sur l'onglet **Modèles de notification**, puis sur **\$1 Ajouter un modèle de notification**.

1. Entrez un nom pour le modèle de notification global. Par exemple, `email`.

1. Écrivez chaque modèle dans le champ Contenu, y compris `{{ define "name-of-template" }}` `{{ end }}` au début et à la fin de chaque modèle. Vous pouvez utiliser des noms descriptifs pour chacun des modèles du modèle de notification, par exemple, `email.subject` ou`email.message`. Dans ce cas, ne réutilisez pas le nom du modèle de notification que vous avez saisi ci-dessus.

   Les sections suivantes présentent des exemples détaillés de modèles que vous pourriez créer.

1. Cliquez sur Sauvegarder

## Afficher un aperçu des modèles de notification
<a name="v10-alerting-preview-templates"></a>

Prévisualisez l'apparence de vos modèles de notification avant de les utiliser dans vos points de contact, afin de comprendre le résultat du modèle que vous créez et de corriger les erreurs éventuelles avant de l'enregistrer.

**Note**  
Les aperçus des notifications ne sont disponibles que pour Grafana Alertmanager.

**Pour prévisualiser vos modèles de notification**

1. Choisissez **Alerte**, **Points de contact.**

1. Choisissez l'onglet **Modèles de notification**, puis **\$1 Ajouter un modèle de notification** ou modifiez un modèle existant.

1. Ajoutez ou mettez à jour le contenu de votre modèle.

   Les données par défaut sont fournies et vous pouvez y ajouter ou modifier des données d'alerte ainsi que des instances d'alerte. Vous pouvez ajouter des données d'alerte directement dans la fenêtre de données de charge utile elle-même, ou cliquer sur **Sélectionner des instances d'alerte** ou sur **Ajouter des alertes personnalisées**.

1. [Facultatif] Pour ajouter des données d'alerte provenant d'instances d'alerte existantes :

   1. Choisissez **Sélectionner les instances d'alerte**.

   1. Passez le curseur sur les instances d'alerte pour afficher plus d'informations sur chaque instance d'alerte/

   1. Choisissez **Confirm** pour ajouter l'instance d'alerte à la charge utile.

1. [Facultatif] Pour ajouter des données d'alerte à l'aide de l'éditeur de données d'alerte, choisissez **Ajouter des données personnalisées** :

   1. Ajoutez des annotations, des étiquettes personnalisées ou définissez un tableau de bord ou un panneau.

   1. Activez le mode Déclenchement ou Résolu, selon que vous souhaitez ajouter des alertes déclenchées ou résolues à votre notification.

   1. Choisissez **Ajouter des données d'alerte**.

   1. Choisissez **Actualiser l'aperçu** pour voir à quoi ressemblera le contenu de votre modèle et les données de charge utile correspondantes.

   Si votre modèle contient des erreurs, elles sont affichées dans l'aperçu et vous pouvez les corriger avant de les enregistrer.

1. Enregistrez vos modifications.

## Création d'un modèle pour l'objet du message
<a name="v10-alerting-create-template-subject"></a>

Créez un modèle pour l'objet d'un e-mail contenant le nombre d'alertes déclenchées et résolues, comme dans cet exemple :

```
1 firing alerts, 0 resolved alerts
```

**Pour créer un modèle pour l'objet d'un e-mail**

1. Créez un modèle appelé `email.subject` avec le contenu suivant :

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Utilisez le modèle lors de la création de votre intégration de points de contact en le plaçant dans le champ **Objet** avec le `template` mot clé.

   ```
   {{ template "email.subject" . }}
   ```

## Création d'un modèle pour le message d'un e-mail
<a name="v10-alerting-create-template-message"></a>

Créez un modèle pour le message d'un e-mail contenant un résumé de toutes les alertes déclenchées et résolues, comme dans cet exemple :

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Pour créer un modèle pour le message d'un e-mail**

1. Créez un modèle de notification appelé `email` avec deux modèles dans le contenu : `email.message_alert` et`email.message`.

   Le `email.message_alert` modèle est utilisé pour imprimer les étiquettes et les valeurs de chaque alerte déclenchée et résolue, tandis que le `email.message` modèle contient la structure de l'e-mail.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Utilisez le modèle lors de la création de votre intégration de points de contact en le plaçant dans le champ **du corps du texte** avec le `template` mot clé.

   ```
   {{ template "email.message" . }}
   ```

## Création d'un modèle pour le titre d'un message Slack
<a name="v10-alerting-create-template-slack-title"></a>

Créez un modèle pour le titre d'un message Slack contenant le nombre d'alertes déclenchées et résolues, comme dans l'exemple suivant :

```
1 firing alerts, 0 resolved alerts
```

**Pour créer un modèle pour le titre d'un message Slack**

1. Créez un modèle appelé `slack.title` avec le contenu suivant :

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Exécutez le modèle à partir du champ de titre dans l'intégration de votre point de contact.

   ```
   {{ template "slack.title" . }}
   ```

## Création d'un modèle pour le contenu d'un message Slack
<a name="v10-alerting-create-template-slack-message"></a>

Créez un modèle pour le contenu d'un message Slack contenant une description de toutes les alertes déclenchées et résolues, y compris leurs étiquettes, leurs annotations et l'URL du tableau de bord.

**Note**  
Ce modèle est réservé aux alertes gérées par Grafana. Pour utiliser le modèle pour les alertes gérées par des sources de données, supprimez les références à DashboardUrl et SilenceURL. Pour plus d'informations sur la configuration des notifications Prometheus, consultez la documentation de [Prometheus](https://prometheus.io/docs/alerting/latest/notifications/) sur les notifications.

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Pour créer un modèle pour le contenu d'un message Slack**

1. Créez un modèle appelé `slack` avec deux modèles dans le contenu : `slack.print_alert` et`slack.message`.

   Le `slack.print_alert` modèle est utilisé pour imprimer les étiquettes, les annotations et l'URL du tableau de bord tandis que le `slack.message` modèle contient la structure de la notification.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Exécutez le modèle à partir du champ du corps du texte lors de l'intégration de votre point de contact :

   ```
   {{ template "slack.message" . }}
   ```

## Modélisez à la fois vos e-mails et Slack avec des modèles partagés
<a name="v10-alerting-create-shared-templates"></a>

Au lieu de créer des modèles de notification distincts pour chaque point de contact, tels que les e-mails et Slack, vous pouvez partager le même modèle.

Par exemple, si vous souhaitez envoyer un e-mail avec cet objet et un message Slack avec ce titre`1 firing alerts, 0 resolved alerts`, vous pouvez créer un modèle partagé.

**Pour créer un modèle partagé**

1. Créez un modèle appelé `common.subject_title` avec le contenu suivant :

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Pour les e-mails, exécutez le modèle à partir du champ d'objet de l'intégration de votre point de contact e-mail :

   ```
   {{ template "common.subject_title" . }}
   ```

1. Pour Slack, exécutez le modèle à partir du champ de titre dans l'intégration de votre point de contact Slack :

   ```
   {{ template "common.subject_title" . }}
   ```

## Utilisation de modèles de notification
<a name="v10-alerting-use-notification-templates"></a>

Utilisez des modèles dans les points de contact pour personnaliser vos notifications.

**Pour utiliser un modèle lors de la création d'un point de contact**

1. Dans le menu **Alertes**, choisissez l'onglet **Points de contact** pour afficher la liste des points de contact existants.

1. Choisissez **Nouveau**. Vous pouvez également modifier un point de contact existant en cliquant sur l'icône **Modifier**.

1. Entrez les modèles que vous souhaitez utiliser dans un champ, tel que **Message** ou **Objet**. Pour saisir un modèle, utilisez le formulaire `{{ template "template_name" . }}` en le *template\$1name* remplaçant par le nom du modèle que vous souhaitez utiliser.

1. Choisissez **Enregistrer le point de contact**.

# Référence de modèles
<a name="v10-alerting-template-reference"></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 de référence pour créer vos modèles.

**Alerte (type)**

Le type d'alerte contient les données suivantes.


| Name | Kind | Description | Exemple | 
| --- | --- | --- | --- | 
|  Statut  |  chaîne  |  `firing` ou `resolved`.  | \$1\$1 .Status \$1\$1 | 
|  Étiquettes  |  KeyValue  |  Ensemble d'étiquettes associées à l'alerte.  | \$1\$1 .Labels \$1\$1 | 
|  Annotations  |  KeyValue  |  Ensemble d'annotations associées à l'alerte.  | \$1\$1 .Annotations \$1\$1 | 
| Valeurs | KeyValue | Les valeurs de toutes les expressions, y compris les conditions classiques | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  Heure. Heure  |  Heure à laquelle l'alerte a commencé à se déclencher.  | \$1\$1 .StartsAt \$1\$1 | 
|  EndsAt  |  Heure. Heure  |  Paramétré uniquement si l'heure de fin d'une alerte est connue. Sinon, définissez un délai d'expiration configurable à compter de la date de réception de la dernière alerte.  | \$1\$1 .EndsAt \$1\$1 | 
|  URL du générateur  |  chaîne  |  Un lien de retour vers Grafana ou un Alertmanager externe.  | \$1\$1 .GeneratorURL \$1\$1 | 
|  URL de silence  |  chaîne  |  Un lien pour désactiver l'alerte (avec des étiquettes préremplies pour cette alerte). Uniquement pour les alertes gérées par Grafana.  | \$1\$1 .SilenceURL\$1\$1 | 
|  URL du tableau de bord  |  chaîne  |  Lien vers le tableau de bord de Grafana, si la règle d'alerte appartient à l'une d'entre elles. Uniquement pour les alertes gérées par Grafana.  | \$1\$1 .DashboardURL \$1\$1 | 
|  URL du panneau  |  chaîne  |  Lien vers le panneau du tableau de bord de Grafana, si la règle d'alerte appartient à l'une d'entre elles. Uniquement pour les alertes gérées par Grafana.  | \$1\$1 .PanelURL \$1\$1 | 
|  Empreinte  |  chaîne  |  Empreinte digitale qui peut être utilisée pour identifier l'alerte.  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  chaîne  |  Chaîne contenant les libellés et la valeur de chaque expression réduite de l'alerte.  | \$1\$1 .ValueString \$1\$1 | 

 **ExtendedData**

L' ExtendedData objet contient les propriétés suivantes.


| Name | Kind | Description | Exemple | 
| --- | --- | --- | --- | 
|  Récepteur  |  `string`  |  Nom du point de contact qui envoie la notification.  |  `{{ .Receiver }}`  | 
|  Statut  |  `string`  |  L'état indique `firing` si au moins une alerte est déclenchée, sinon`resolved`.  |  `{{ .Status }}`  | 
|  Alerts (Alertes)  |  `[]Alert`  |  Liste de toutes les alertes déclenchées et résolues dans cette notification.  |  `There are {{ len .Alerts }} alerts`  | 
|  Alertes de tir  |  `[]Alert`  |  Liste de toutes les alertes de tir contenues dans cette notification.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Alertes résolues  |  `[]Alert`  |  Liste de toutes les alertes résolues dans cette notification.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Les étiquettes qui regroupent ces alertes dans cette notification.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Les libellés communs à toutes les alertes de cette notification.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  Les annotations communes à toutes les alertes de cette notification.  |  `{{ .CommonAnnotations }}`  | 
|  URL externe  |  `string`  |  Un lien vers l'espace de travail Grafana ou Alertmanager qui a envoyé cette notification.  |  `{{ .ExternalURL }}`  | 

**KeyValue type**

Le `KeyValue` type est un ensemble de paires de key/value chaînes qui représentent des étiquettes et des annotations.

Outre l'accès direct aux données stockées sous forme de fichier`KeyValue`, il existe également des méthodes de tri, de suppression et de transformation des données.


| Name | Arguments | Renvoie | Remarques | Exemple | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Liste triée des paires de chaînes de clés et de valeurs  |    | `{{ .Annotations.SortedPairs }}` | 
|  Supprimer  |  [] chaîne  |  KeyValue  |  Renvoie une copie de la Key/Value carte sans les clés données.  | `{{ .Annotations.Remove "summary" }}` | 
|  Noms  |    |  [] chaîne  |  Liste des noms  | `{{ .Names }}` | 
|  Valeurs  |    |  [] chaîne  |  Liste de valeurs  | `{{ .Values }}` | 

**Time (Période)**

L'heure est comptée dans le [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)package Go. Vous pouvez imprimer une heure dans différents formats. Par exemple, pour imprimer l'heure à laquelle une alerte s'est déclenchée dans ce format`Monday, 1st January 2022 at 10:00AM`, vous devez écrire le modèle suivant :

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Vous pouvez trouver une référence pour le format horaire de Go [ici](https://pkg.go.dev/time#pkg-constants).

# Gérer les points de contact
<a name="v10-alerting-manage-contactpoints"></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)

La vue de la liste des **points de contact** répertorie tous les points de contact et modèles de notification existants.

Dans l'onglet **Points de contact**, vous pouvez :
+ Recherchez les noms et les types de points de contact et d'intégrations.
+ Consultez tous les points de contact et intégrations existants.
+ Consultez le nombre de politiques de notification pour lesquelles chaque point de contact est utilisé et accédez directement aux politiques de notification associées.
+ Consultez l'état des envois de notifications.
+ Exportez des points de contact individuels ou tous les points de contact au format JSON, YAML ou Terraform.
+ Supprimez les points de contact qui ne sont pas utilisés par une politique de notification.

Dans l'onglet **Modèles de notification**, vous pouvez :
+ Affichez, modifiez, copiez ou supprimez les modèles de notification existants.

# Désactiver les notifications d'alerte
<a name="v10-alerting-silences"></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)

Vous pouvez supprimer les notifications d'alerte par un *silence*. Un silence empêche uniquement la création de notifications : les silences n'empêchent pas l'évaluation des règles d'alerte et n'empêchent pas l'affichage des instances d'alerte dans l'interface utilisateur. Lorsque vous désactivez une alerte, vous spécifiez une période pendant laquelle elle doit être supprimée.

**Note**  
Pour supprimer les notifications d'alerte à intervalles réguliers, par exemple pendant les périodes de maintenance régulières, utilisez-les [Horaire du mode muet](v10-alerting-manage-muting.md) plutôt que des silences.

**Pour ajouter un silence**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Silences.**

1. Choisissez un gestionnaire d'alertes dans la liste déroulante du gestionnaire d'**alertes**.

1. Choisissez **Create Silence**.

1. Sélectionnez les dates de début et de fin dans **Début et fin du silence** pour indiquer quand le silence doit entrer en vigueur et quand il doit prendre fin.

1. Au lieu de définir une heure de fin, dans **Durée**, spécifiez la durée pendant laquelle le silence est appliqué. Cela met automatiquement à jour l'heure de fin dans les champs de **début et de fin du silence**.

1. Dans les champs **Étiquette** et **Valeur**, entrez une ou plusieurs *étiquettes correspondantes*. Les matchers déterminent les règles auxquelles le silence s'applique. Toutes les alertes correspondantes (en état de déclenchement) apparaîtront dans le champ **Instances d'alertes concernées**.

1. Ajoutez éventuellement un **commentaire** décrivant le silence.

1. Sélectionnez **Soumettre**.

**Pour modifier un silence**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Silences** pour afficher la liste des silences existants.

1. Recherchez le silence que vous souhaitez modifier, puis choisissez **Modifier** (icône en forme de stylo).

1. Apportez les modifications souhaitées, puis choisissez **Soumettre** pour enregistrer vos modifications.

Vous pouvez modifier un silence existant en cliquant sur l'icône **Modifier** (stylo).

**Pour créer un lien URL vers un formulaire de silence**

Lorsque vous créez un lien vers un formulaire de silence, fournissez les libellés correspondants par défaut, ainsi que les paramètres de commentaire `matcher` et de `comment` requête. Le `matcher` paramètre doit être au format suivant, dans `[label][operator][value]` lequel le `operator` paramètre peut être l'un des suivants : `=` (égal, pas regex), `!=` (pas égal, pas regex), `=~` (égal, regex), `!~` (non égal, regex). L'URL peut contenir de nombreux paramètres de requête avec la clé`matcher`. Par exemple, pour créer un lien vers un formulaire de silence avec les libellés `severity=critical` `cluster!~europe-.*` et les commentaires correspondants`Silence critical EU alerts`, créez une URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.

Pour créer un lien vers une nouvelle page de silence pour un Alertmanager externe, ajoutez un `alertmanager` paramètre de requête

**Pour supprimer un silence**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Silences** pour afficher la liste des silences existants.

1. Sélectionnez le silence auquel vous souhaitez mettre fin, puis choisissez Annuler **le silence**. Cela met fin à la suppression de l'alerte.
**Note**  
La désactivation met fin à la suppression de l'alerte, comme si l'heure de fin était définie pour l'heure actuelle. Les silences qui ont pris fin (automatiquement ou manuellement) sont conservés et répertoriés pendant cinq jours. Vous ne pouvez pas supprimer un silence de la liste manuellement.

# Afficher et filtrer les règles d'alerte
<a name="v10-alerting-manage-rules-viewfilter"></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)

La page **Alertes** répertorie les règles d'alerte. Par défaut, les règles sont regroupées par type de source de données. La section **Grafana** répertorie les règles gérées par Grafana. Les règles d'alerte pour les sources de données compatibles avec Prometheus sont également répertoriées ici. Vous pouvez consulter les règles d'alerte pour les sources de données compatibles avec Prometheus, mais vous ne pouvez pas les modifier.

La section Mimir/Cortex/Loki des règles répertorie toutes les règles relatives aux sources de données Mimir, Cortex ou Loki. Les règles d'alerte cloud sont également répertoriées dans cette section.

Lorsque vous gérez de gros volumes d'alertes, vous pouvez utiliser des fonctionnalités de recherche de règles d'alerte étendues pour filtrer les dossiers, les groupes d'évaluation et les règles. En outre, vous pouvez filtrer les règles d'alerte en fonction de leurs propriétés telles que les étiquettes, l'état, le type et l'état de santé.

## Afficher les règles d'alerte
<a name="v10-alerting-manage-rules-view"></a>

Grâce aux alertes Grafana, vous pouvez consulter toutes vos alertes sur une seule page.

**Pour afficher les détails des alertes**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez **Alerting, Alert** rules.** Par défaut, la vue en liste est affichée.

1. Dans **Afficher sous**, vous pouvez basculer entre les affichages groupé, liste et état en choisissant l'option que vous préférez.

1. Développez la ligne des règles pour afficher les étiquettes des règles, les annotations, les sources de données, les requêtes relatives aux règles et la liste des instances d'alerte résultant de la règle.

À partir de cette page, vous pouvez également créer des copies d'une règle d'alerte pour vous aider à réutiliser les règles existantes.

## Exporter les règles d'alerte
<a name="v10-alerting-manage-rules-export"></a>

Vous pouvez exporter les règles au format YAML ou JSON dans l'espace de travail Grafana.
+ Choisissez l'icône **Exporter le groupe de règles** à côté de chaque groupe de règles d'alerte à exporter vers YAML, JSON ou Terraform.
+ Choisissez **Exporter les règles** pour exporter toutes les règles d'alerte gérées par Grafana vers YAML, JSON ou Terraform.
+ Choisissez **Plus**, **Modifier et exporter** à côté de chaque règle d'alerte individuelle au sein d'un groupe pour modifier les règles d'alerte configurées et exporter une version modifiée.

## Afficher les définitions de requêtes pour les alertes provisionnées
<a name="v10-alerting-manage-rules-querydef"></a>

Affichez les définitions de requêtes en lecture seule pour les alertes provisionnées. Vérifiez rapidement si vos requêtes relatives aux règles d'alerte sont correctes, sans avoir à consulter votre référentiel « en tant que code » pour les définitions de règles.

**Vue groupée**

La vue groupée montre les règles d'alerte Grafana regroupées par dossier et les règles d'alerte Loki ou Prometheus groupées par \$1. `namespace` `group` Il s'agit de la vue de liste de règles par défaut, destinée à la gestion des règles. Vous pouvez développer chaque groupe pour afficher la liste des règles de ce groupe. Développez davantage une règle pour en afficher les détails. Vous pouvez également développer les boutons d'action et les alertes résultant de la règle pour en afficher les détails.

**Vue de l'État**

La vue État affiche les règles d'alerte regroupées par état. Utilisez cette vue pour avoir une vue d'ensemble des règles dans quel état. Chaque règle peut être étendue pour afficher ses détails. Boutons d'action et toutes les alertes générées par cette règle, et chaque alerte peut être étendue pour afficher ses détails.

## Règles de filtrage des alertes
<a name="v10-alerting-manage-rules-filter"></a>

Vous pouvez filtrer les règles d'alerte qui apparaissent sur la page **Alertes de** plusieurs manières.

**Pour filtrer les règles d'alerte**

1. **Dans Sélectionner les sources de données**, sélectionnez une source de données. Vous pouvez voir les règles d'alerte qui interrogent la source de données sélectionnée.

1. Dans **Rechercher par étiquette**, entrez les critères de recherche à l'aide de sélecteurs d'étiquettes. Par exemple, `environment=production;region=~US|EU,severity!=warning`.

1. Dans **Filtrer les alertes par état**, sélectionnez l'état d'alerte que vous souhaitez consulter. Vous pouvez voir les règles d'alerte correspondant à cet état. Les règles correspondant aux autres états sont masquées.

# Horaire du mode muet
<a name="v10-alerting-manage-muting"></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 temps de sourdine est un intervalle de temps récurrent pendant lequel aucune nouvelle notification relative à une politique n'est générée ou envoyée. Utilisez-les pour empêcher les alertes de se déclencher pendant une période spécifique et récurrente, par exemple une période de maintenance régulière.

À l'instar des silences, le temps de mise en sourdine n'empêche pas l'évaluation des règles d'alerte, ni l'affichage des instances d'alerte dans l'interface utilisateur. Ils empêchent uniquement la création de notifications.

Vous pouvez configurer les durées de sourdine gérées par Grafana ainsi que les durées de sourdine pour une source de données Alertmanager externe.

## Timings muets ou silences
<a name="v10-alerting-manage-muting-compare"></a>

Le tableau suivant met en évidence les différences entre les temps de mise en sourdine et les silences.


| Synchronisation en mode muet | Silence | 
| --- | --- | 
| Utilise des définitions d'intervalles de temps qui peuvent se reproduire. | A une heure de début et de fin fixes. | 
| Est créé puis ajouté aux politiques de notification. | Utilise des étiquettes pour établir une correspondance avec une alerte afin de déterminer s'il convient de désactiver ou non. | 

## Ajouter une temporisation muette
<a name="v10-alerting-manage-muting-add"></a>

Vous pouvez créer des horaires muets dans votre espace de travail Grafana.

**Pour ajouter une temporisation muette**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Politiques de notification**, puis sélectionnez l'onglet Durée de **mise en sourdine.**

1. Dans le menu déroulant **Alertmanager**, sélectionnez le Alertmanager que vous souhaitez modifier.

1. Cliquez sur le bouton **\$1 Ajouter une temporisation muette**.

1. Remplissez le formulaire pour créer un [intervalle de temps à comparer](#v10-alerting-manage-muting-interval) à votre temps de mise en sourdine.

1. Enregistrez votre temps de mise en sourdine.

## Ajouter une temporisation muette à une politique de notification
<a name="v10-alerting-manage-muting-add-notif"></a>

Une fois que vous avez défini le temps de mise en sourdine, vous pouvez l'utiliser en l'ajoutant à la politique de notification que vous souhaitez désactiver à intervalles réguliers.

**Pour ajouter une temporisation muette à une politique de notification**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Politiques de notification**, puis sélectionnez l'onglet **Politiques de notification**.

1. **Sélectionnez la politique de notification à laquelle vous souhaitez ajouter le temps de sourdine, puis choisissez...** , **Modifier**.

1. Dans le menu déroulant Durée de **mise en sourdine**, sélectionnez la durée de mise en sourdine que vous souhaitez ajouter à la politique.

1. Enregistrez vos modifications.

## Intervalles de temps
<a name="v10-alerting-manage-muting-interval"></a>

Un intervalle de temps est une durée spécifique pendant laquelle les alertes sont supprimées. La durée comprend généralement une plage de temps spécifique et les jours de la semaine, du mois ou de l'année. 

Support : les options d'intervalle de temps sont les suivantes :
+ **Plage horaire** : heure comprise entre l'heure de début et l'heure de fin (en UTC, si aucun lieu n'a été sélectionné, sinon heure locale).
+ **Emplacement** — Définit le lieu pour le chronométrage : la plage horaire est affichée en heure locale pour le lieu.
+ **Jours de la semaine** : jour ou plage de jours de la semaine. Par exemple, `monday:thursday`.
+ **Jours du mois** : dates comprises dans un mois. Les valeurs peuvent être comprises entre `1` -`31`. Les valeurs négatives indiquent les jours du mois dans l'ordre inverse, ce `-1` qui représente le dernier jour du mois.
+ **Mois** — Les mois de l'année sont exprimés sous forme numérique ou sous le nom complet du mois calendaire. Par exemple, `1, may:august`.
+ **Années** : année ou années de l'intervalle. Par exemple, `2023:2024`.

Chacun de ces éléments peut être une liste, et au moins un élément de l'élément doit être satisfait pour correspondre. Les champs prennent également en charge les plages, en utilisant`:`. Par exemple, `monday:thursday`.

Si un champ est laissé vide, le champ correspondra à tout moment. Pour qu'un instant corresponde à un intervalle de temps complet, tous les champs doivent correspondre. Une temporisation muette peut contenir plusieurs intervalles de temps.

Si vous souhaitez spécifier une durée exacte, spécifiez toutes les options nécessaires pour cette durée. Par exemple, si vous souhaitez créer un intervalle de temps pour le premier lundi du mois, pour mars, juin, septembre et décembre, entre 12 h 00 et 24 h 00 UTC, votre spécification d'intervalle de temps peut être la suivante :
+ Plage de temps :
  + Heure de début : `12:00`
  + Heure de fin : `24:00`
+ Jours de la semaine : `monday`
+ Mois : `3, 6, 9, 12`
+ Jours du mois : `1:7`

# Afficher l'état et l'état des règles d'alerte
<a name="v10-alerting-manage-rulestate"></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)

Les règles relatives à l'état et à l'état des alertes vous fournissent plusieurs indicateurs de statut clés concernant vos alertes.

Il y a trois composantes :
+ [État de la règle d'alerte](#v10-alerting-manage-rulestate-state)
+ [État de l'instance d'alerte](#v10-alerting-manage-rulestate-instance)
+ [État des règles d'alerte](#v10-alerting-manage-rulestate-health)

Bien que lié, chaque composant transmet des informations subtilement différentes.

**Pour consulter l'état et l'état de vos règles d'alerte**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Règles d'alerte** pour afficher la liste des alertes existantes.

1. Choisissez une règle d'alerte pour voir son état et son état de santé.

## État de la règle d'alerte
<a name="v10-alerting-manage-rulestate-state"></a>

Une règle d'alerte peut avoir l'un des états suivants :


| State | Description | 
| --- | --- | 
| Normal | Aucune des séries chronologiques renvoyées par le moteur d'évaluation n'est à firing l'état pending or. | 
| En suspens | Au moins une série chronologique renvoyée par le moteur d'évaluation estpending. | 
| Mise à feu | Au moins une série chronologique renvoyée par le moteur d'évaluation estfiring. | 

**Note**  
Les alertes passent d'abord à `pending` puis`firing`, il faut donc au moins deux cycles d'évaluation avant qu'une alerte ne soit déclenchée.

## État de l'instance d'alerte
<a name="v10-alerting-manage-rulestate-instance"></a>

Une instance d'alerte peut se trouver dans l'un des états suivants :


| State | Description | 
| --- | --- | 
| Normal | État d'une alerte qui n'est ni « pending ni firing ». Tout fonctionne comme prévu. | 
| En suspens | État d'une alerte active pendant une durée inférieure au seuil configuré. | 
| Alerte | État d'une alerte active pendant une durée supérieure au seuil configuré. | 
| Aucune donnée | Aucune donnée n'a été reçue pour la fenêtre horaire configurée. | 
| Alerte | Une erreur s'est produite lors de la tentative d'évaluation d'une règle d'alerte. | 

## Conserver le dernier état
<a name="v10-alerting-manage-rulestate-keepstate"></a>

Une règle d'alerte peut être configurée pour conserver le dernier état lorsqu'un `Error` état `NoData` ou est détecté. Cela empêchera à la fois le déclenchement des alertes, leur résolution et leur réactivation. Tout comme dans le cas d'une évaluation normale, la règle d'alerte passera de `pending` à une `firing` fois la période d'attente écoulée.

## État des règles d'alerte
<a name="v10-alerting-manage-rulestate-health"></a>

Une règle d'alerte peut avoir l'un des états de santé suivants.


| State | Description | 
| --- | --- | 
| D'accord | Aucune erreur lors de l'évaluation de la règle d'alerte. | 
| Error (Erreur) | Une erreur s'est produite lors de l'évaluation de la règle d'alerte. | 
| NoData | Absence de données dans au moins une série chronologique renvoyée lors de l'évaluation d'une règle. | 
| \$1statut\$1, KeepLast | La règle aurait reçu un autre statut, mais elle a été configurée pour conserver le dernier état de la règle d'alerte. | 

## Alertes spéciales en cas NoData d'erreur
<a name="v10-alerting-manage-rulestate-special"></a>

Lorsque l'évaluation d'une règle d'alerte produit l'état `NoData` ou`Error`, l'alerte Grafana génère des instances d'alerte portant les étiquettes supplémentaires suivantes.


| Étiquette | Description | 
| --- | --- | 
| nom de l'alerte | SoitDatasourceError, DatasourceNoData soit, selon l'état. | 
| dataource\$1uid | L'UID de la source de données à l'origine de l'état. | 

**Note**  
Vous devez définir la règle d'absence de données ou de gestion des erreurs sur `NoData` ou `Error` dans la règle d'alerte, comme décrit dans la [Configurer les règles d'alerte gérées par Grafana](v10-alerting-configure-grafanamanaged.md) rubrique, pour générer les étiquettes supplémentaires.

Vous pouvez gérer ces alertes de la même manière que les alertes classiques, notamment en ajoutant des silences, en les acheminant vers un point de contact, etc.

# Afficher et filtrer par groupes d'alertes
<a name="v10-alerting-manage-viewfiltergroups"></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 groupes d'alertes affichent les alertes groupées provenant d'une instance d'Alertmanager. Par défaut, les règles d'alerte sont regroupées en fonction des clés d'étiquette correspondant à la politique par défaut dans les politiques de notification. Le regroupement des règles d'alerte communes dans un seul groupe d'alertes empêche le déclenchement de règles d'alerte dupliquées.

Vous pouvez afficher les groupes d'alertes et également filtrer les règles d'alerte correspondant à des critères spécifiques.

**Pour afficher les groupes d'alertes**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Groupes** pour afficher les groupes existants.

1. Dans le menu déroulant **Alertmanager**, sélectionnez un Alertmanager externe comme source de données.

1. Dans le menu déroulant **Grouper par personnalisé**, sélectionnez une combinaison d'étiquettes pour afficher un regroupement autre que celui par défaut. Cela est utile pour déboguer et vérifier votre regroupement de politiques de notification.

Si une alerte ne contient aucune étiquette spécifiée dans le regroupement de la politique racine ou dans le regroupement personnalisé, l'alerte est ajoutée à un groupe catch all avec un en-tête de`No grouping`.

Vous pouvez filtrer les alertes par étiquette ou par état des alertes.

**Pour filtrer par étiquette**
+ Dans **Rechercher**, entrez une étiquette existante pour afficher les alertes correspondant à cette étiquette.

  Par exemple, `environment=production,region=~US|EU,severity!=warning`.

**Pour filtrer par état**
+ Dans **États**, sélectionnez l'état actif, supprimé ou non traité pour afficher les alertes correspondant à l'état sélectionné. Toutes les autres alertes sont masquées.

# Afficher les erreurs de notification
<a name="v10-alerting-manage-viewnotificationerrors"></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)

Consultez les erreurs de notification et comprenez pourquoi elles n'ont pas été envoyées ou n'ont pas été reçues.

**Note**  
Cette fonctionnalité n'est prise en charge que pour Grafana Alertmanager.

**Pour afficher les erreurs de notification**

1. Dans le menu de gauche, choisissez **Alerte** puis **Points de contact**.

   Si l'un des points de contact est défaillant, un message dans le coin droit de l'espace de travail vous indique qu'il y a des erreurs et leur nombre.

1. Sélectionnez un point de contact pour afficher le détail des erreurs associées à ce point de contact.

   Les détails de l'erreur s'affichent si vous passez le curseur sur l'icône d'erreur.

   Si un point de contact possède plusieurs intégrations, toutes les erreurs s'affichent pour chacune des intégrations répertoriées.

1. Dans la colonne Health, vérifiez l'état de la notification.

   Cela peut être OK, Aucune tentative ou Erreur.