

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 8 de Grafana
<a name="using-grafana-v8"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

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 8 de Grafana.

**Topics**
+ [Panneaux](Grafana-panels.md)
+ [Tableaux de bord](dashboard-overview.md)
+ [Explorez](explore.md)
+ [Liens](linking-in-Amazon-Managed-Service-for-Grafana.md)
+ [Modèles et variables](templates-and-variables.md)
+ [Alerte Grafana](alerts-overview.md)

# Panneaux
<a name="Grafana-panels"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau est l'élément de base de la visualisation dans un serveur Grafana. Un panneau est une représentation visuelle d'une ou de plusieurs requêtes, à l'exception de quelques panneaux à usage spécial. Les requêtes affichent des données au fil du temps. Cela peut aller des fluctuations de température à l'état actuel du serveur, en passant par une liste de journaux ou d'alertes.

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 permet d'extraire une visualisation à afficher sur le panneau.



Pour afficher des données, vous devez avoir ajouté au moins une source de données à votre espace de travail. Pour plus d'informations sur les sources de données, consultez[Connexion aux sources de données](AMG-data-sources.md).

Il existe une grande variété d'options de style et de mise en forme pour chaque panneau. Les panneaux peuvent être déplacés, réorganisés et redimensionnés.

**Topics**
+ [Ajouter un panneau](add-a-panel-to-a-dashboard.md)
+ [Supprimer un panneau](Deleting-a-panel.md)
+ [Requêtes](panel-queries.md)
+ [Requêtes enregistrées](recorded-queries.md)
+ [Transformations](panel-transformations.md)
+ [Options de champ et remplacements](field-options-overrides.md)
+ [Éditeur de panneaux](AMG-panel-editor.md)
+ [Panneaux de bibliothèque](AMG-library-panel.md)
+ [Visualisations](AMG-visualizations.md)

# Ajouter un panneau
<a name="add-a-panel-to-a-dashboard"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Vous pouvez utiliser des panneaux pour afficher vos données sous forme visuelle. Cette rubrique décrit les étapes de base nécessaires à la création d'un panneau. 

**Pour ajouter un panneau à un tableau de bord**

1.  Choisissez le tableau de bord auquel vous souhaitez ajouter un panneau. 

1.  Cliquez sur l'icône **Ajouter un panneau**. 

1.  Choisissez **Ajouter un nouveau panneau**. 

    L'espace de travail Grafana crée un panneau graphique vide avec votre source de données par défaut sélectionnée. 

1.  Bien que cela ne soit pas obligatoire, nous vous recommandons d'ajouter un titre et une description utiles à votre panneau. Vous pouvez éventuellement utiliser des variables que vous avez définies dans l'un ou l'autre des champs, mais pas des variables globales. Pour de plus amples informations, veuillez consulter [Modèles et variables](templates-and-variables.md).
   + **Titre du panneau** — Le texte saisi dans ce champ est affiché en haut de votre panneau dans l'éditeur de panneau et dans le tableau de bord.
   + **Description** — Le texte saisi dans ce champ est affiché dans une infobulle dans le coin supérieur gauche du panneau. Rédigez une description du panneau et des données que vous affichez.

1. Rédigez une requête pour le panneau. Pour afficher une visualisation, chaque panneau a besoin d'au moins une requête. Vous rédigez des **requêtes dans l'onglet Requête** de l'éditeur de panneaux. Pour de plus amples informations, veuillez consulter [Requêtes](panel-queries.md).

   1. Choisissez une source de données. Dans la première ligne de l'onglet **Requête**, choisissez la liste déroulante pour voir toutes les sources de données disponibles. Cette liste inclut toutes les sources de données que vous avez ajoutées. Pour plus d'informations sur les sources de données, consultez[Connexion aux sources de données](AMG-data-sources.md). 

   1. Rédigez ou créez une requête dans le langage de requête de votre source de données. Les options peuvent varier. Consultez la documentation de votre source de données spécifique pour obtenir des directives spécifiques. 

1.  Dans la section **Visualisation** de l'onglet **Panneau**, choisissez un type de visualisation. L'espace de travail Grafana affiche un aperçu des résultats de vos requêtes une fois cette visualisation appliquée. 

1. Nous vous recommandons d'ajouter une note pour décrire vos modifications avant de sélectionner **Enregistrer**. Les notes sont utiles si vous devez rétablir une version précédente du tableau de bord. 

1.  Pour enregistrer le tableau de bord, choisissez **Enregistrer** dans le coin supérieur droit de l'écran. 

# Supprimer un panneau
<a name="Deleting-a-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Pour supprimer un panneau dans Grafana, procédez comme suit :
+  Choisissez le menu déroulant à côté du titre du panneau, puis sélectionnez **Supprimer le panneau**. 

or
+ Passez le pointeur sur le panneau et utilisez la séquence de raccourcis clavier « p r ».

# Requêtes
<a name="panel-queries"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Les panneaux de l'espace de travail Grafana utilisent *des requêtes* pour communiquer avec les sources de données afin d'obtenir des données pour la visualisation. Une requête est une question écrite dans le langage de requête utilisé par la source de données. Si la requête est correctement formée, la source de données répond. Dans les options de source de données du panneau, vous pouvez ajuster la fréquence à laquelle la requête est envoyée à la source de données et le nombre de points de données collectés. 

 Les espaces de travail Grafana prennent en charge jusqu'à 26 requêtes par panneau. 

## Éditeurs de requêtes
<a name="query-editors"></a>

 Les éditeurs de requêtes sont des formulaires qui vous aident à rédiger des requêtes. En fonction de votre source de données, l'éditeur de requêtes peut fournir une complétion automatique, des noms de métriques ou des suggestions de variables. 

 En raison des différences entre les langages de requête, les sources de données peuvent avoir des éditeurs de requêtes d'apparence différente.

## Syntaxe de requête
<a name="query-syntax"></a>

 Les sources de données utilisent des langages de requête et des syntaxes différents pour demander les données. Voici deux exemples de requêtes.

 **PostgreSQL** 

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

 **ProMQL** 

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

 Pour plus d'informations sur la rédaction d'une requête pour votre source de données, consultez la documentation de cette source de données. Les sources de données sont répertoriées dans[Connexion aux sources de données](AMG-data-sources.md).

## Interface utilisateur de l'onglet Requête
<a name="query-tab-ui"></a>

 L'onglet **Requête** comprend les éléments suivants : 
+  Sélecteur de source de données 
+  Options de requête 
+  Bouton de l'inspecteur de requêtes 
+  Liste de l'éditeur de requêtes 

### Sélecteur de source de données
<a name="data-source-selector"></a>

 Le sélecteur de source de données est une liste déroulante. Sélectionnez-le pour sélectionner une source de données que vous avez ajoutée. Lorsque vous créez un panneau, Amazon Managed Grafana sélectionne automatiquement votre source de données par défaut. Pour plus d'informations sur les sources de données, consultez[Connexion aux sources de données](AMG-data-sources.md). 

 Outre les sources de données que vous avez configurées dans votre espace de travail Grafana, trois sources de données spéciales sont disponibles. 
+ **TestDataDB** — Source de données intégrée qui génère des données de marche aléatoires. La source de données Grafana est utile pour tester des visualisations et exécuter des expériences.
+  **Mixte** : source de données permettant d'interroger plusieurs sources de données dans le même panneau. Lorsque cette source de données est sélectionnée, vous pouvez sélectionner une source de données pour chaque nouvelle requête que vous ajoutez.
  +  La première requête utilisera la source de données sélectionnée avant que vous ne sélectionniez **Mixed**. 
  +  Vous ne pouvez pas modifier une requête existante pour utiliser la source de données mixte. 
+ **Tableau de bord** : source de données permettant d'utiliser un ensemble de résultats provenant d'un autre panneau du même tableau de bord. 

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

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

 Amazon Managed Grafana définit les valeurs par défaut qui sont affichées en 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. 

 Vous pouvez utiliser les options de requête de source de données du panneau suivantes : 
+  **Nombre maximal de points de données** : si la source de données le prend en charge, définit le nombre maximal 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 les consolide (réduit le nombre de points renvoyés en les agrégeant par moyenne, maximum ou autre fonction). 

   Deux raisons principales justifient de limiter le nombre de points : les performances et le lissage de la ligne. La valeur par défaut est la largeur (ou le nombre de pixels) du graphique, ce qui permet d'éviter d'avoir plus de points de données que ce que le panneau graphique peut afficher. 

   Dans le cas des données en streaming, la valeur maximale des points de données est utilisée pour la mémoire tampon mobile. (Le streaming est un flux continu de données, et la mise en mémoire tampon est un moyen de diviser le flux en morceaux). 
+  **Intervalle minimum** — Définit une limite minimale pour l'intervalle calculé automatiquement, généralement l'intervalle de capture minimum. Si un point de données est enregistré toutes les 15 secondes, il n'est pas nécessaire d'avoir un intervalle inférieur à cet intervalle. Un autre cas d'utilisation consiste à le définir sur un minimum supérieur à l'intervalle de capture pour obtenir des requêtes plus grossières et plus efficaces. 
+  **Intervalle : intervalle** de temps que vous pouvez utiliser pour agréger ou regrouper des points de données par temps. 

   Amazon Managed Grafana calcule automatiquement un intervalle approprié qui peut être utilisé comme variable dans les requêtes modélisées. La variable est soit en secondes : `$__interval` ; soit en millisecondes :. `$__interval_ms` Il est généralement utilisé dans des fonctions d'agrégation telles que `sum` ou`average`. Par exemple, il s'agit d'une requête Prometheus utilisant la variable d'intervalle :. `rate(http_requests_total[$__interval])` 

   Cet intervalle automatique est calculé en fonction de la largeur du graphique. Si l'utilisateur effectue un zoom arrière important, l'intervalle augmente, ce qui donne une agrégation plus grossière. Si l'utilisateur zoome, l'intervalle diminue, ce qui permet une agrégation plus fine. 

   Pour de plus amples informations, veuillez consulter [Variables globales](variables-types.md#global-variables). 
+  **Temps relatif** : remplace la plage de temps relative pour les différents panneaux, ce qui les rend différents de ce qui est sélectionné dans le sélecteur de temps du tableau de bord situé dans le coin supérieur droit du tableau de bord. Cela vous permet d'afficher les statistiques de différentes périodes ou de différents jours sur le même tableau de bord. 
+  **Décalage horaire — Fournit un autre moyen de modifier** la plage de temps pour les panneaux individuels. Cette fonction fonctionne uniquement avec des plages de temps relatives, et vous pouvez ajuster la plage de temps. 

   Par exemple, vous pouvez modifier la plage horaire du panneau de manière à ce qu'elle soit 2 heures plus tôt que le sélecteur d'heure du tableau de bord. Pour de plus amples informations, veuillez consulter [Contrôles de plage de temps](dashboard-time-range-controls.md). 
+  **Délai d'expiration du cache** — (Ce champ n'est visible que s'il est disponible dans votre 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. Elle est spécifiée sous forme de valeur numérique en secondes. 

### Bouton de l'inspecteur de requêtes
<a name="query-inspector-button"></a>

 Vous pouvez choisir **l'inspecteur de requêtes** pour ouvrir l'onglet **Requête** de l'inspecteur du panneau. Dans l'onglet **Requête**, vous pouvez voir la demande de requête envoyée par le panneau et la réponse. 

 Choisissez **Actualiser** pour voir le texte intégral de la demande envoyée par ce panneau au serveur. 

**Note**  
 Vous devez ajouter au moins une requête avant que l'inspecteur de requêtes puisse renvoyer des résultats. 

 Pour plus d'informations sur l'inspecteur de panneau, voir[Inspecter un panneau](inspect-a-panel.md). 

### Liste de l'éditeur de requêtes
<a name="query-editor-list"></a>

 Dans l'interface utilisateur, les requêtes sont organisées 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.). 

## Partage des résultats de requêtes entre les panneaux
<a name="share-query-results-between-panels"></a>

 Avec Amazon Managed Grafana, vous pouvez 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, Amazon Managed 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, par exemple, plusieurs panneaux visualisent les mêmes données. 

**Pour partager des requêtes de source de données avec un autre panneau**

1.  Créez un tableau de bord. Pour de plus amples informations, veuillez consulter [Créer un tableau de bord](getting-started-grafanaui.md#create-a-dashboard). 

1.  Ajoutez un panneau. Pour de plus amples informations, veuillez consulter [Ajouter un panneau](add-a-panel-to-a-dashboard.md). 

1.  Changez le titre en**Source panel**. Vous allez utiliser ce panneau comme source pour les autres panneaux. Définissez la ou les requêtes qui seront partagées. Si aucune source de données n'est disponible pour le moment, vous pouvez utiliser 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, puis sélectionnez la source de données du **tableau** de bord dans l'éditeur de requêtes. 

1.  Dans **Utiliser les résultats de la liste des panneaux**, 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. 

 Pour accéder à un panneau dans lequel une requête est définie, sélectionnez cette requête. 

# Requêtes enregistrées
<a name="recorded-queries"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Vous pouvez voir les tendances au fil du temps en prenant un instantané d'un point de données à un intervalle défini à l'aide de requêtes enregistrées. Cela peut vous donner un aperçu des tendances historiques.

Pour les plugins qui ne renvoient pas de séries chronologiques, il peut être utile de tracer des données historiques. Par exemple, vous souhaiterez peut-être effectuer une requête **ServiceNow**pour consulter l'historique des temps de réponse aux demandes, mais celle-ci ne peut renvoyer que point-in-time les mesures actuelles.

## Fonctionnement des requêtes enregistrées
<a name="how-recorded-queries-work"></a>

Les requêtes enregistrées ne fonctionnent qu'avec les plugins de source de données principaux. Pour plus d'informations, reportez-vous à la section [Plug-in de source de données principal](https://grafana.com/tutorials/build-a-data-source-backend-plugin/). Vous pouvez enregistrer trois types de requêtes :
+ ligne et colonne uniques : requête renvoyant une seule ligne et une seule colonne.
+ nombre de lignes : requête qui renvoie des lignes significatives à compter.
+ expression : n'importe quelle expression. Pour en savoir plus sur la création et l'utilisation d'expressions, consultez la section [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

Une fois qu'une requête enregistrée est créée ou activée, elle crée immédiatement un instantané et continue à créer des instantanés à l'intervalle défini. La requête enregistrée arrête de prendre des instantanés lorsqu'elle est désactivée, supprimée ou lorsque Grafana n'est pas en cours d'exécution. Les points de données sont collectés dans le backend en exécutant la requête enregistrée et en transmettant chaque résultat à une instance Prometheus compatible avec l'écriture à distance.

**Note**  
Vous devez configurer une source de données Prometheus et l'associer à une cible d'écriture distante avant de pouvoir utiliser les requêtes enregistrées.

## Création d'une requête enregistrée
<a name="create-a-recorded-query"></a>

Pour créer une requête enregistrée, procédez comme suit :

1. Recherchez ou créez une requête que vous souhaitez enregistrer sur un tableau de bord dans un panneau d'édition. La requête ne doit renvoyer qu'une seule ligne et une seule colonne. S'il renvoie plus, vous pouvez toujours enregistrer le nombre de résultats renvoyés à l'aide de l'option *count*. La source de données de la requête doit être une source de données principale. Les expressions peuvent être utilisées pour agréger les données d'une requête de série chronologique. Pour en savoir plus sur la création et l'utilisation d'expressions, reportez-vous à la section [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/).

1. Choisissez le menu de **requête d'enregistrement** situé dans l'éditeur de requêtes.

1. Entrez les informations de requête enregistrées. Tous les champs sont obligatoires sauf indication contraire. 
   + Nom : nom de la requête enregistrée.
   + Description - (facultatif) Décrivez la requête enregistrée telle que vous souhaitez qu'elle apparaisse dans la liste des requêtes enregistrées.
   + Intervalle : intervalle auquel le cliché sera pris. L'intervalle commence lorsque vous créez la requête enregistrée et s'arrête si vous interrompez ou supprimez la requête enregistrée. Pour plus d'informations sur la suspension et la suppression des requêtes enregistrées, reportez-vous à la section [Gestion des requêtes enregistrées](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries).
   + Plage : plage de temps relative de la requête. Si vous sélectionnez une plage de 30 m et un intervalle d'une heure, la requête prendra un instantané toutes les heures des 30 dernières minutes.
   + Compter les résultats de la requête : si vous souhaitez compter les lignes renvoyées par votre requête, activez cette option. Si cette option est désactivée, votre requête doit renvoyer une ligne avec une seule valeur.

1. Testez votre requête enregistrée en cliquant sur le bouton Tester la requête enregistrée.

1. Choisissez **Commencer l'enregistrement de la requête**.

## Ajouter une requête enregistrée
<a name="Adding-a-recorded-query"></a>

Vous pouvez ajouter des requêtes enregistrées existantes aux panneaux d'un tableau de bord. Pour chaque requête enregistrée que vous ajoutez, une requête Prometheus est créée :. `generated_recorded_query_name{id="generated_id", name="recorded query name"}` La requête créée par Prometheus renvoie tous les instantanés collectés de la requête enregistrée.

1. Accédez à un panneau d'un tableau de bord dans lequel vous souhaitez ajouter une requête enregistrée.

1. Choisissez le menu **\$1 Requête enregistrée**.

1. Si vous souhaitez filtrer les requêtes enregistrées par source de données, sélectionnez une source de données dans le menu déroulant Filtrer par source de données.

1. Choisissez **Ajouter un** menu sur votre requête enregistrée pour l'ajouter au panneau.

Après avoir ajouté votre requête enregistrée au panneau, la source de données du panneau deviendra`-- Mixed --`. Votre requête enregistrée est représentée par une `Prometheus` requête dont le nom correspond au nom de votre requête enregistrée. Reportez-vous à [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/) pour en savoir plus sur la source de données Prometheus.

Si, après avoir ajouté une requête enregistrée, une requête contenant une source de `-- Mixed --` données au lieu de la source de données Prometheus apparaît, cela peut signifier qu'aucune cible d'écriture `Prometheus ` distante n'a été configurée pour les requêtes enregistrées. Reportez-vous à la section [Cible d'écriture distante](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target) pour configurer un point d'écriture distant.

## Utilisation d'une requête enregistrée
<a name="using-a-recorded-query"></a>

Pour utiliser une requête enregistrée, créez-en une et ajoutez-la à un tableau de bord. Ensuite, il peut être géré dans les **préférences** de l'onglet **Requêtes enregistrées**.

## Gestion des requêtes enregistrées
<a name="managing-recorded-queries"></a>

Les requêtes enregistrées peuvent être suspendues ou activées et supprimées depuis l'onglet Requêtes enregistrées dans les préférences. La suppression d'une requête enregistrée la supprimera de Grafana, mais les informations recueillies dans Prometheus seront toujours présentes. La suspension d'une requête enregistrée ne permet plus de recueillir de nouveaux points de données tant qu'elle n'est pas reprise.

## Cible d'écriture distante
<a name="remote_write_target"></a>

**La cible d'écriture à distance est la source de données Prometheus dans laquelle les points de données de requête enregistrés sont écrits.** Vous aurez besoin d'un Prometheus avec l'écriture à distance activée et vous devrez créer une source de données pour ce Prometheus.

Pour modifier la cible d'écriture à distance, choisissez **Modifier la cible d'écriture à distance** dans le menu de la console, sous l'onglet **Requêtes enregistrées** dans les **préférences**. Sélectionnez la source de données **Prometheus** pour laquelle l'écriture à distance est activée et entrez le chemin d'écriture à distance.

# Transformations
<a name="panel-transformations"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Les transformations traitent le jeu de résultats avant qu'il ne soit transmis à la visualisation. Vous pouvez accéder aux transformations dans l'onglet **Transformation** de l'éditeur de panneaux Amazon Managed Grafana.

Vous pouvez utiliser des transformations pour renommer des champs, joindre des séries chronologiques distinctes, effectuer des calculs entre des requêtes, etc. Si vous avez des tableaux de bord volumineux ou des requêtes volumineuses, la possibilité de réutiliser le résultat de la requête d'un panneau à l'autre peut apporter un gain de performance considérable.

**Note**  
Les transformations se traduisent parfois par des données qui ne peuvent pas être représentées graphiquement. Dans ce cas, Amazon Managed Grafana affiche une suggestion concernant la visualisation. Choisissez la suggestion pour passer à la visualisation sous forme de tableau. Cela vous permet souvent de mieux comprendre les effets de la transformation sur vos données. 

Amazon Managed Grafana applique les transformations dans l'ordre dans lequel elles sont répertoriées à l'écran. Chaque transformation crée un nouveau jeu de résultats qui est transmis à la transformation suivante du pipeline. 

La commande peut faire une énorme différence dans l'apparence de vos résultats. Par exemple, si vous utilisez la transformation de réduction pour condenser tous les résultats d'une colonne en une seule valeur, vous ne pouvez appliquer des transformations qu'à cette valeur unique. 

**Conditions préalables**

Avant d'appliquer des transformations, toutes les conditions suivantes doivent être remplies :
+ Vous avez saisi une requête et renvoyé des données provenant d'une source de données. Pour plus d'informations sur les requêtes, consultez la section [Requêtes](panel-queries.md).
+ Vous avez appliqué une visualisation qui prend en charge les requêtes, telle que l'une des visualisations suivantes :
  + Jauge à barres
  + Jauge
  + Graphe
  + Carte thermique
  + Journaux
  + Stat
  + Table

## Appliquer une transformation
<a name="apply-a-transformation"></a>

 Les transformations sont disponibles dans l'onglet **Transformation** dans le volet inférieur de l'éditeur de panneaux, à côté de l'onglet **Requêtes**. 

**Pour appliquer une transformation**

1.  Dans le panneau auquel vous souhaitez ajouter des transformations, choisissez le titre du panneau, puis sélectionnez **Modifier**. 

1.  Choisissez l'onglet **Transformation**. 

1.  Sélectionnez une transformation. 

    Dans la ligne de transformation qui apparaît, vous pouvez configurer les options de transformation. 

1.  Pour appliquer une autre transformation, choisissez **Ajouter une transformation**. N'oubliez pas que la transformation suivante agit sur le jeu de résultats renvoyé par la transformation précédente. 

 Si vous rencontrez des difficultés, cliquez sur l'icône de bogue pour [débuguer vos transformations](#debug-transformations). 

 Pour supprimer une transformation, cliquez sur l'icône de la corbeille. 

## Types et options de transformation
<a name="transformation-types-and-options"></a>

 Les espaces de travail Grafana incluent les transformations suivantes. 

**Topics**
+ [Réduire](#reduce)
+ [Fusionner](#merge)
+ [Filtrage par nom](#filter-by-name)
+ [Filtrer les données par requête](#filter-data-by-query)
+ [Organiser les champs](#organize-fields)
+ [Joindre par champ (jointure externe)](#join-by-field-outer-join)
+ [Ajouter un champ à partir du calcul](#add-field-from-calculation)
+ [Étiquettes pour les champs](#labels-to-fields)
+ [Grouper par](#sort-by)
+ [Grouper par](#group-by)
+ [De la série aux rangées](#series-to-rows)
+ [Filtrer les données par valeur](#filter-data-by-value)
+ [Transformations de débogage](#debug-transformations)

### Réduire
<a name="reduce"></a>

 Appliquez une transformation **Reduce** lorsque vous souhaitez réduire vos résultats à une seule valeur. Reduce supprime essentiellement la composante temporelle. S'il est visualisé sous forme de tableau, il réduit une colonne à une ligne (valeur). 

 Dans le champ **Calculs**, entrez un ou plusieurs types de calcul. Choisissez pour afficher la liste des choix de calcul. Pour plus d'informations sur les calculs disponibles, consultez[Liste des calculs](list-of-calculations.md).

Après avoir sélectionné au moins un calcul, Amazon Managed Grafana affiche une valeur utilisant le calcul que vous avez sélectionné. Si vous sélectionnez plusieurs calculs, plusieurs valeurs sont affichées. 

### Fusionner
<a name="merge"></a>

 Utilisez cette transformation pour combiner les résultats de plusieurs requêtes en un seul résultat. Cela est utile lorsque vous utilisez la visualisation du panneau de tableau. Les valeurs pouvant être fusionnées sont combinées dans la même ligne. Les valeurs peuvent être fusionnées si les champs partagés contiennent les mêmes données. 

 Dans l'exemple suivant, deux requêtes renvoient des données de table. Les données sont visualisées sous forme de deux tableaux distincts avant d'appliquer la transformation. 

Requête A


|  Heure  |  Tâche  |  Disponibilité  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  nœud  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  123001233  | 

Requête B


|  Heure  |  Tâche  |  Erreurs  | 
| --- | --- | --- | 
|  2020-07-07 11:34:20  |  nœud  |  15  | 
|  2020-07-07 11:24:20  |  postgre  |  5  | 

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


|  Heure  |  Tâche  |  Erreurs  |  Disponibilité  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  nœud  |  15  |  25260122  | 
|  2020-07-07 11:24:20  |  postgre  |  5  |  123001233  | 

### Filtrage par nom
<a name="filter-by-name"></a>

 Utilisez cette transformation pour supprimer des parties des résultats de la requête. 

 Amazon Managed Grafana affiche le champ **Identifiant**, suivi des champs renvoyés par votre requête. 

 Vous pouvez appliquer des filtres de deux manières : 
+  Entrez une expression regex. 
+  Choisissez un champ pour activer le filtrage sur ce champ. Les champs filtrés sont affichés en gris foncé, les champs non filtrés en blanc. 

### Filtrer les données par requête
<a name="filter-data-by-query"></a>

 Utilisez cette transformation dans les panneaux contenant plusieurs requêtes, si vous souhaitez masquer une ou plusieurs requêtes. 

 Amazon Managed Grafana affiche les lettres d'identification de la requête en texte gris foncé. Pour activer le filtrage, choisissez un identifiant de requête. 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. 

### Organiser les champs
<a name="organize-fields"></a>

 Utilisez cette transformation pour renommer, réorganiser ou masquer les champs renvoyés par la requête. 

**Note**  
 Cette transformation ne fonctionne que dans les panneaux contenant une seule requête. Si votre panneau comporte plusieurs requêtes, vous devez soit appliquer une transformation **Joindre par champ (jointure externe)**, soit supprimer les requêtes supplémentaires. 

 Amazon Managed Grafana affiche la liste des champs renvoyés par la requête. Vous pouvez apporter l'une des modifications suivantes : 
+  Modifiez l'ordre des champs en faisant une pause sur un champ. Le curseur prend la forme d'une main, puis vous pouvez faire glisser le champ vers son nouvel emplacement. 
+  Masquez ou affichez un champ en cliquant sur l'icône en forme d'œil à côté du nom du champ. 
+  Renommez les champs en saisissant un nouveau nom dans la zone **Renommer**. 

### Joindre par champ (jointure externe)
<a name="join-by-field-outer-join"></a>

 Utilisez cette transformation pour joindre plusieurs séries chronologiques à partir d'un ensemble de résultats par champ. 

 Cette transformation est utile si vous souhaitez combiner des requêtes afin de calculer les résultats à partir des champs. 

### Ajouter un champ à partir du calcul
<a name="add-field-from-calculation"></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. 
  +  **Option binaire** — Appliquez une opération mathématique de base (`sum``multiply`,, etc.) aux valeurs d'une seule ligne provenant de deux champs sélectionnés. 
+  **Nom du champ** : sélectionnez les noms des champs que vous souhaitez utiliser dans le calcul du nouveau champ. 
+  **Calcul :** sélectionnez un calcul à utiliser lorsqu'Amazon Managed Grafana crée le nouveau champ. Choisissez le champ pour voir la liste des choix de calcul. Pour plus d'informations sur les calculs disponibles, consultez[Liste des calculs](list-of-calculations.md). 
+  **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) Utilisez cette option si vous souhaitez masquer tous les autres champs et afficher uniquement votre champ calculé dans la visualisation. 

### Étiquettes pour les champs
<a name="labels-to-fields"></a>

**Note**  
 Pour appliquer cette transformation, votre requête doit renvoyer des champs étiquetés. 

 Lorsque vous sélectionnez cette transformation, Amazon Managed Grafana transforme automatiquement toutes les données étiquetées en champs. 

 Par exemple, considérez le résultat d'une requête de deux séries chronologiques. 

 1 : étiquettes Serveur = serveur A, centre de données = UE 2 : étiquettes Serveur = serveur B, centre de données = UE 

 Cette transformation se traduirait par le tableau suivant. 


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

 **Nom du champ de valeur** ; Si vous l'avez sélectionné `Server` comme **nom de champ de valeur**, vous obtiendrez un champ pour chaque valeur de l'`Server`étiquette. 


|  Heure  |  Centre de données  |  Serveur A  |  Serveur B  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  UE  |  1  |  2  | 

### Grouper par
<a name="sort-by"></a>

Cette transformation trie chaque image en fonction du champ configuré. Lorsque cette case `reverse` est cochée, les valeurs sont renvoyées dans l'ordre inverse.

### Grouper par
<a name="group-by"></a>

 Cette transformation regroupe les données selon une valeur de champ (colonne) spécifiée et traite les calculs pour chaque groupe. Les calculs disponibles sont les mêmes que pour la transformation Reduce. 

 Voici un exemple de données d'origine. 


|  Heure  |  ID serveur  |  Température du processeur  |  État du serveur  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  serveur 1  |  80  |  Fermeture  | 
|  2020-07-07 11:34:20  |  serveur 3  |  62  |  OK  | 
|  2020-07-07 10:32:20  |  serveur 2  |  90  |  Surcharge  | 
|  2020-07-07 10:31:22  |  serveur 3  |  55  |  OK  | 
|  2020-07-07 09:30:57  |  serveur 3  |  62  |  Rebooting  | 
|  2020-07-07 09:30:05  |  serveur 2  |  88  |  OK  | 
|  2020-07-07 09:28:06  |  serveur 1  |  80  |  OK  | 
|  2020-07-07 09:25:05  |  serveur 2  |  88  |  OK  | 
|  2020-07-07 09:23: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 vous **regroupez par** `Server ID` champ, les données seront regroupées de la façon suivante : 


|  Heure  |  ID serveur  |  Température du processeur  |  État du serveur  | 
| --- | --- | --- | --- | 
|  2020-07-07 11:34:20  |  serveur 1  |  80  |  Fermeture  | 
|  2020-07-07 09:28:06  |  serveur 1  |  80  |  OK  | 
|  2020-07-07 09:23:07  |  serveur 1  |  86  |  OK  | 

```
2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting
```

Toutes les lignes ayant la même valeur de `Server ID` 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 le calcul sera appliqué à chaque groupe de lignes. Par exemple, vous souhaiterez peut-être calculer la moyenne `CPU temperature` pour chacun de ces serveurs. Vous pouvez ajouter le calcul de la *moyenne* appliqué au `CPU Temperature` champ pour obtenir ce qui suit.


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

Et vous pouvez ajouter plusieurs de ces calculs. Par exemple, vous pouvez utiliser les calculs suivants. 
+  Pour le champ`Time`, vous pouvez calculer la *dernière* valeur, pour savoir quand le dernier point de données a été reçu pour chaque serveur. 
+  Pour le champ`Server Status`, vous pouvez calculer la *dernière* valeur pour connaître la dernière valeur d'état de chaque serveur. 
+  Sur le terrain`Temperature`, vous pouvez également calculer la *dernière* valeur pour connaître la dernière température surveillée pour chaque serveur. 

 La transformation Group By produit les résultats suivants. 


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

Grâce à cette transformation, vous pouvez extraire certaines informations clés de vos séries chronologiques et les afficher de manière pratique. 

### De la série aux rangées
<a name="series-to-rows"></a>

Utilisez cette transformation pour combiner les résultats 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 : `Time``Metric`, et`Value`. La `Metric` colonne est ajoutée afin que vous puissiez voir de quelle requête provient la métrique. Personnalisez cette valeur en `Label` la définissant 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 que la transformation ne soit appliquée. 

 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  | 

 L'application de `Series to rows` la transformation produit les résultats suivants. 


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

### Filtrer les données par valeur
<a name="filter-data-by-value"></a>

Cette transformation vous permet de filtrer vos données directement dans l'espace de travail Grafana et de supprimer certains points de données du résultat de votre requête. Vous avez la possibilité d'inclure ou d'exclure les données qui répondent à une ou plusieurs conditions que vous définissez. Les conditions sont appliquées à un champ sélectionné.

Cette transformation est 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 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 à la valeur spécifiée. 
+  **Inférieur ou égal** — Correspond si la valeur est inférieure ou égale à la valeur spécifiée. 
+  **Plage** : correspond à une plage comprise entre un minimum et un maximum spécifiés. Le minimum et le maximum sont inclus dans la gamme.

Vous pouvez ajouter plusieurs conditions au filtre. Lorsque vous avez plusieurs conditions, vous pouvez choisir si vous souhaitez que l'action d'inclusion ou d'exclusion soit appliquée aux lignes qui correspondent à toutes les conditions que vous avez ajoutées ou à certaines d'entre elles.

Les conditions qui ne sont pas valides ou qui ne sont pas complètement configurées sont ignorées.

### Transformations de débogage
<a name="debug-transformations"></a>

Pour voir les ensembles de résultats d'entrée et de sortie de la transformation, cliquez sur l'icône de bogue sur le côté droit de la ligne de transformation. 

 Amazon Managed Grafana affiche la vue de débogage de la transformation sous la ligne de transformation. 

# Options de champ et remplacements
<a name="field-options-overrides"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Cette section explique quelles sont les options de champ et les remplacements de champs dans Amazon Managed Grafana et comment les utiliser. 

 Le modèle de données utilisé dans les espaces de travail Grafana, le bloc de données, 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 Amazon Managed Grafana affiche les données. 

## Options de champ
<a name="field-options-overview"></a>

 Les *options de champ*, standard et personnalisées, se trouvent dans l'onglet **Champ** de l'éditeur de panneaux. Les modifications apportées dans cet onglet s'appliquent à tous les champs (c'est-à-dire aux séries et aux colonnes). Par exemple, si vous remplacez l'unité par un pourcentage, tous les champs contenant des valeurs numériques sont affichés en pourcentages. Découvrez comment appliquer une option de champ dans[Configurer tous les champs](#configure-all-fields). 

## Dérogations de champs
<a name="field-overrides-overview"></a>

 Les *remplacements de champs* peuvent être ajoutés dans l'onglet **Remplacements** de l'éditeur de panneaux. Vous pouvez y ajouter les mêmes options que celles que vous trouvez **dans l'onglet Champ**, mais elles ne s'appliquent qu'à des champs spécifiques. Découvrez comment appliquer une dérogation dans. [Configurer des champs spécifiques](#configure-specific-fields)

## Options de champs disponibles et remplacements
<a name="available-field-options-and-overrides"></a>

 Les types d'options de champ sont communs aux options de champ et aux remplacements de champs. La seule différence est de savoir si la modification s'appliquera à tous les champs (appliquée **dans l'onglet Champ**) ou à un sous-ensemble de champs (appliquée dans l'onglet **Remplacements**). 
+  [Options de champ standard](#standard-field-options)s'appliquent à toutes les visualisations de panneaux qui autorisent les transformations. 
+  [Options des champs du tableau](table-panel.md#table-field-options)s'appliquent uniquement aux visualisations de panneaux de table. 

### Configurer tous les champs
<a name="configure-all-fields"></a>

 Pour modifier la façon dont tous les champs affichent les données, vous pouvez modifier une option **dans l'onglet Champ**. Dans l'onglet **Remplacements**, vous pouvez ensuite remplacer les options de champ pour des champs spécifiques. Pour de plus amples informations, veuillez consulter [Configurer des champs spécifiques](#configure-specific-fields). 

 Par exemple, vous pouvez modifier le nombre de décimales affichées dans tous les champs en modifiant l'option **Décimales**. Pour plus d'informations sur les options, reportez-vous [Options de champ standard](#standard-field-options) aux sections et[Options des champs du tableau](table-panel.md#table-field-options). 

#### Modifier une option de champ
<a name="change-a-field-option"></a>

 Vous pouvez modifier autant d'options que vous le souhaitez. 

**Pour modifier une option de champ**

1.  Choisissez le panneau que vous souhaitez modifier, choisissez le titre du panneau, puis choisissez **Modifier**. 

1.  Choisissez l'onglet **Champ**. 

1.  Trouvez l'option que vous souhaitez modifier. Vous pouvez définir les éléments suivants : 
   +  [Options de champ standard](#standard-field-options), qui s'appliquent à toutes les visualisations de panneaux autorisant les transformations. 
   +  [Options des champs du tableau](table-panel.md#table-field-options), qui s'appliquent uniquement aux visualisations de panneaux de tableau. 

1.  Ajoutez des 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.  Lorsque vous avez terminé de modifier le tableau de bord, choisissez **Enregistrer**. 

#### Exemple d'option de champ
<a name="field-option-example"></a>

 Supposons que le jeu de résultats soit un bloc de données composé de deux champs : heure et température. 


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

 Des options de champ peuvent être appliquées à chaque champ (colonne) de cette structure de manière à modifier la façon dont ses valeurs sont affichées. Par exemple, vous pouvez 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  | 

 La virgule ne signifie rien dans ce cas. Vous pouvez remplacer les décimales par `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  | 

### Configurer des champs spécifiques
<a name="configure-specific-fields"></a>

 Vous pouvez utiliser des remplacements pour modifier les paramètres d'un ou de plusieurs champs. Les options de champ pour les remplacements sont exactement les mêmes que les options de champ disponibles dans une visualisation donnée. La seule différence est que vous choisissez les champs auxquels les appliquer. 

 **Par exemple, vous pouvez modifier le nombre de décimales affichées dans tous les champs ou colonnes numériques en modifiant l'option **Décimales** pour les **champs dont le type correspond à** Numérique.** Pour plus d'informations sur les options[Options de champ standard](#standard-field-options), consultez les sections qui s'appliquent à toutes les visualisations de panneaux autorisant les transformations et [Options des champs du tableau](table-panel.md#table-field-options) celles qui s'appliquent uniquement aux visualisations de panneaux de tableau. 

#### Ajouter un remplacement de champ
<a name="add-a-field-override"></a>

 Vous pouvez remplacer autant d'options de champ que vous le souhaitez. 

**Pour ajouter un remplacement de champ**

1.  Choisissez le panneau que vous souhaitez modifier, choisissez le titre du panneau, puis choisissez **Modifier**. 

1.  Choisissez l'onglet **Overrides**. 

1.  Choisissez **Ajouter une dérogation pour**. 

1.  Sélectionnez les champs auxquels vous souhaitez appliquer une règle de dérogation. 
   +  **Champs avec nom** : utilisez cette option pour sélectionner 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 champ unique. 
   +  **Champs dont le nom correspond à une expression régulière** — Utilisez-le pour spécifier 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 les noms correspondent à l'expression régulière. 
   +  **Champs avec type** : utilisez cette option pour sélectionner des champs par type, tels que 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é. 

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 **Save (Sauvegarder)**. 

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

1.  Choisissez l'onglet Remises qui contient la dérogation que vous souhaitez supprimer. 

1.  Cliquez sur l'icône de la corbeille à côté de la dérogation. 

#### Exemple de remplacement de champ
<a name="field-override-example"></a>

Supposons que notre ensemble de résultats soit une trame de données composée de quatre champs : temps, haute température, basse température et humidité. 


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

 Appliquons les options du champ [Exemple d'option de champ](#field-option-example) pour appliquer l'unité Celsius et éliminer 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é n'a aucun sens. Vous pouvez 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). Il en résulte un tableau beaucoup plus logique. 


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

### Options de champ standard
<a name="standard-field-options"></a>

 Cette section explique les options de champ disponibles. Ils sont classés par ordre alphabétique. 

 Vous pouvez appliquer des options de champ standard à la plupart des panneaux d'espace de travail 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'affecteront pas la visualisation tant que vous n'aurez pas sélectionné d'options de champ en dehors de la zone d'options de champ que vous modifiez ou que vous n'avez pas appuyé sur Entrée. 

 Pour plus d'informations sur l'application de ces options, consultez les sections suivantes : 
+  [Configurer tous les champs](#configure-all-fields) 
+  [Configurer des champs spécifiques](#configure-specific-fields) 

#### Décimales
<a name="decimals"></a>

 Cette option définit le nombre de décimales à inclure lors du rendu d'une valeur. Laissez ce champ vide pour qu'Amazon Managed Grafana utilise le nombre de décimales fourni par la source de données. 

 Pour modifier ce paramètre, entrez un chiffre dans le champ. 

#### Liaisons de données
<a name="data-links-overview"></a>

 Cette option contrôle l'URL vers laquelle une valeur ou une visualisation est liée. Pour en savoir plus et des instructions, consultez [Liaisons de données](data-links.md). 

#### Nom d’affichage
<a name="display-name"></a>

 Cette option définit le titre d'affichage de tous les champs. Vous pouvez utiliser des variables dans le titre du champ. Pour plus d'informations sur les modèles et les variables de modèles, consultez[Modèles et variables](templates-and-variables.md). 

 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 n'`${__field.name}`utiliser que le nom de la série ou le nom du champ dans le titre. 

 Étant donné un champ nommé Temp et les libellés \$1"loc"="Pbi », « Sensor"="3"\$1 


|  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. Si la réponse ne contient qu'une seule clé d'étiquette, Amazon Managed 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. 

#### Max
<a name="max"></a>

 Cette option définit la valeur maximale utilisée dans le calcul du seuil de pourcentage. Pour un calcul automatique basé sur toutes les séries et tous les champs, laissez ce paramètre vide. 

#### Min
<a name="min"></a>

 Cette option définit la valeur minimale utilisée dans le calcul du seuil de pourcentage. Pour un calcul automatique basé sur toutes les séries et tous les champs, laissez ce paramètre vide. 

#### Aucune valeur
<a name="no-value"></a>

 Entrez ce que Amazon Managed Grafana doit afficher si la valeur du champ est vide ou nulle. 

#### Unit
<a name="unit"></a>

 Cette option indique 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="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. date/time 

 Pour sélectionner une unité personnalisée, saisissez-la et sélectionnez la dernière `Custom: xxx` option dans la liste déroulante. 
+  `suffix:<suffix>`pour une unité personnalisée qui doit suivre la valeur. 
+  `time:<format>`pour les date/time formats personnalisés ; par exemple,`time:YYYY-MM-DD`. Pour la syntaxe et les options du format, voir [Affichage](https://momentjs.com/docs/#/displaying/). 
+  `si:<base scale><unit characters>`pour les unités SI personnalisées ; par exemple,`si: mF`. Cette option est un peu plus avancée car vous pouvez spécifier à la fois une unité et l'échelle des données source. Par exemple, si vos données source sont représentées sous forme de milli (milliers d'unités), préfixez l'unité avec ce caractère d'échelle SI. 
+  `count:<unit>`pour une unité de comptage personnalisée. 
+  `currency:<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="string-units"></a>

 Amazon Managed Grafana peut parfois analyser des chaînes et les afficher sous forme de nombres. Pour qu'Amazon Managed Grafana affiche la chaîne d'origine, créez un champ de remplacement et ajoutez une propriété d'unité à l'unité. `string` 

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

 L'option de couleur des champs définit la façon dont Amazon Managed Grafana colore les séries ou les champs. Il existe ici plusieurs modes qui fonctionnent différemment, et leur utilité dépend largement de la visualisation actuellement sélectionnée. 

 Les modes couleur continus utilisent le pourcentage d'une valeur par rapport aux valeurs min et max pour interpoler une couleur. 
+  **Couleur unique** : ensemble de couleurs spécifique à l'aide du sélecteur de couleurs. Cela est particulièrement utile lorsqu'il s'agit d'une règle de dérogation. 
+  **À partir des seuils** : couleur dérivée du seuil correspondant. Cela est utile pour les visualisations de jauges, de statistiques et de tables. 

##### Couleur par série
<a name="color-by-series"></a>

 Amazon Managed Grafana inclut des combinaisons de couleurs qui définissent les couleurs par série. Cela est utile pour les graphiques et les diagrammes à secteurs, par exemple. 

##### Couleur par valeur
<a name="color-by-value"></a>

 Amazon Managed Grafana inclut également des combinaisons de couleurs continues (dégradées). Cela est utile pour les visualisations qui colorent des valeurs individuelles, par exemple les panneaux de statistiques et le panneau de tableau. 

#### Seuils
<a name="thresholds-overview"></a>

 Vous pouvez utiliser des seuils pour modifier la couleur d'un champ en fonction de la valeur. Pour en savoir plus et des instructions, consultez [Seuils](thresholds.md). 

#### Cartographie des valeurs
<a name="value-mapping"></a>

 Vous pouvez utiliser cette option pour définir des règles qui traduisent une valeur de champ ou une plage de valeurs en texte explicite. Vous pouvez ajouter plusieurs mappages de valeurs. 
+  **Type de mappage** : choisissez une option. 
  +  **Valeur** — Entrez une valeur. Si la valeur du champ est supérieure ou égale à la valeur, le **texte** s'affiche. 
  +  **De** et **vers** : entrez une plage. Si la valeur du champ est comprise ou égale aux valeurs de la plage, le **texte** s'affiche. 
+  **Texte** : texte affiché si les conditions sont remplies dans un champ. Ce champ accepte les variables. 

# Éditeur de panneaux
<a name="AMG-panel-editor"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Cette rubrique décrit les différentes parties de l'éditeur de panneaux Amazon Managed Grafana et inclut des liens vers des informations supplémentaires. 

## Ouverture de l'éditeur de panneaux
<a name="open-the-panel-editor"></a>

 Il existe plusieurs manières d'accéder à l'éditeur de panneau, également appelé écran du **panneau d'édition**, *mode d'édition* ou *mode d'édition du panneau*. 
+  Cliquez sur l'icône **Ajouter un panneau** en haut de l'écran, puis sélectionnez **Ajouter un nouveau panneau**. Le nouveau panneau s'ouvre dans l'éditeur de panneaux. Pour plus d'informations sur l'ajout d'un panneau, consultez[Ajouter un panneau](add-a-panel-to-a-dashboard.md). 
+  Choisissez le titre d'un panneau existant, puis choisissez **Modifier**. Le panneau s'ouvre en mode édition. 
+  Choisissez n'importe où sur un panneau existant, puis appuyez sur **e** sur votre clavier. Le panneau s'ouvre en mode édition. 

## Redimensionnement des sections de l'éditeur de panneaux
<a name="resize-panel-editor-sections"></a>

 Faites glisser le pointeur pour redimensionner les sections de l'éditeur de panneaux. Si le volet latéral devient trop étroit, les onglets **Panneau**, **Champ** et **Remplacements** deviennent une liste déroulante. 

## Éléments de l'éditeur de panneaux
<a name="parts-of-the-panel-editor"></a>

 Cette section décrit les parties de l'écran de l'éditeur de panneaux, avec des informations sur les champs, les options ou les tâches associées à chaque partie. 

### En-tête
<a name="header"></a>

 La section d'en-tête répertorie le nom du tableau de bord dans lequel se trouve le panneau et certaines commandes du tableau de bord. Vous pouvez également sélectionner la flèche **Retour en arrière** pour revenir au tableau de bord. 

 Sur le côté droit de l'en-tête se trouvent les options suivantes : 
+  **Icône des paramètres du tableau de bord (engrenage)** : choisissez d'accéder aux paramètres du tableau de bord. 
+  **Supprimer Choisissez** de supprimer toutes les modifications que vous avez apportées au panneau depuis le dernier enregistrement du tableau de bord. 
+  **Enregistrer** : choisissez d'enregistrer le tableau de bord, y compris toutes les modifications que vous avez apportées dans l'éditeur de panneaux. 
+  **Appliquer** : choisissez d'appliquer les modifications que vous avez apportées, puis fermez l'éditeur de panneaux pour revenir au tableau de bord. Enregistrez également le tableau de bord pour conserver les modifications appliquées. 

### Aperçu de la visualisation
<a name="visualization-preview"></a>

 La section d'aperçu de la visualisation contient les options d'affichage, les commandes de plage de temps, l'aperçu de la visualisation et (le cas échéant) le titre, les axes et la légende du panneau. 
+  **Remplissage** : l'aperçu de visualisation remplit l'espace disponible dans la partie d'aperçu. Si vous modifiez la largeur du panneau latéral ou la hauteur du panneau inférieur, la visualisation s'adapte pour remplir l'espace disponible. 
+  **Ajuster** — L'aperçu de la visualisation remplit l'espace disponible, mais il préserve le rapport hauteur/largeur du panneau. 
+  **Exact** — La taille de l'aperçu de la visualisation est identique à celle du tableau de bord. Si l'espace disponible est insuffisant, la visualisation est réduite afin de préserver le rapport hauteur/largeur. 
+  **Contrôles de plage de temps** — Pour plus d'informations, consultez[Contrôles de plage de temps](dashboard-time-range-controls.md).

### Section des données (volet inférieur)
<a name="data-section-bottom-pane"></a>

 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 [Requêtes](panel-queries.md). 
+  **Onglet Transformation** : appliquez des transformations de données. Pour de plus amples informations, veuillez consulter [Transformations](panel-transformations.md). 
+  **Onglet Alerte** : écrivez les règles d'alerte. Pour de plus amples informations, veuillez consulter [Alerte Grafana](alerts-overview.md). 

### Options du panneau et des champs (volet latéral)
<a name="panel-and-field-options-side-pane"></a>

 Cette section contient des onglets dans lesquels vous pouvez contrôler presque tous les aspects de la visualisation de vos données. Les onglets ne sont pas tous disponibles pour chaque visualisation. 

 Les fonctionnalités de ces onglets sont décrites dans les rubriques suivantes : 
+  [Ajouter un panneau](add-a-panel-to-a-dashboard.md) 
+  [Visualisations](AMG-visualizations.md) 
+  [Options de champ et remplacements](field-options-overrides.md) 
+  [Liens vers le panneau](panel-links.md)et [Liaisons de données](data-links.md) qui vous aident à connecter votre visualisation à d'autres ressources 

# Panneaux de bibliothèque
<a name="AMG-library-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Les panneaux de bibliothèque permettent aux utilisateurs de créer des panneaux réutilisables où les modifications apportées à une instance du panneau de bibliothèque sont reflétées sur chaque tableau de bord, affectant toutes les autres instances où le panneau est utilisé. Ces panneaux peuvent être enregistrés dans des dossiers à côté des tableaux de bord et rationaliser la réutilisation des panneaux sur plusieurs tableaux de bord. 

## Création d'un panneau de bibliothèque
<a name="library-panel-create"></a>

**Note**  
Lorsque vous créez des panneaux de bibliothèque, le panneau du tableau de bord source est également converti en panneau de bibliothèque. Vous devrez enregistrer le tableau de bord d'origine une fois le panneau converti.

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

1. Créez un panneau comme vous le feriez normalement. Vous pouvez également utiliser un panneau existant.

1. Choisissez le titre du panneau, puis sélectionnez **Modifier**.

1. Dans le volet latéral des options d'affichage du panneau, choisissez l'option flèche vers le bas pour apporter des modifications à la visualisation.

1. Choisissez **Panneaux de bibliothèque**, puis choisissez **Créer un nouveau panneau de bibliothèque**. 

1. Entrez un nom pour le panneau de bibliothèque, puis sélectionnez le dossier dans lequel l'enregistrer.

1. Choisissez **Créer un panneau de bibliothèque**, puis enregistrez le tableau de bord.

Vous pouvez également créer des panneaux de bibliothèque en utilisant l'option **Partager** pour n'importe quel panneau.

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

## Ajouter un panneau de bibliothèque
<a name="library-panel-add"></a>

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

1. Appuyez sur l'option \$1 dans le menu de gauche, puis choisissez **Créer**.

1. Choisissez **Ajouter un panneau dans la bibliothèque de panneaux**.

1. Filtrez la liste des panneaux de bibliothèque pour trouver le panneau de votre choix.

1. Choisissez ce panneau et ajoutez-le au tableau de bord. 

## Dissocier un panneau de bibliothèque
<a name="library-panel-unlink"></a>

Si vous avez un panneau de bibliothèque sur votre tableau de bord que vous souhaitez modifier sans affecter toutes les autres instances du panneau de bibliothèque, vous pouvez dissocier le panneau de bibliothèque.

**Pour dissocier un panneau de bibliothèque d'un tableau de bord**

1. Faites une pause sur **Tableau de bord** dans le menu de gauche, puis choisissez **Panneaux de bibliothèque**.

1. Sélectionnez un panneau de bibliothèque. Vous verrez une liste de tous les tableaux de bord dans lesquels le panneau de bibliothèque est utilisé.

1. Sélectionnez le panneau que vous souhaitez dissocier et mettre à jour.

1. Choisissez le titre du panneau, puis sélectionnez **Modifier**. 

1. Choisissez **Dissocier.** 

## Supprimer un panneau de bibliothèque
<a name="library-panel-delete"></a>

Avant de supprimer un panneau de bibliothèque, vérifiez qu'il n'est plus utilisé sur aucun tableau de bord.

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

1. Faites une pause sur **Tableau de bord** dans le menu de gauche, puis choisissez **Panneaux de bibliothèque**.

1. Sélectionnez un panneau de bibliothèque. Vous verrez une liste de tous les tableaux de bord dans lesquels le panneau de bibliothèque est utilisé.

1. Sélectionnez le panneau que vous souhaitez supprimer.

1. Cliquez sur l'icône de suppression à côté du nom du panneau. 

## Éléments de l'éditeur de panneaux
<a name="parts-of-the-panel-editor"></a>

 Cette section décrit les parties de l'écran de l'éditeur de panneaux, avec des informations sur les champs, les options ou les tâches associées à chaque partie. 

### En-tête
<a name="header"></a>

 La section d'en-tête répertorie le nom du tableau de bord dans lequel se trouve le panneau et certaines commandes du tableau de bord. Vous pouvez également sélectionner la flèche **Retour en arrière** pour revenir au tableau de bord. 

 Sur le côté droit de l'en-tête se trouvent les options suivantes : 
+  **Icône des paramètres du tableau de bord (engrenage)** : choisissez d'accéder aux paramètres du tableau de bord. 
+  **Supprimer Choisissez** de supprimer toutes les modifications que vous avez apportées au panneau depuis le dernier enregistrement du tableau de bord. 
+  **Enregistrer** : choisissez d'enregistrer le tableau de bord, y compris toutes les modifications que vous avez apportées dans l'éditeur de panneaux. 
+  **Appliquer** : choisissez d'appliquer les modifications que vous avez apportées, puis fermez l'éditeur de panneaux pour revenir au tableau de bord. Enregistrez également le tableau de bord pour conserver les modifications appliquées. 

### Aperçu de la visualisation
<a name="visualization-preview"></a>

 La section d'aperçu de la visualisation contient les options d'affichage, les commandes de plage de temps, l'aperçu de la visualisation et (le cas échéant) le titre, les axes et la légende du panneau. 
+  **Remplissage** : l'aperçu de visualisation remplit l'espace disponible dans la partie d'aperçu. Si vous modifiez la largeur du panneau latéral ou la hauteur du panneau inférieur, la visualisation s'adapte pour remplir l'espace disponible. 
+  **Ajuster** — L'aperçu de la visualisation remplit l'espace disponible, mais il préserve le rapport hauteur/largeur du panneau. 
+  **Exact** — La taille de l'aperçu de la visualisation est identique à celle du tableau de bord. Si l'espace disponible est insuffisant, la visualisation est réduite afin de préserver le rapport hauteur/largeur. 
+  **Contrôles de plage de temps** — Pour plus d'informations, consultez[Contrôles de plage de temps](dashboard-time-range-controls.md).

### Section des données (volet inférieur)
<a name="data-section-bottom-pane"></a>

 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 [Requêtes](panel-queries.md). 
+  **Onglet Transformation** : appliquez des transformations de données. Pour de plus amples informations, veuillez consulter [Transformations](panel-transformations.md). 
+  **Onglet Alerte** : écrivez les règles d'alerte. Pour de plus amples informations, veuillez consulter [Alerte Grafana](alerts-overview.md). 

### Options du panneau et des champs (volet latéral)
<a name="panel-and-field-options-side-pane"></a>

 Cette section contient des onglets dans lesquels vous pouvez contrôler presque tous les aspects de la visualisation de vos données. Les onglets ne sont pas tous disponibles pour chaque visualisation. 

 Les fonctionnalités de ces onglets sont décrites dans les rubriques suivantes : 
+  [Ajouter un panneau](add-a-panel-to-a-dashboard.md) 
+  [Visualisations](AMG-visualizations.md) 
+  [Options de champ et remplacements](field-options-overrides.md) 
+  [Liens vers le panneau](panel-links.md)et [Liaisons de données](data-links.md) qui vous aident à connecter votre visualisation à d'autres ressources 

# Visualisations
<a name="AMG-visualizations"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Amazon Managed Grafana propose une variété de visualisations adaptées à différents cas d'utilisation. Les sections suivantes répertorient les visualisations disponibles dans Amazon Managed Grafana et leurs paramètres d'affichage.

**Topics**
+ [Panneau de liste d'alertes](alert-list-panel.md)
+ [Panneau de graphique à barres](bar-chart-panel.md)
+ [Panneau de jauge à barres](alert-panel-bar-gauge-panel.md)
+ [Panneau d'horloge](clock-panel.md)
+ [Panneau de liste du tableau de bord](dashboard-list-panel.md)
+ [Panneau de jauge](gauge-panel.md)
+ [Panneau Geomap](AMG-Geomap.md)
+ [Panneau graphique](graph-panel.md)
+ [Heatmap](visualization-heatmap.md)
+ [Panneau d'histogramme](histogram-panel.md)
+ [Panneau Logs](logs-panel.md)
+ [Panneau d'actualités](news-panel.md)
+ [Panneau de graphes de nœuds (version bêta)](node-graph-panel.md)
+ [Panneau de diagramme à secteurs](pie-chart-panel.md)
+ [Panneau Plotly](plotly-panel.md)
+ [Panneau Sankey](sankey-panel.md)
+ [Panneau Scatter](scatter-panel.md)
+ [Panneau de démarrage](stat-panel.md)
+ [Panneau chronologique de l'État](state-timeline-panel.md)
+ [Panneau d'historique des statuts](status-history-panel.md)
+ [Panneau de table](table-panel.md)
+ [Panneau de texte](text-panel.md)
+ [Panneau des séries chronologiques](time-series-panel.md)
+ [Seuils](thresholds.md)
+ [WindRose](windrose.md)
+ [Inspecter un panneau](inspect-a-panel.md)
+ [Liste des calculs](list-of-calculations.md)

# Panneau de liste d'alertes
<a name="alert-list-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau de liste d'alertes affiche les alertes de votre tableau de bord. Vous pouvez configurer la liste pour afficher l'état actuel ou les changements d'état récents. Pour plus d'informations sur les alertes, consultez[Alerte Grafana](alerts-overview.md).

Utilisez ces paramètres pour affiner votre visualisation.

## Options
<a name="alert-list-panel-options"></a>
+  **Afficher** — Choisissez si le panneau doit afficher l'état d'alerte actuel ou les modifications récentes de l'état d'alerte.
+  **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 :
    + alerte : 1
    + aucune donnée : 2
    + en attente : 3
    + ok : 4
    + en pause : 5
+  **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="alerts-panel-filter"></a>

Utilisez les options suivantes pour filtrer les alertes en fonction de la requête, du dossier ou des balises que vous choisissez :
+  **Nom de l'alerte** : entrez une requête portant le nom de l'alerte. 
+  **Titre du tableau de bord** — Entrez une requête relative au titre du tableau de bord.
+  **Dossier** : sélectionnez un dossier. Seules les alertes provenant des tableaux de bord du dossier sélectionné seront affichées.
+  **Balises du tableau de bord :** sélectionnez une ou plusieurs balises. Seules les alertes provenant de tableaux de bord comportant une ou plusieurs balises seront affichées. 

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

Choisissez les états d'alerte à afficher dans ce panneau.
+ Ok
+ En pause
+ Aucune donnée
+ Erreur d'exécution
+ Alerte
+ En attente

# Panneau de graphique à barres
<a name="bar-chart-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Cette visualisation par panneau vous permet de représenter graphiquement des données catégorielles.

## Formats de données pris en charge
<a name="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="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="bar-chart-options"></a>

Utilisez les options suivantes pour affiner vos visualisations :

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

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

La **largeur des groupes** contrôle la largeur des groupes. 0 = largeur minimale et 1 = largeur maximale.

La **largeur des barres** contrôle la largeur des barres. 0 = min et 1 = largeur maximale.

**La largeur** de ligne contrôle la largeur de ligne des barres.

**L'opacité de remplissage** contrôle l'opacité de remplissage des barres.

**Le 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**  
Utilisez un override pour masquer des séries individuelles dans l'infobulle.

**Mode légende** : utilisez ces paramètres pour affiner 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.

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

**Calculs de légende** : choisissez les calculs standard à afficher dans la légende. Tu peux en avoir plusieurs.

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

**Axe** : 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.
+  **É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.
+  **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 graphiques, 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 et 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.

# Panneau de jauge à barres
<a name="alert-panel-bar-gauge-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

La jauge à barres simplifie vos données en réduisant chaque champ à une seule valeur. Vous choisissez la manière dont Amazon Managed 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.

## Options de données et de champs
<a name="bar-gauge-data-and-field-options"></a>

Avec les visualisations à jauge à barres, vous pouvez appliquer les options suivantes :
+  [Transformations](panel-transformations.md) 
+  [Options de champ et remplacements](field-options-overrides.md) 
+  [Seuils](thresholds.md) 

## Options d'affichage
<a name="bar-gauge-display-options"></a>

Utilisez les options suivantes pour affiner votre visualisation :
+  **Afficher** — Choisissez la manière dont Amazon Managed Grafana affiche vos données.
  +  **Calculer** : affiche une valeur calculée en fonction de toutes les lignes. Pour obtenir la liste des calculs disponibles, consultez[Liste des calculs](list-of-calculations.md).
  +  **Toutes les valeurs** : affiche une statistique distincte pour chaque ligne. Si vous sélectionnez cette option, vous pouvez également sélectionner une **limite**, c'est-à-dire le nombre maximum de lignes à afficher.
+  **Valeur** : sélectionnez une fonction de réduction qu'Amazon Managed Grafana utilisera pour réduire de nombreux champs à une seule valeur. Choisissez la liste des **valeurs** pour voir les fonctions et de brèves descriptions. 
+  **Orientation** — Choisissez une direction d'empilement.
  +  **Automatique** : Amazon Managed Grafana sélectionne l'orientation qui lui semble la mieux adaptée.
  +  **Horizontal** — Les barres s'étirent horizontalement, de gauche à droite.
  +  **Vertical** — Les barres s'étirent verticalement de haut en bas.
+  **Mode d'affichage** — Choisissez un mode d'affichage.
  +  **Dégradé** : choisissez un niveau de seuil pour définir un dégradé.
  +  **LCD rétro** — Affichez la jauge divisée en petites cellules allumées ou éteintes.
  +  **Basique** : utilisez une seule couleur en fonction du seuil correspondant.
+  **Afficher la zone vide** : sélectionnez cette option si vous souhaitez rendre la zone vide des barres en gris foncé. Cette option n'est pas disponible pour le mode d'affichage LCD rétro.

# Panneau d'horloge
<a name="clock-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau de l'horloge indique l'heure actuelle ou un compte à rebours. Il est mis à jour chaque seconde.
+ **Mode** — La valeur par défaut est l'**heure**. Si vous choisissez le **compte à rebours**, définissez la **date limite du compte à rebours** pour démarrer le compte à rebours.
+ **12 ou 24 heures** — Les options d'affichage de l'heure sont le format 12 heures et le format 24 heures.
+ **Fuseau horaire** — Les fuseaux horaires sont fournis par la bibliothèque de fuseaux horaires du moment. Le fuseau horaire par défaut est celui de votre ordinateur.
+ **Date limite du compte à rebours** — Spécifiez l'heure et la date du compte à rebours, si vous avez réglé le **mode sur le** **compte à rebours**.
+ **Texte de fin du compte à rebours** : spécifiez le texte à afficher à la fin du compte à rebours.
+ **Options de formatage de la date et de l'heure** : personnalisez la taille, le poids et date/time le formatage de la police. Si vous affichez un compte à rebours et que vous ne voulez pas voir les secondes s'écouler, modifiez le format de l'heure `hh:mm` pour une horloge de 24 heures ou `h:mm A` une horloge de 12 heures. Pour une liste complète des options, voir [Affichage](https://momentjs.com/docs/#/displaying/).
+ **Bg Color** — Sélectionnez une couleur d'arrière-plan pour l'horloge.

# Panneau de liste du tableau de bord
<a name="dashboard-list-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau de liste des tableaux de bord affiche 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
<a name="options-1"></a>

Utilisez les options suivantes pour affiner votre visualisation :
+  **En vedette** : affiche les tableaux de bord marqués d'un astérisque 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. Cette option nécessite que vous saisissiez au moins une valeur dans **Requête** ou **Tags**.
+  **Afficher les en-têtes** : affiche la sélection de liste choisie (favoris, récemment consultée, recherche) sous forme de titre.
+  **Nombre maximum d'éléments** : définissez le nombre maximum d'éléments à répertorier par section. Par exemple, à la valeur par défaut de 10, si vous choisissez d'afficher les tableaux de bord marqués d'un astérisque et ceux récemment consultés, le panneau affiche jusqu'à 20 tableaux de bord au total, 10 dans chaque section.

### Recherche
<a name="panel-dashboard-list-search"></a>

Les options suivantes s'appliquent uniquement si l'option **Rechercher** est sélectionnée.
+  **Requête** — Entrez la requête que vous souhaitez rechercher. Les requêtes ne font pas la distinction majuscules/minuscules et les valeurs partielles sont acceptées.
+  **Dossier** : sélectionnez les dossiers du tableau de bord que vous souhaitez afficher.
+  **Balises** — Entrez les balises que vous souhaitez rechercher. Notez que les balises existantes n'apparaîtront pas au fur et à mesure que vous tapez et que les balises *distinguent 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.

# Panneau de jauge
<a name="gauge-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 La **jauge** est un panneau à valeur unique qui peut répéter une jauge pour chaque série, colonne ou ligne.

## Options de données et de champs
<a name="gauge-panel-data-and-field-options"></a>

Les visualisations de jauge vous permettent d'appliquer les options suivantes :
+  [Transformations](panel-transformations.md) 
+  [Options de champ et remplacements](field-options-overrides.md) 
+  [Seuils](thresholds.md) 

## Options d'affichage
<a name="gauge-panel-display-options-2"></a>

Pour affiner votre visualisation, utilisez les options suivantes :
+  **Afficher** — Choisissez la manière dont Amazon Managed Grafana affiche vos données.
  +  **Calculer** : affiche une **valeur** calculée en fonction de toutes les lignes. Pour obtenir la liste des calculs disponibles, consultez[Liste des calculs](list-of-calculations.md).
  +  **Toutes les valeurs** : affiche une statistique distincte pour chaque ligne. Si vous sélectionnez cette option, vous pouvez également sélectionner une **limite**, c'est-à-dire le nombre maximum de lignes à afficher.
+  **Orientation** — Choisissez une direction d'empilement.
  +  **Automatique** : Amazon Managed Grafana sélectionne l'orientation qu'il considère être la meilleure.
  +  **Horizontal** — Les barres s'étirent horizontalement, de gauche à droite.
  +  **Vertical** — Les barres s'étirent verticalement de haut en bas.
+  **Afficher les étiquettes de seuil** : choisissez d'afficher ou non les valeurs de seuil.
+  **Afficher les marqueurs de seuil** : choisissez si vous souhaitez afficher une bande de seuil en dehors de la bande de valeur de jauge intérieure.

# Panneau Geomap
<a name="AMG-Geomap"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

La visualisation du panneau **Geomap** vous permet de visualiser et de personnaliser la carte du monde à l'aide de données géospatiales. Pour vous concentrer facilement sur les caractéristiques géolocalisées importantes des données, vous pouvez configurer différents styles de superposition et paramètres de vue cartographique.

## Couche de données
<a name="Data-Layer"></a>

La couche de données du plug-in Geomap détermine la manière dont vous visualisez les données géospatiales au-dessus de la carte de base.

### Location
<a name="Location"></a>

Le panneau **Geomap** 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.
  + geohash : « géohash »
  + latitude : « latitude », « lat »
  + longitude : « longitude », « long », « long »
  + recherche : « recherche »
+  **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 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 un` gazetteer`. ` gazetteer `Il s'agit du répertoire utilisé pour mapper les données que vous avez demandées à un point géographique.

## Couche de marqueurs
<a name="Markers-Layer"></a>

La couche **Markers** 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.
+ **Marker Color** configure la couleur du marqueur. La taille fixe par défaut conserve la même couleur pour tous les points. Il existe une autre option permettant d'avoir plusieurs couleurs en fonction des valeurs des points de données et du seuil défini dans la section **Seuils**.
+  **La taille du marqueur** configure la taille du marqueur. Par défaut` Fixed size`, tous les marqueurs doivent avoir la même taille, quels que soient les points de données. Cependant, il existe également une option permettant de redimensionner les cercles en fonction des points de données correspondants. ` Min`et la taille du `Max ` marqueur doit être définie de telle sorte que la couche de marqueurs puisse être redimensionnée dans ces plages.
+  **Marker Shape** vous offre la flexibilité nécessaire pour visualiser les points de données différemment.
  + Circle
  + Square
  + Triangle
  + Croix
  + X
+  **L'opacité du remplissage** configure la transparence de chaque marqueur.

## couche Heatmap
<a name="Heatmap-layer"></a>

La couche **Heatmap** regroupe différents points de données pour visualiser des emplacements présentant différentes densités. Pour ajouter une couche de carte thermique, sous **Data Layer**, sélectionnez **Heatmap**.



Comme pour **les marqueurs**, différentes options vous sont proposées pour déterminer les points de données à visualiser et comment.
+ **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.

# Panneau graphique
<a name="graph-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Un panneau graphique peut être affiché sous la forme d'une ligne, d'un tracé de points ou d'une série de barres. Ce type de graphique est suffisamment polyvalent pour afficher presque toutes les séries chronologiques.

## Options de données et de champs
<a name="graph-panel-data-and-field-options"></a>

Lorsque vous utilisez des visualisations graphiques, vous pouvez appliquer les options suivantes :
+  [Transformations](panel-transformations.md) 
+ Alertes. Il s'agit du seul type de visualisation qui permet de définir des alertes. Pour de plus amples informations, veuillez consulter [Alerte Grafana](alerts-overview.md).
+  [Seuils](thresholds.md) 

## Options d'affichage
<a name="graph-panel-display-options"></a>

Pour affiner votre visualisation, utilisez les paramètres suivants :
+  **Barres** : affiche les valeurs sous forme de graphique à barres. 
+  **Lignes** : affiche les valeurs sous forme de graphique linéaire. 
+  **Largeur de ligne** — Spécifiez la largeur de la ligne pour une série. La valeur par défaut est 1.
+  **Escalier** — Dessine les points adjacents sous forme d'escalier.
+  **Remplissage de zone** — Spécifiez la quantité de couleur de remplissage pour une série. La valeur par défaut est 1 ; 0 est aucun.
+  **Dégradé de remplissage** : spécifiez le degré de dégradé du remplissage de la zone. La valeur par défaut est 0, qui n'est pas un gradient ; 10 est un gradient abrupt.
+  **Points** : affiche les points pour les valeurs. 
+  **Rayon des points** : contrôlez la taille des points.
+  **Seuils d'alerte** : affichez les seuils d'alerte et les régions sur le panneau.

### Empilage et valeur nulle
<a name="stacking-and-null-value"></a>
+  **Pile** — Chaque série est empilée les unes sur les autres.
+  **Pourcentage** — Chaque série est dessinée en pourcentage du total de toutes les séries. Cette option est disponible lorsque **Stack** est sélectionné.
+  **Valeur nulle** — Spécifiez le mode d'affichage des valeurs nulles. *Il s'agit d'un paramètre important.* Voir la note ci-dessous.
  +  **connecté** — S'il existe un écart dans la série, c'est-à-dire une ou plusieurs valeurs nulles, la ligne ignorera l'écart et se connectera à la valeur non nulle suivante. 
  +  **null** S'il y a un écart dans la série, c'est-à-dire une valeur nulle, la ligne du graphique sera brisée et indiquera l'écart. Il s’agit du paramètre par défaut.
  +  **null as zero** — S'il y a un écart dans la série, c'est-à-dire une valeur nulle, elle sera affichée sous la forme d'une valeur nulle dans le panneau graphique.

**Important**  
Si vous surveillez la charge du processeur d'un serveur et que la charge atteint 100 %, le serveur se bloquera et l'agent qui envoie les statistiques ne sera pas en mesure de collecter les statistiques de charge. Cela entraîne une lacune dans les statistiques, et l'utilisation du paramètre *nul* par défaut signifie qu'Amazon Managed Grafana affichera les lacunes et indiquera que quelque chose ne va pas. Si ce signal est réglé sur *Connected*, il sera facile de passer à côté de ce signal. 

### Survolez l'infobulle
<a name="graph-panel-hover-tooltip"></a>

Utilisez ces paramètres pour modifier l'apparence de l'infobulle qui apparaît lorsque vous vous arrêtez sur la visualisation du graphique.
+  **Mode** — Détermine le nombre de séries affichées par l'infobulle.
  +  **Toutes les séries** : l'infobulle affiche toutes les séries du graphique. Dans la liste des séries figurant dans l'infobulle, l'espace de travail Grafana met en évidence les séries sur lesquelles vous vous arrêtez en gras.
  +  **Unique** — L'infobulle ne montre qu'une seule série, celle sur laquelle vous faites une pause dans le graphique.
+  **Ordre de tri** : trie l'ordre des séries dans l'infobulle du pointeur si vous avez sélectionné le mode **Toutes les séries**. Lorsque vous faites une pause sur un graphique, Amazon Managed Grafana affiche les valeurs associées aux lignes. En général, les utilisateurs sont plus intéressés par les valeurs les plus élevées ou les plus faibles. Le tri de ces valeurs peut faciliter la recherche des données souhaitées.
  +  **Aucun** — L'ordre des séries dans l'infobulle est déterminé par l'ordre de tri de votre requête. Par exemple, vous pouvez trier les séries par ordre alphabétique par nom de série.
  +  **Croissance** : les séries affichées dans l'infobulle sont triées par valeur et par ordre croissant, la valeur la plus faible se trouvant en haut de la liste.
  +  **Décroissant** — Les séries affichées dans l'infobulle sont triées par valeur et par ordre décroissant, la valeur la plus élevée se trouvant en haut de la liste.

## Dérogations de séries
<a name="graph-panel-series-overrides"></a>

Les remplacements de séries permettent à une série d'un panneau graphique d'être rendue différemment des autres. Vous pouvez personnaliser les options d'affichage par série ou en utilisant des règles regex. Par exemple, une série peut avoir une largeur de ligne plus épaisse pour la faire ressortir ou être déplacée vers l'axe Y droit.

Vous pouvez ajouter plusieurs remplacements de séries.

**Pour ajouter une dérogation de série**

1. Choisissez **Ajouter un remplacement de série.**

1. Dans **Alias ou regex**, tapez ou sélectionnez une série. Choisissez le champ pour voir la liste des séries disponibles.

   Par exemple, `/Network.*/` correspondrait à deux séries nommées `Network out` et`Network in`.

1. Choisissez **\$1**, puis sélectionnez le style à appliquer à la série. Vous pouvez ajouter plusieurs styles à chaque entrée.
+  **Barres** : affiche les séries sous forme de graphique à barres. 
+  **Lignes** : affiche les séries sous forme de graphique linéaire. 
+  **Remplissage linéaire** : affiche un graphique linéaire avec remplissage de zones. 
+  **Dégradé de remplissage** — Spécifiez le degré de dégradé de remplissage de la zone.
+  **Largeur de ligne** — Définissez la largeur de ligne.
+  **Mode point nul** : utilisez cette option pour ignorer les valeurs nulles ou les remplacer par zéro. C'est important si vous souhaitez ignorer les lacunes de vos données.
+  **Remplissez le champ ci-dessous pour** — Remplissez la zone située entre deux séries.
+  **Ligne d'escalier** — Afficher la série sous forme de ligne d'escalier.
+  **Tirets** — Affiche une ligne avec des tirets. 
+  **Série cachée** — Masquez la série. 
+  **Longueur du tiret** — Définissez la longueur des tirets de la ligne.
+  **Espace entre les tirets** — Définissez la longueur des espaces entre les tirets de la ligne.
+  **Points** : affiche les séries sous forme de points distincts.
+  **Rayon du point** : définissez le rayon pour le rendu des points.
+  **Stack** — Définissez le groupe de pile pour la série.
+  **Couleur** — Définissez la couleur de la série.
+  **Axe Y** — Définissez l'axe Y de la série.
+  **Z-index** — Définissez l'index z de la série (ordre de rendu). Cette option est importante lorsque vous superposez différents styles, tels que des diagrammes à barres et des graphiques en aires.
+  Transformation — Transforme la valeur en valeur négative pour qu'elle soit affichée en dessous de l'axe Y.
+  **Légende** : permet de contrôler si une série est affichée dans la légende.
+  **Masquer dans l'infobulle** : permet de contrôler si une série est affichée dans l'infobulle d'un graphique.

## Axes
<a name="graph-panel-axes"></a>

Utilisez ces options pour contrôler l'affichage des axes dans la visualisation.

### Y/Right Y gauche
<a name="left-yright-y"></a>

Les options sont identiques pour les deux axes Y.
+  **Afficher** — Choisissez d'afficher ou de masquer l'axe.
+  **Unité** — Choisissez l'unité d'affichage pour la valeur y.
+  **Echelle** — Choisissez l'échelle à utiliser pour la valeur y : **linéaire** ou **logarithmique**. La valeur par défaut est **linéaire**.
+  **Y-Min** — La valeur y minimale. La valeur par défaut est **auto**.
+  **Y-Max** — La valeur Y maximale. La valeur par défaut est **auto**.
+  **Décimales** — Définissez le nombre de décimales affichées pour la valeur y. La valeur par défaut est **auto**. 
+  **Label** — Spécifiez le libellé de l'axe Y. La valeur par défaut est « »,

### Axes Y
<a name="y-axes"></a>
+  **Aligner** : aligne les axes Y gauche et droit par valeur. La valeur par défaut est décochée/false.
+  **Niveau** — Entrez la valeur à utiliser pour l'alignement des axes Y gauche et droit, en commençant par Y=0. La valeur par défaut est 0. Cette option est disponible lorsque l'option **Aligner** est sélectionnée. 

### Axe X
<a name="x-axis"></a>
+  **Afficher** — Choisissez d'afficher ou de masquer l'axe.
+  **Mode** — Le mode d'affichage modifie complètement la visualisation du panneau graphique. C'est comme trois panneaux en un. Le mode principal est le mode série chronologique avec le temps sur l'axe X. Les deux autres modes sont un mode graphique à barres de base avec des séries sur l'axe X au lieu du temps et un mode histogramme.
  +  **Heure** (par défaut) — L'axe X représente le temps et les données sont regroupées par heure (par exemple, par heure ou par minute).
  +  **Séries** — Les données sont regroupées par séries, et non par heure. L'axe Y représente toujours la valeur.
    +  **Valeur** : il s'agit du type d'agrégation à utiliser pour les valeurs. La valeur par défaut est le **total** (somme des valeurs).
  +  **Histogramme** : cette option convertit le graphique en histogramme. Un histogramme est une sorte de graphique à barres qui regroupe les nombres en plages, souvent appelées compartiments ou compartiments. Les barres plus hautes indiquent qu'un plus grand nombre de données se situent dans cette plage.

    Pour plus d'informations sur les histogrammes, consultez[Présentation des histogrammes et des cartes thermiques](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps).
    +  **Buckets** — Définit le nombre de compartiments selon lesquels regrouper les valeurs. Si ce champ est laissé vide, Amazon Managed Grafana essaie de calculer un nombre approprié de compartiments.
    +  **X-Min** : filtre de l'histogramme les valeurs inférieures à cette limite minimale.
    +  **X-Max** — Filtre les valeurs supérieures à cette limite maximale.

## Légende
<a name="graph-panel-legend"></a>

Utilisez ces paramètres pour affiner le mode d'affichage de la légende dans votre visualisation.

### Options
<a name="graph-panel-legends-options"></a>
+  **Afficher** — Effacer pour masquer la légende. La valeur par défaut est sélectionnée (true).
+  **Sous forme de tableau** : sélectionnez cette option pour afficher la légende dans le tableau. La valeur par défaut est cochée (true).
+  **À droite** : sélectionnez cette option pour afficher la légende à droite.
+  Largeur — Entrez la largeur minimale de la légende en pixels. Cette option est disponible lorsque l'option **Vers la droite** est sélectionnée.

### Valeurs
<a name="graph-panel-values"></a>

Des valeurs supplémentaires peuvent être affichées à côté des noms de légende.
+  **Min** — La valeur minimale renvoyée par la requête métrique.
+  **Max** — La valeur maximale renvoyée par la requête métrique.
+  **Avg** — La valeur moyenne renvoyée par la requête métrique.
+  **Current** — Dernière valeur renvoyée par la requête métrique.
+  **Total** : somme de toutes les valeurs renvoyées par la requête métrique.
+  **Décimales** : nombre de décimales affichées pour les valeurs de légende et les infobulles du graphe.

Amazon Managed Grafana calcule les valeurs des légendes côté client. Ces valeurs de légende dépendent du type d'agrégation ou de consolidation de points utilisé par votre requête métrique. Toutes les valeurs de légende ci-dessus ne peuvent pas être correctes en même temps.

Par exemple, si vous tracez un taux de ces demandes/seconde, en utilisant probablement la moyenne comme agrégateur, le total indiqué dans la légende ne représentera pas le nombre total de demandes. Il s'agit simplement de la somme de tous les points de données reçus par Amazon Managed Grafana. 

### Masquer la série
<a name="graph-panel-hide-series"></a>

Masquer une série lorsque toutes les valeurs d'une série issues d'une requête métrique correspondent à une valeur spécifique.
+  **Avec uniquement des valeurs nulles** — Value=NULL (décochée par défaut)
+  **Avec uniquement des zéros** : valeur = zéro (décochée par défaut)

### Régions temporelles
<a name="graph-panel-time-regions"></a>

Vous pouvez mettre en évidence des régions horaires spécifiques sur le graphique pour le rendre plus visible, par exemple les week-ends, les heures de bureau et les heures hors travail. Toutes les régions horaires configurées font référence à l'heure UTC.

# Heatmap
<a name="visualization-heatmap"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

La visualisation du panneau Heatmap vous permet de visualiser les histogrammes au fil du temps. Pour plus d'informations sur les histogrammes, consultez[Présentation des histogrammes et des cartes thermiques](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps).

## Options d'axes
<a name="heatmap-axes-options"></a>

Utilisez ces paramètres pour ajuster le mode d'affichage des axes dans votre visualisation.

### Axe Y
<a name="heatmap-y-axis"></a>
+  **Unité — Unité** d'affichage pour la valeur de l'axe Y
+  **Echelle** — L'échelle à utiliser pour la valeur de l'axe Y
  +  **linear** — Échelle linéaire 
  +  **log (base 2)** — Échelle logarithmique en base 2
  +  **log (base 10)** — Échelle logarithmique en base 10
  +  **log (base 32)** — Échelle logarithmique avec base 32
  +  **log (base 1024)** — Échelle logarithmique avec base 1024
+  **Y-Min** — La valeur y minimale (la valeur par défaut est auto)
+  **Y-Max** — La valeur y maximale (la valeur par défaut est auto)
+  **Décimales** — Nombre de décimales avec lesquelles afficher les valeurs de l'axe Y (la valeur par défaut est auto)

### Compartiments
<a name="heatmap-buckets"></a>

**Note**  
Si le format des données est les **compartiments de séries chronologiques**, cette section n'est pas disponible.
+  **Compartiments de l'axe Y** : nombre de compartiments dans lesquels l'axe Y sera divisé.
+  **Taille** — Taille de chaque compartiment de l'axe Y (visible uniquement si **l'échelle** est *linéaire*). Cette option a priorité sur les **buckets de l'axe Y.**
+  **Facteur de division** — (Visible uniquement si **l'échelle** est *logarithmique (base 2)* ou supérieure). Par défaut, Amazon Managed Grafana divise mes valeurs par base log. Avec cette option, vous pouvez diviser chaque compartiment par défaut en un nombre de compartiments spécifié.
+  **Godets de l'axe X** : nombre de compartiments dans lesquels l'axe X sera divisé.
+  **Taille** : taille de chaque compartiment sur l'axe X. Nombre ou intervalle de temps (10 s, 5 m, 1 h, etc.) Intervalles pris en charge : ms, s, m, h, d, w, M, y. Cette option est prioritaire par rapport aux **compartiments de l'axe X.**

#### Relié au seau
<a name="heatmap-bucket-bound"></a>

Lorsque le format de données est Compartiments de séries chronologiques, la source de données renvoie des séries dont les noms représentent des compartiments délimités. Mais selon la source de données, une limite peut être supérieure ou inférieure. Vous pouvez utiliser cette option pour ajuster un type de liaison. Si **Auto** est défini, une option liée est choisie en fonction du type de source de données des panneaux.

#### Taille de compartiment
<a name="heatmap-bucket-size"></a>

Les options de nombre et de taille des compartiments sont utilisées par Amazon Managed Grafana pour calculer la taille de chaque cellule de la carte thermique. Vous pouvez définir la taille du compartiment soit en fonction du nombre (première zone de saisie), soit en spécifiant un intervalle de taille. Pour l'axe Y, l'intervalle de taille n'est qu'une valeur. Pour le X-bucket, vous pouvez spécifier un intervalle de temps dans la saisie **Taille**. Par exemple, vous pouvez définir la plage horaire sur`1h`. Cela donnera aux cellules une largeur de 1 h sur l'axe X.

#### Format de données
<a name="heatmap-data-format"></a>

Choisissez une option dans la liste **Format**.
+ **Séries chronologiques** — Amazon Managed Grafana effectue le découpage en passant en revue toutes les valeurs des séries chronologiques. La taille et les intervalles des compartiments sont définis dans les options **des compartiments**.
+ Compartiments de **séries chronologiques** — Chaque série chronologique représente déjà un compartiment de l'axe Y. Le nom de la série chronologique (alias) doit être une valeur numérique représentant l'intervalle supérieur ou inférieur du compartiment. L'espace de travail Grafana ne comporte pas de compartiments, les options de taille de compartiment sont donc masquées.

## Options d'affichage
<a name="heatmap-display-options"></a>

Utilisez ces paramètres pour affiner votre visualisation.

### Couleurs
<a name="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 située à l'extrême gauche du spectre représente le nombre minimum et la couleur à l'extrême 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** 
  +  **Opacité** : valeur du compartiment représentée par l'opacité de la cellule. Une cellule opaque correspond à la 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 le cas de`1`, l'échelle sera identique à celle de l'échelle linéaire.
    +  **Exposant** : valeur de l'exposant, supérieure à. `0`
  +  **spectrum** — Valeur du compartiment représentée par la couleur de la cellule.
    +  **Schéma** : si le mode est le **spectre**, sélectionnez un jeu de couleurs.

### Échelle de couleurs
<a name="heatmap-color-scale"></a>

Par défaut, Amazon Managed Grafana calcule les couleurs des cellules en fonction des valeurs minimale et maximale des compartiments. Avec **Min** et **Max**, vous pouvez remplacer ces valeurs. Considérez la valeur d'un compartiment comme un axe Z et Min et Max comme Z-Min et Z-Max respectivement.
+  **Min** : 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 par défaut est `series min value`.
+  **Max** : 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 à la couleur maximale. La valeur par défaut est `series max value`. 

### Légende
<a name="heatmap-legend"></a>

Choisissez d'afficher ou non la légende de la carte thermique sur la visualisation. 

### Compartiments
<a name="heatmap-legend-buckets"></a>
+  **Masquer zéro** : ne dessinez pas de cellules dont la valeur est nulle.
+  **Espace** : définissez l'espace entre les cellules en pixels. La valeur par défaut est de 1 pixel.
+  **Rond** — Définissez la rondeur de la cellule en pixels. La valeur par défaut est 0.

### Info-bulle
<a name="heatmap-tooltip"></a>
+  **Afficher l'infobulle : affiche l'infobulle** de la carte thermique.
+  **Histogramme** — Affiche l'histogramme de l'axe Y dans l'infobulle. L'histogramme représente la distribution des valeurs du compartiment pour l'horodatage spécifique.
+  **Décimales** — Définissez le nombre de décimales à utiliser pour le rendu de la valeur du bucket (la valeur par défaut est auto).

# Panneau d'histogramme
<a name="histogram-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

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.

La visualisation de l'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="histogram-options"></a>

Utilisez les options suivantes pour affiner vos visualisations :

**Taille du godet**

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

**La largeur** de ligne contrôle la largeur de ligne des barres.

**L'opacité de remplissage** contrôle l'opacité de remplissage des barres.

**Le 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 votre curseur sur le graphique, Grafana peut afficher des infobulles. Choisissez le comportement des infobulles :
+  **Unique** — L'infobulle indique uniquement la série sur laquelle vous passez le pointeur de la souris.
+  **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. 

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

## Options de légende
<a name="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.

**Mode légende** Utilisez ces paramètres pour affiner 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.

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

**Calculs de légendes**

Choisissez les calculs à afficher dans la légende. Pour de plus amples informations, veuillez consulter [Liste des calculs](list-of-calculations.md).

# Panneau Logs
<a name="logs-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

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

## Options d'affichage
<a name="logs-panel-display-options"></a>

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.
+  **Lignes d'enroulement** — Activez l'enroulement de lignes. 
+  **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.

# Panneau d'actualités
<a name="news-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Ce panneau affiche un flux RSS. Par défaut, il affiche les articles du blog de Grafana Labs.

Dans la section **Affichage**, dans le champ **URL**, entrez l'URL d'un flux RSS. Ce type de panneau n'accepte aucune autre requête.

# Panneau de graphes de nœuds (version bêta)
<a name="node-graph-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau de graphes de nœuds permet de visualiser des graphes ou des réseaux orientés. Il utilise 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="node-graph-panel-requirements"></a>

Le panneau de graphes de nœuds nécessite une forme spécifique des données pour pouvoir afficher ses nœuds et ses arêtes. Toutes les sources de données ou requêtes ne peuvent pas être visualisées dans ce panneau.

La visualisation du graphe de nœuds comprend des *nœuds* et des *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 exécution ou une autre relation entre les deux nœuds.

## Nœuds
<a name="node-graph-panel-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, les 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. Il peut également y avoir des liens supplémentaires dans le menu contextuel qui peuvent cibler d'autres parties de l'espace de travail Grafana ou n'importe quel lien externe.

## Edges
<a name="node-graph-panel-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).

Des détails supplémentaires peuvent être affichés dans un menu contextuel, qui s'affiche lorsque vous choisissez le nœud. Il peut également y avoir des liens supplémentaires dans le menu contextuel qui peuvent cibler d'autres parties de l'espace de travail Grafana ou n'importe quel lien externe.

## Navigation dans le graphe de nœuds
<a name="node-graph-panel-navigation"></a>

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 la souris.

Vous pouvez zoomer à l'aide des boutons situés dans le coin supérieur gauche du graphe de nœuds.

# Panneau de diagramme à secteurs
<a name="pie-chart-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

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

Les visualisations de diagrammes à secteurs vous permettent d'appliquer les options suivantes :
+  [Transformations](panel-transformations.md). 
+  [Options de champ et remplacements](field-options-overrides.md). 
+  [Seuils](thresholds.md).

## Options
<a name="pie-chart-panel-options"></a>

Vous pouvez utiliser les options suivantes pour affiner votre visualisation.
+  **Afficher** — Choisissez la quantité d'informations à afficher. **Calculer** réduit chaque valeur à une valeur unique par série. **Toutes les valeurs** affichent toutes les valeurs d'une seule série.
+  **Calcul** — Sélectionnez un calcul pour réduire chaque série lorsque **Calculer** a été sélectionné. Pour plus d'informations sur les calculs disponibles, consultez[Liste des calculs](list-of-calculations.md).
+  **Limite** — Lorsque vous affichez toutes les valeurs d'une seule série, cela limite le nombre de valeurs affichées.
+  **Champs** : sélectionnez les champs à afficher dans la visualisation.
  + **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.

## Étiquettes
<a name="pie-charts-panel-labels"></a>

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. Vous devrez peut-être sélectionner des couleurs de graphique plus foncées pour les rendre plus visibles. Les noms longs ou les chiffres peuvent être coupés.

## Placement et valeurs des légendes
<a name="pie-charts-panel-legend"></a>

Choisissez où afficher la légende.
+  **En bas** — Sous le graphique.
+  **Droite** : à droite du graphique. 

Vous pouvez sélectionner plusieurs valeurs à afficher dans la légende. Le **pourcentage** est le pourcentage de l'ensemble et **la valeur** est la valeur numérique brute.

# Panneau Plotly
<a name="plotly-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau Plotly affiche des graphiques à l'aide de [Plotly](https://plotly.com/javascript/), une bibliothèque graphique JavaScript open source.

Les champs **Data**, **Layout** et **Config** correspondent aux paramètres courants décrits dans la [documentation de Plotly](https://plotly.com/javascript/plotlyjs-function-reference/). Ils doivent être au format JSON.

Les données fournies par la source de données peuvent être transformées via un script défini par l'utilisateur avant d'être injectées dans le graphique Plotly. Le script inclut 2 arguments.
+ `data`— Données renvoyées par la source de données.
+ `variables`— Un objet qui contient des [variables Grafana](templates-and-variables.md) dans le tableau de bord actuel (variables utilisateur et quelques variables globales :`__from`, `__to``__interval`, et`__interval_ms`).

Le script doit renvoyer un objet présentant une ou plusieurs des propriétés suivantes : `data``layout`, `config` et`frames`. Voici un exemple.

```
let x = data.series[0].fields[0].values;
let y = data.series[0].fields[1].values;
let series = {
    x: x,
    y: y,
    name: variables.name, // where ‘name’ is the name of a Grafana dashboard variable
};

return {
    data: [series],
    config: {
        displayModeBar: false,
    },
};
```

L'objet renvoyé par le script et le JSON fournis dans les champs *Data*, *Layout* et *Config* seront fusionnés (fusion profonde).

Si aucun script n'est fourni, le panneau utilisera uniquement les champs *Data*, *Layout* et *Config*.

# Panneau Sankey
<a name="sankey-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau Sankey affiche des diagrammes de Sankey, qui sont utiles pour visualiser les données de flux, la largeur du flux étant proportionnelle à la métrique sélectionnée. L'image suivante montre un diagramme de Sankey avec deux groupes de sources et de destinations.

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/sankey-panel.png)


**Fonctionnement**

Le panneau Sankey nécessite au moins 2 colonnes de données, une source et une destination pour les flux. Votre requête doit regrouper vos données en au moins deux groupes. Le panneau tracera des liens entre la première colonne de points de données et la dernière dans l'ordre de la requête. L'épaisseur des liens sera proportionnelle à la valeur attribuée par la métrique dans la requête.

**Personnalisation**
+ **Liens** — Il existe actuellement deux options pour la couleur des liens : multiple ou unique. Il est multicolore par défaut. Pour choisir une seule couleur pour les liens, activez l'option Couleur du **lien unique uniquement et choisissez votre couleur** dans le sélecteur de couleurs de Grafana.
+ **Nœuds** — Vous pouvez modifier la couleur des nœuds rectangulaires en modifiant l'option **Couleur des nœuds**
+ **Largeur du nœud** — La largeur des nœuds peut être ajustée à l'aide du curseur de **largeur du nœud** ou en saisissant un nombre dans la zone de saisie. Ce nombre doit être un entier.
+ **Rembourrage** des nœuds : le rembourrage vertical entre les nœuds peut être ajusté à l'aide du curseur de **rembourrage des nœuds** ou en saisissant un nombre dans la zone de saisie. Ce nombre doit être un entier. Si vos liens sont trop fins, essayez d'ajuster ce nombre
+ **En-têtes — Les** en-têtes des colonnes peuvent être modifiés en remplaçant le **nom d'affichage** dans le panneau de l'éditeur. Ils seront de la même couleur que celle que vous avez choisie pour la **couleur du texte**
+ **Disposition Sankey** — La disposition des liens Sankey peut être légèrement ajustée à l'aide du curseur d'**itération de mise en page**. Ce nombre doit être un entier et correspond au nombre d'itérations de relaxation utilisées pour générer la mise en page.

# Panneau Scatter
<a name="scatter-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau de dispersion affiche un diagramme de X/Y dispersion pour les données d'un tableau avec une interface plus simple que les autres panneaux graphiques. Contrairement au panneau graphique, le panneau de dispersion ne nécessite pas que les données figurent dans une série chronologique. Le panneau de dispersion nécessite un jeu de données formaté sous forme de tableau avec au moins deux colonnes numériques de données.

L'un d'entre eux peut être affecté à l'axe X. Une ou plusieurs valeurs peuvent être attribuées à une série de valeurs de l'axe Y et les données obtenues peuvent être tracées sous forme de séries de points. Chaque série peut également éventuellement afficher une droite de régression en utilisant l'un des nombreux meilleurs ajustements statistiques.

**Création d'un panneau de dispersion**

La procédure suivante explique comment créer un nuage de points à l'aide du panneau de dispersion. Pour cet exemple, nous supposerons qu'il existe des données, comme dans le tableau suivant, appelées `HEIGHT` avec trois colonnes de valeurs numériques `Age``Boys`,`Girls`, et indiquant la taille moyenne des garçons et des filles par âge.


| Age | Taille du garçon | Taille de la fille | 
| --- | --- | --- | 
|  5  |  109,7  |  109,5  | 
|  6  |  115,6  |  115,4  | 
|  7  |  121,1  |  120,8  | 
|  8  |  126,3  |  126  | 
|  9  |  131,3  |  131,3  | 
|  10  |  136,2  |  137,1  | 
|  11  |  141,2  |  143,2  | 
|  12  |  147  |  148,7  | 
|  13  |  153,6  |  152,6  | 
|  14  |  159,9  |  155,1  | 
|  15  |  164,4  |  156,7  | 
|  16  |  167,3  |  157,6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158,3  | 
|  19  |  170,8  |  158,6  | 

**Pour créer un nuage de points à l'aide du panneau de dispersion**

1. Dans votre tableau de bord Grafana, choisissez **Ajouter** un panneau. Pour plus de détails sur l'ajout de panneaux, consultez[Ajouter un panneau](add-a-panel-to-a-dashboard.md).

1. Pour la requête, rédigez une requête qui renverra les données nécessaires. Dans ce cas, vous devez utiliser une requête telle que`SELECT * FROM HEIGHT`.

1. Sélectionnez la visualisation **Scatter**.

Cela créera un diagramme de dispersion, en utilisant la première colonne comme axe X et les autres colonnes numériques comme axes Y.

**Options de configuration**

Le panneau de dispersion propose les quatre options de configuration personnalisées suivantes.
+ **Axe X** — Vous pouvez choisir le champ à utiliser comme axe X, ainsi que les étendues et le titre et afficher les informations relatives à l'axe.
+ **Axe Y** : vous pouvez choisir les champs à afficher sur l'axe Y, y compris les options d'affichage pour chaque champ, ainsi que les informations relatives à l'étendue et au titre de l'axe. Vous pouvez également choisir d'afficher une droite de régression pour chaque champ. Consultez les informations suivantes pour plus de détails sur la configuration des droites de régression.
+ **Légende** : vous pouvez activer ou désactiver une légende pour le panneau, ainsi que choisir la taille du texte dans la légende.
+ **Affichage** : vous pouvez définir d'autres options pour le graphique, notamment la couleur de la grille et le style de bordure.

**Configuration de la ligne de régression**

Chaque jeu de données de l'axe Y peut afficher une ligne, en plus des points individuels. Il existe cinq options pour le type de ligne.
+ **Aucun** — N'affiche pas de droite de régression.
+ **Simple** : affiche une droite de régression qui relie les points du jeu de données.
+ **Linéaire** — Affichez une ligne droite en utilisant la méthode des moindres carrés et du meilleur ajustement.
+ **Exponentiel** : affiche la droite de régression exponentielle la mieux ajustée.
+ **Puissance** : affiche la droite de régression la mieux adaptée à la puissance.

# Panneau de démarrage
<a name="stat-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau de statistiques affiche 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.

Par défaut, le panneau de statistiques affiche l'un des affichages suivants :
+ Seule 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 l'option **Mode texte** pour contrôler si le texte est affiché ou non.

## Options de données et de champs
<a name="stat-panel-data-and-field-options"></a>

Les visualisations de statistiques vous permettent d'appliquer les options suivantes :
+  [Transformations](panel-transformations.md).
+  [Options de champ et remplacements](field-options-overrides.md).
+  [Seuils](thresholds.md).

## Réglage automatique de la disposition
<a name="stat-panel-automatic-layout-adjustment"></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 d'affichage
<a name="stat-panel-display-options"></a>

Utilisez les options suivantes pour affiner votre visualisation :
+  **Afficher** — Choisissez la manière dont Amazon Managed Grafana affiche vos données.
  +  **Calculer** : affiche une valeur calculée en fonction de toutes les lignes.
    +  **Calcul** : sélectionnez le calcul à appliquer. Pour plus d'informations sur les calculs disponibles, consultez[Liste des calculs](list-of-calculations.md).
  +  **Toutes les valeurs** : affiche une statistique distincte pour chaque ligne.
    +  **Limite** — Spécifiez le nombre maximum de lignes à afficher.
+  **Champs** — Sélectionnez le nom ou le type de champ (y compris **Tous les champs** ou les **champs numériques**) à inclure dans ce panneau.
+  **Valeur** : sélectionnez une fonction de réduction qu'Amazon Managed Grafana utilisera pour réduire de nombreux champs à une seule valeur. Choisissez la liste des **valeurs** pour voir les fonctions et de brèves descriptions. 
+  **Orientation** — Choisissez une direction d'empilement.
  +  **Automatique** : Amazon Managed Grafana sélectionne l'orientation qu'il considère être la meilleure.
  +  **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é dans le panneau. Si seuls le nom et la couleur sont importants et que la valeur ne l'est pas, remplacez le **mode Texte** par **Nom**. La valeur est 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, affichez à la fois le nom et la valeur.
  +  **Valeur** : affiche uniquement la valeur, jamais le nom. Le nom est 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.
  +  **Aucun** — Ne rien afficher (vide). Le nom et la valeur sont affichés dans l'infobulle.
+  **Mode couleur** — Choisissez un mode couleur.
  +  **Valeur** : colore uniquement la valeur et la zone du graphique.
  +  **Arrière-plan** : colore également l'arrière-plan.
+  **Mode graphique** : choisissez un mode graphique.
  +  **Aucun** : masque le graphique et affiche uniquement la valeur.
  +  **Zone** — Affiche le graphique en aires en dessous de la valeur. Cette option nécessite que votre requête renvoie une colonne de temps.
+  **Mode d'alignement** : 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.

# Panneau chronologique de l'État
<a name="state-timeline-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

La visualisation du panneau chronologique des états montre 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.

## Options de chronologie de l'État
<a name="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 des États.

**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 d'État.

**Opacité du remplissage**

Contrôle l'opacité des régions de l'État.

## Mappages de valeurs
<a name="state-timeline-valuemap"></a>

Pour attribuer des couleurs à des valeurs booléennes ou à des valeurs de chaîne, utilisez. [Cartographie des valeurs](field-options-overrides.md#value-mapping)

## Données de séries chronologiques avec seuils
<a name="state-timeline-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 transformer les séries chronologiques en régions d'états colorées discrètes.

## Options de légende
<a name="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 affiner l'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.

**Emplacement de la légende** Choisissez où placer la légende.
+  **En bas** — Sous le graphique.
+  **Droite** : à droite du graphique.

# Panneau d'historique des statuts
<a name="status-history-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

La visualisation de 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.

La visualisation de 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="status-timeline-options"></a>

Utilisez les options suivantes pour affiner vos visualisations :

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

La **largeur des colonnes** contrôle la largeur des cases. 1 = largeur maximale et 0 = largeur minimale.

**La largeur de ligne** contrôle la largeur de ligne des régions de l'État.

**L'opacité de remplissage** contrôle l'opacité de remplissage des régions de l'État.

## Mappages de valeurs
<a name="status-history-valuemap"></a>

Pour attribuer des couleurs à des valeurs booléennes ou à des valeurs de chaîne, utilisez. [Cartographie des valeurs](field-options-overrides.md#value-mapping)

## Données de séries chronologiques avec seuils
<a name="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="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 affiner 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.

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

# Panneau de table
<a name="table-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau de tableau prend en charge plusieurs modes pour les séries chronologiques et pour les tables, les annotations et les données JSON brutes. Ce panneau fournit également des options de mise en forme de date, de mise en forme de valeur et de coloration.

## Options de données et de champs
<a name="data-and-field-options"></a>

Les visualisations de tableaux vous permettent d'appliquer les options suivantes :
+  [Transformations](panel-transformations.md).
+  [Options de champ et remplacements](field-options-overrides.md).
+  [Seuils](thresholds.md).

## Options d'affichage
<a name="display-options"></a>
+  **Afficher l'en-tête** : affiche ou masque les noms des colonnes importées depuis votre source de données.
+  **Trier par ordre croissant ou décroissant** : choisissez un titre de colonne pour modifier l'ordre de tri par défaut en ordre décroissant ou croissant. Chaque fois que vous choisissez, l'ordre de tri passe à l'option suivante du cycle. Vous pouvez trier uniquement selon une colonne à la fois.
+  [Options des champs du tableau](#table-field-options)— Modifiez les options de champ telles que la largeur des colonnes, l'alignement et le mode d'affichage des cellules.
+  [Filtrer les colonnes du tableau](#filter-table-columns)— Modifiez 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.

## Support d'annotation
<a name="annotation-support"></a>

Les annotations ne sont actuellement pas prises en charge dans le nouveau panneau de tableau.

## Options des champs du tableau
<a name="table-field-options"></a>

Cette section explique toutes les options de champs de table disponibles. Les options sont répertoriées dans le même ordre que dans Amazon Managed Grafana. Les options répertoriées dans cette rubrique s'appliquent uniquement aux visualisations de panneaux de tableau.

La plupart des options de champ n'affectent pas la visualisation tant que vous n'avez pas sélectionné d'options de champ en dehors de la zone d'options de champ que vous modifiez ou que vous n'avez pas appuyé sur Entrée.

Pour plus d'informations sur l'application de ces options, reportez-vous [Configurer tous les champs](field-options-overrides.md#configure-all-fields) aux sections et[Configurer des champs spécifiques](field-options-overrides.md#configure-specific-fields).

### Alignement des colonnes
<a name="column-alignment"></a>

Choisissez comment Amazon Managed Grafana doit aligner le contenu des cellules :
+ Auto (par défaut)
+ Left (Gauche)
+ Center
+ Right (Droite)

### Largeur de colonne
<a name="column-width"></a>

Par défaut, Amazon Managed Grafana calcule automatiquement la largeur de colonne en fonction du contenu des cellules. Dans cette option de champ, vous pouvez annuler le paramètre et définir la largeur de toutes les colonnes en pixels.

Par exemple, si vous entrez `100` dans le champ, toutes les colonnes seront définies sur une largeur de 100 pixels lorsque vous choisissez de ne pas entrer dans le champ.

### Mode d'affichage cellulaire
<a name="cell-display-mode"></a>

Par défaut, Amazon Managed Grafana choisit automatiquement les paramètres d'affichage. Vous pouvez annuler les paramètres en choisissant l'une des options suivantes pour modifier tous les champs.

**Note**  
Si vous les définissez dans l'onglet **Champ**, les modes d'affichage s'appliquent à tous les champs, y compris le champ horaire. De nombreuses options fonctionnent mieux si vous les définissez dans l'onglet **Remplacer**.

#### Texte en couleur
<a name="color-text"></a>

Si des seuils sont définis, le texte du champ est affiché dans la couleur de seuil appropriée.

#### Fond de couleur
<a name="color-background"></a>

Si des seuils sont définis, l'arrière-plan du champ est affiché dans la couleur de seuil appropriée.

#### Jauge de gradient
<a name="gradient-gauge"></a>

Les niveaux de seuil définissent un gradient.

#### Jauge LCD
<a name="lcd-gauge"></a>

La jauge est divisée en petites cellules allumées ou éteintes.

#### Vue JSON
<a name="json-view"></a>

La valeur est affichée sous forme de code. Si une valeur est un objet, la vue JSON qui vous permet de parcourir l'objet JSON apparaît lorsque vous faites une pause sur la valeur.

### Filtre à colonne
<a name="column-filter"></a>

## Filtrer les colonnes du tableau
<a name="filter-table-columns"></a>

Si vous activez le **filtre de colonne** dans les options du tableau, vous pouvez filtrer les options du tableau. Pour de plus amples informations, veuillez consulter [Options des champs du tableau](#table-field-options).

### Activer le filtrage des colonnes
<a name="turn-on-column-filtering"></a>

1. Dans Amazon Managed Grafana, choisissez le tableau de bord qui affiche le tableau contenant les colonnes que vous souhaitez filtrer.

1. Sur le panneau du tableau que vous souhaitez filtrer,[Ouverture de l'éditeur de panneaux](AMG-panel-editor.md#open-the-panel-editor).

1. Choisissez l'onglet **Champ**.

1. Dans les options du **tableau**, activez l'option **Filtre par colonne**.

Une icône de filtre apparaît à côté du titre de chaque colonne.

### Valeurs des colonnes de filtre
<a name="filter-column-values"></a>

Pour filtrer les valeurs des colonnes, cliquez sur l'icône du filtre (entonnoir) à côté du titre d'une colonne. L'espace de travail Grafana affiche les options de filtre pour cette colonne.

Cochez les cases à 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.

### Effacer les filtres à colonne
<a name="clear-column-filters"></a>

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 bleue en forme d'entonnoir, puis cliquez sur **Effacer le filtre**.

# Panneau de texte
<a name="text-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Vous pouvez utiliser le panneau de texte pour créer des panneaux d'information et de description pour vos tableaux de bord.

Dans **Mode**, indiquez si vous souhaitez utiliser le Markdown ou le HTML pour le style de votre texte, puis entrez le contenu dans le champ ci-dessous. L'espace de travail Grafana inclut un titre et un paragraphe pour vous aider à démarrer, ou vous pouvez coller le contenu d'un autre éditeur.

# Panneau des séries chronologiques
<a name="time-series-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le panneau des séries chronologiques peut afficher une série chronologique sous la forme d'une ligne, d'un tracé de points ou d'une série de barres. Ce type de graphique est suffisamment polyvalent 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.

Les visualisations de séries chronologiques vous permettent d'appliquer les options suivantes :
+  [Transformations](panel-transformations.md) 
+  [Options de champ et remplacements](field-options-overrides.md) 
+  [Seuils](thresholds.md) 

Vous pouvez également utiliser les options de champ pour créer différents types de graphiques ou ajuster vos axes.

Utilisez ces paramètres pour affiner votre visualisation.

## Mode infobulle
<a name="time-series-panel-tooltip"></a>

Lorsque vous passez votre curseur sur le graphique, Grafana peut afficher des infobulles. Choisissez le comportement des infobulles :
+  **Unique** — L'infobulle indique uniquement la série sur laquelle vous passez le pointeur de la souris.
+  **Tout** — L'infobulle affiche toutes les séries du graphique. 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. 

## Mode légende et placement
<a name="time-series-panel-legend"></a>

Choisissez le mode d'affichage de la légende.
+  **Liste** — Affiche la légende sous forme de liste. Il s’agit de l’option par défaut.
+  **Tableau** : affiche la légende sous forme de tableau. 
+  **Masqué** : masque la légende.

Choisissez l'endroit où vous souhaitez afficher la légende.
+  **En bas** : en dessous du graphique.
+  **Droite** : à droite du graphique. 

## Calculs de légendes
<a name="time-series-panel-legend-calculations"></a>

Choisissez les calculs à afficher dans la légende. Pour de plus amples informations, veuillez consulter [Liste des calculs](list-of-calculations.md).

# Représentez les séries chronologiques sous forme de lignes
<a name="time-series-graph-lines"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Cette section explique comment utiliser les options des champs de séries chronologiques pour visualiser les données de séries chronologiques sous forme de lignes et illustre le rôle de ces options.

**Création du panneau**

1. Créez un panneau en sélectionnant la visualisation des **séries chronologiques**. Pour de plus amples informations, veuillez consulter [Ajouter un panneau](add-a-panel-to-a-dashboard.md).

1. Dans l'**éditeur de panneaux**, choisissez **Field**.

1. Dans **Style**, sélectionnez **Lignes**.

## Donnez du style aux lignes
<a name="time-series-graph-lines-style"></a>

Il existe une variété d'options pour styliser les lignes.
+ **Interpolation de ligne** — Choisissez la manière dont Grafana interpole la ligne de série. Les choix sont **Linear**, **Smooth**, **Step before** et **Step after**.
+ **Largeur de ligne** — Définissez l'épaisseur de ligne entre 0 et 10 pixels.
+ **Opacité du remplissage** — Définissez l'opacité du remplissage de la série, de 0 à 100 %.
+ **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**.

  Les options disponibles pour le remplissage dégradé sont **Aucune**, **Opacité** et **Teinte**. Avec **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. Avec **Hue**, le dégradé de couleur est généré en fonction de la teinte de la couleur du trait.
+ **Style de ligne** : définissez le style de la ligne. Pour modifier la couleur, utilisez l'option de champ du jeu de couleurs standard.

  L'apparence du style de ligne est influencée par les paramètres de **largeur de ligne** et d'**opacité de remplissage**.

  Les choix de style de ligne sont **Solid**, **Dash** et **Dots**.
+ **Valeurs nulles** : choisissez le mode d'affichage des lacunes dans les données. Les valeurs nulles peuvent être connectées pour former une ligne continue ou, éventuellement, définir un seuil au-dessus duquel les lacunes dans les données ne doivent plus être connectées. Vous pouvez choisir de **ne jamais** connecter les points de données avec des lacunes, de **toujours** connecter les points de données avec des lacunes ou de définir un **seuil à partir** duquel les lacunes dans les données ne devraient plus être connectées.
+ **Afficher les points** : choisissez le moment où les points doivent apparaître sur le graphique. Les choix sont **Auto**, **Toujours** et **Jamais**.

## Remplissez le formulaire ci-dessous pour
<a name="time-series-panel-legend-fillbelow"></a>

Cette option n'est disponible que dans l'onglet overrides.

**Pour remplir la zone située entre deux séries**

1. Sélectionnez les champs à remplir ci-dessous.

1. Dans **Ajouter une propriété de remplacement**, choisissez **Remplir ci-dessous pour.**

1. Sélectionnez la série à laquelle vous souhaitez que le remplissage s'arrête.

# Représentez les séries chronologiques sous forme de barres
<a name="time-series-graph-bars"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Cette section explique comment utiliser les options des champs de séries chronologiques pour visualiser les données de séries chronologiques sous forme de barres et illustre le rôle de ces options.

**Création du panneau**

1. Créez un panneau en sélectionnant la visualisation des **séries chronologiques**. Pour de plus amples informations, veuillez consulter [Ajouter un panneau](add-a-panel-to-a-dashboard.md).

1. Dans l'**éditeur de panneaux**, choisissez **Field**.

1. Dans **Style**, sélectionnez **Bars**.

## Donnez du style aux barres
<a name="time-series-graph-bars-style"></a>

Il existe une variété d'options pour styliser les barres.
+ **Alignement des barres** — Définissez la position de la barre par rapport à un point de données. Les choix sont **Avant**, **Centre** et **Après**.
+ **Largeur de ligne** — Définissez l'épaisseur des contours des barres entre 0 et 10 pixels.
+ **Opacité du remplissage** : définissez l'opacité du remplissage de la barre, de 0 à 100 %.
+ **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**.

  Les options disponibles pour le remplissage dégradé sont **Aucune**, **Opacité** et **Teinte**. Avec **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. Avec **Hue**, le dégradé de couleur est généré en fonction de la teinte de la couleur du trait.
+ **Afficher les points** : choisissez le moment où les points doivent apparaître sur le graphique. Les choix sont **Auto**, **Toujours** et **Jamais**.

# Représente les séries chronologiques sous forme de points
<a name="time-series-graph-points"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Cette section explique comment utiliser les options des champs de séries chronologiques pour visualiser les données de séries chronologiques sous forme de points et illustre le rôle de ces options.

**Création du panneau**

1. Créez un panneau en sélectionnant la visualisation des **séries chronologiques**. Pour de plus amples informations, veuillez consulter [Ajouter un panneau](add-a-panel-to-a-dashboard.md).

1. Dans l'**éditeur de panneaux**, choisissez **Field**.

1. Dans **Style**, sélectionnez **Points**.

## Donnez du style aux points
<a name="time-series-graph-points-style"></a>

Lorsque vous tracez un graphique sous forme de points, vous pouvez choisir la taille des points.
+ **Taille du point** : choisissez la taille du point, comprise entre 1 et 40 pixels de diamètre.

# Modifier l'affichage de l'axe
<a name="time-series-change-axis"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Cette section explique comment utiliser les options des champs de séries chronologiques pour contrôler l'affichage des axes dans la visualisation et illustre le rôle des options des axes.

Il existe une variété d'options pour les axes.
+ **Positionnement de l'axe Y** — Définissez le placement de l'axe Y. Les choix sont **Gauche**, **Droite** et **Masqué**.
+ **Étiquette de l'axe Y** — Définissez une étiquette de texte pour l'axe Y. Si vous avez plusieurs axes Y, vous pouvez utiliser l'onglet **Override** pour leur attribuer différentes étiquettes.
+ **Largeur** — Définissez la largeur fixe de l'axe. Par défaut, l'espace de travail Grafana calcule dynamiquement la largeur de l'axe. En définissant la largeur de l'axe, les données dont les types d'axes sont différents peuvent partager les mêmes proportions d'affichage. Cela facilite la comparaison des données de plusieurs graphiques, 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 un **minimum doux** ou un **maximum doux** pour un meilleur contrôle des limites de l'axe Y. Par défaut, l'espace de travail Grafana définit automatiquement la plage de l'axe Y en fonction des données.

  Les paramètres **Soft min** ou **Soft Max** peuvent empêcher les blips d'apparaître sous forme de 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 des détails utiles en les découpant au-delà d'un point défini.
+ **Echelle** — Définissez l'échelle à utiliser pour les valeurs de l'axe Y. Les choix sont **Linéaire** et **Logarithmique**.

# Séries chronologiques empilées sous forme de graphes
<a name="time-series-stacked"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Cette section explique comment utiliser les options de champ du panneau des séries chronologiques pour contrôler l'empilement des séries et illustre le rôle des options d'empilement. 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. Vous pouvez en savoir plus sur les raisons pour lesquelles l'empilage n'est peut-être pas la meilleure approche ici : [Le problème de l'empilement](https://www.data-to-viz.com/caveat/stacking.html).

# Séries Stack en groupes
<a name="time-series-stacked-groups"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

L'option de groupe d'empilage n'est disponible qu'en tant que dérogation.

**Pour empiler des séries dans le même groupe**

1. Dans la section Overrides, créez une dérogation de champ pour l'option **Stack series**.

1. Choisissez le mode d'empilage **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 lors de la création d'une dérogation.

# Seuils
<a name="thresholds"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Les seuils définissent la couleur du texte de la valeur ou de l'arrière-plan en fonction des conditions que vous définissez.

Vous pouvez définir des seuils de deux manières :
+ Les seuils **absolus** sont définis sur la base d'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 %.

Vous pouvez appliquer des seuils aux visualisations suivantes :
+ [Panneau de jauge à barres](alert-panel-bar-gauge-panel.md) 
+  [Panneau de jauge](gauge-panel.md) 
+  [Panneau graphique](graph-panel.md)
+  [Panneau de démarrage](stat-panel.md)
+  [Panneau de table](table-panel.md)

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

Sur les visualisations qui le prennent en charge, Amazon Managed Grafana définit le seuil par défaut suivant : 80 = rouge ; Base = vert ; Mode = Absolu.

La valeur **de base** représente moins l'infini. C'est généralement la *bonne* couleur.

## Ajouter un seuil
<a name="add-a-threshold"></a>

Vous pouvez ajouter autant de seuils que vous le souhaitez à un panneau. L'espace de travail Grafana trie automatiquement les seuils de la valeur la plus élevée à la valeur la plus faible.

**Note**  
Ces instructions s'appliquent uniquement aux visualisations des statistiques, des jauges, des barres et des tableaux.

1. Choisissez le panneau auquel vous souhaitez ajouter un seuil.

1. Choisissez l'onglet **Champ**.

1. Choisissez **Ajouter un seuil**.

   Amazon Managed Grafana ajoute un seuil avec des valeurs numériques et colorimétriques suggérées. 

1. Acceptez les recommandations ou modifiez le nouveau seuil.
   +  **Modifier la couleur** : choisissez le point de couleur que vous souhaitez modifier, puis sélectionnez une nouvelle couleur.
   +  **Modifier le numéro** — Choisissez le numéro que vous souhaitez modifier, puis saisissez-en un nouveau.
   +  **Mode seuils** : choisissez le mode pour le modifier pour tous les seuils de ce panneau.

1. Choisissez **Enregistrer** pour enregistrer les modifications dans le tableau de bord.

## Ajouter un seuil à un panneau graphique
<a name="add-a-threshold-to-a-graph-panel"></a>

Dans la visualisation du panneau graphique, vous pouvez utiliser des seuils pour ajouter des lignes ou des sections arbitraires au graphique afin de voir plus facilement quand le graphique franchit un seuil donné.

1. Choisissez le panneau graphique auquel vous souhaitez ajouter un seuil.

1. Dans l'onglet **Panneau**, sélectionnez **Seuils**.

1. Choisissez **Ajouter un seuil**.

1. Remplissez autant de champs que vous le souhaitez. Seuls les champs **T1** sont obligatoires.
   +  **T1** — Les deux valeurs sont requises pour afficher un seuil.
     +  **lt** ou **gt** — Sélectionnez **lt** pour inférieur à ou **gt** pour supérieur à pour indiquer à quoi s'applique le seuil.
     +  **Valeur** — Entrez une valeur de seuil. L'espace de travail Grafana trace une ligne de seuil le long de l'axe Y à cette valeur.
   +  **Couleur** : choisissez une condition correspondant à une couleur ou définissez votre propre couleur.
     +  **personnalisé** — Vous définissez la couleur de remplissage et la couleur de la ligne.
     +  **critique** — Les couleurs de remplissage et de ligne sont rouges.
     +  **avertissement** — La couleur du fond et de la ligne est jaune.
     +  **ok** — La couleur du fond et de la ligne est verte.
   +  **Remplissage** — Choisissez si le seuil de remplissage doit être affiché.
   +  **Ligne** — Choisissez si la ligne de seuil est affichée.
   +  **Axe Y** — Choisissez **gauche** ou **droite.**

1. Choisissez **Enregistrer** pour enregistrer les modifications dans le tableau de bord. 

## Supprimer un seuil
<a name="delete-a-threshold"></a>

1. Choisissez le panneau dont vous souhaitez supprimer un seuil.

1. Choisissez l'onglet **Champ**. (Ou, pour un panneau graphique, choisissez l'onglet **Panneau**.)

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

1. Choisissez **Enregistrer** pour enregistrer les modifications dans le tableau de bord. 

# WindRose
<a name="windrose"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Le WindRose panneau reçoit des données de séries chronologiques brutes, convertit les données et les cartographie dans un WindRose graphique.

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/images/windrose.png)


## Options
<a name="windrose-options"></a>

Le WindRose panneau prend en charge les options suivantes :
+ Fréquence de l'axe
+ Style d'axe (degrés ou boussole)
+ Échelle (linéaire, carrée, logarithmique)

# Inspecter un panneau
<a name="inspect-a-panel"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

L'inspecteur de panneaux 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 de l'espace de travail 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. 

## Interface utilisateur de l'inspecteur de panneaux
<a name="panel-inspector-ui"></a>

L'inspecteur du panneau affiche **Inspect : < NameOfPanelBeingInspected >** en haut du volet. Cliquez sur la flèche dans le coin supérieur droit pour agrandir ou réduire le volet.

L'inspecteur du panneau comprend quatre onglets :
+  **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 Amazon Managed Grafana.
+  **Onglet Requête** : affiche les demandes envoyées au serveur lorsqu'Amazon Managed Grafana interroge la source de données.

**Note**  
Les types de panneaux ne comprennent pas tous les quatre 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.

## Tâches des inspecteurs du panel
<a name="panel-inspector-tasks"></a>

Dans l'inspecteur de panneaux, vous pouvez inspecter les panneaux, inspecter et télécharger les résultats de requêtes bruts, inspecter les performances des requêtes, afficher les modèles JSON des panneaux et afficher la demande brute et la réponse à la source de données.

### Ouvrez l'inspecteur du panneau
<a name="open-the-panel-inspector"></a>

Vous pouvez inspecter n'importe quel panneau que vous pouvez visualiser.

1. Dans la console de l'espace de travail Grafana, choisissez le tableau de bord contenant le panneau que vous souhaitez inspecter.

1. Choisissez le titre du panneau que vous souhaitez inspecter, puis sélectionnez **Inspecter**. Ou faites une pause sur le titre du panneau, puis appuyez sur **i.**

Le volet de l'inspecteur du panneau s'ouvre sur le côté droit de l'écran.

### Inspecter les résultats bruts des requêtes
<a name="inspect-raw-query-results"></a>

Affichez les résultats bruts des requêtes dans un tableau. Il s'agit des données renvoyées par la requête avec les transformations appliquées et avant que le panneau n'applique les options de champ ou les remplacements d'options de champ.

1. Ouvrez l'inspecteur du panneau, puis choisissez l'onglet **Données**. Ou dans le menu du panneau, choisissez **Inspecter**, **Données**.

1. 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 même temps, avec un seul résultat par colonne. Choisissez un en-tête de colonne pour réorganiser les données.

  Affichez les résultats bruts des requêtes dans une table avec les options de champ et les remplacements d'options appliqués.

  1. Ouvrez l'onglet **Données** dans l'inspecteur du panneau.

  1. Au-dessus du tableau, choisissez les **options d'affichage des données**.

  1. Cliquez sur le bouton **Appliquer la configuration du champ**.

### Télécharger les résultats bruts des requêtes sous forme de fichier CSV
<a name="download-raw-query-results-as-csv"></a>

Amazon Managed 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. Ouvrez l'inspecteur du panneau.

1. Inspectez les résultats bruts de la requête comme décrit ci-dessus. Ajustez les paramètres jusqu'à ce que les données brutes que vous souhaitez exporter s'affichent.

1. Choisissez **Télécharger le rapport CSV**.

Pour télécharger un fichier CSV formaté pour Excel, développez le panneau **des options de données** et activez l'option **Télécharger pour Excel** avant de choisir **Télécharger le fichier CSV**. 

### Inspectez les performances des requêtes
<a name="inspect-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.

1. Ouvrez l'inspecteur du panneau.

1. Choisissez l'onglet **Stats**.

Les statistiques sont affichées en lecture seule.

### Afficher les modèles JSON du panneau
<a name="view-panel-json-model"></a>

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

1. Ouvrez l'inspecteur du panneau, puis choisissez l'onglet **JSON**. Ou, dans le menu du panneau, choisissez **Inspect**, **Panel JSON**. 

1. Dans **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 le jeu de résultats bruts avec vos transformations, la configuration des champs et les remplacements appliqués.

1. Vous pouvez développer ou réduire des parties du JSON pour l'explorer, ou vous pouvez choisir **Copier dans le presse-papiers** et coller le JSON dans une autre application.

### Afficher la demande brute et la réponse à la source de données
<a name="view-raw-request-and-response-to-data-source"></a>

1. Ouvrez l'inspecteur du panneau, puis choisissez l'onglet **Requête**. Ou, dans le menu du panneau, choisissez **Inspecter**, **Interroger**.

1. Choisissez **Refresh**.

Amazon Managed Grafana envoie une requête au serveur pour collecter des informations, puis 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.

# Liste des calculs
<a name="list-of-calculations"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Cette rubrique répertorie et définit les calculs utilisés dans Amazon Managed Grafana.

Ces calculs sont notamment utilisés 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  | 
|  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  |  Variation de valeur cumulée  | 
|  Différence  |  Différence entre la première et la dernière valeur d'un champ  | 
|  Nombre distinct  |  Nombre de valeurs uniques dans un champ  | 
|  Premier (non nul)  |  Tout d'abord, pas de valeur nulle dans un champ  | 
|  Max  |  Valeur maximale d'un champ  | 
|  Mean  |  Valeur moyenne 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  | 

# Tableaux de bord
<a name="dashboard-overview"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Un *tableau de bord* est un ensemble d'un ou de plusieurs panneaux organisés et disposés en une ou plusieurs rangées. Amazon Managed Grafana est livré avec une variété de panneaux. Amazon Managed Grafana permet de créer facilement les bonnes requêtes et de personnaliser les propriétés d'affichage afin que vous puissiez créer le tableau de bord dont vous avez besoin. Chaque panneau peut interagir avec les données provenant de n'importe quelle source de données configurée. 

## Gérer les tableaux de bord
<a name="manage-dashboards"></a>

 Pour contrôler la période du tableau de bord, vous pouvez utiliser le bouton [Contrôles de plage de temps](dashboard-time-range-controls.md) en haut à droite du tableau de bord. 

 Les tableaux de bord peuvent utiliser des modèles et des variables pour les rendre plus dynamiques et interactifs. Pour de plus amples informations, veuillez consulter [Modèles et variables](templates-and-variables.md). 

 Les tableaux de bord peuvent être utilisés [Annotations](dashboard-annotations.md) pour afficher les données des événements dans tous les panneaux. Cela peut aider à corréler les données des séries chronologiques du panneau avec d'autres événements. 

 Les tableaux de bord peuvent être partagés facilement de différentes manières. Pour de plus amples informations, veuillez consulter [Partage d'un tableau de bord](share-a-dashboard.md). 

 Les tableaux de bord peuvent être balisés, et le sélecteur de tableaux de bord fournit un accès rapide et consultable à tous les tableaux de bord d'une organisation donnée. 

## Lignes
<a name="dashboard-rows"></a>

 Une *ligne* est un séparateur logique dans un tableau de bord. Il est utilisé pour regrouper des panneaux. 

 Les rangées ont toujours une largeur *de 12 unités*. Ces unités sont automatiquement mises à l'échelle en fonction de la résolution horizontale de votre navigateur. Vous pouvez contrôler la largeur relative des panneaux d'une rangée en définissant leur largeur spécifique. 

 Amazon Managed Grafana utilise une abstraction unitaire pour optimiser l'apparence sur toutes les tailles d'écran. 

**Note**  
 Grâce à MaxDataPoint ses fonctionnalités, Amazon Managed Grafana peut afficher le nombre de points de données requis, indépendamment de la résolution ou de la plage de temps. 

 Pour réduire une ligne, choisissez le titre de la ligne. Si vous enregistrez un tableau de bord avec une ligne réduite, le tableau de bord est enregistré dans cet état et ces graphiques ne se chargent que lorsque vous développez la ligne. 

 Utilisez la fonctionnalité des lignes répétées pour créer ou supprimer dynamiquement des rangées entières de panneaux, en fonction des variables de modèle sélectionnées. 

# Annotations
<a name="dashboard-annotations"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Les annotations permettent de marquer des points sur le graphique à l'aide d'événements riches. Lorsque vous faites une pause sur une annotation, vous pouvez voir 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 pour plus de détails. 

## Annotations natives
<a name="native-annotations"></a>

 Amazon Managed Grafana est doté d'un magasin d'annotations natif et de la possibilité d'ajouter des événements d'annotation directement depuis le panneau graphique. 

## Ajouter des annotations
<a name="adding-annotations"></a>

 Pour ajouter une annotation, appuyez sur **Ctrl** ou **Cmd** et choisissez l'endroit où vous souhaitez ajouter l'annotation. Pour que l'annotation soit consultable à partir d'autres tableaux de bord, ajoutez-y des balises. 

### Ajouter des annotations de région
<a name="adding-regions-events"></a>

 Pour créer une annotation pour une région, appuyez sur **Ctrl** ou **Cmd** pendant que vous choisissez la région. 

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

 Une fois que vous avez ajouté une annotation, elle reste visible. Cela est dû au fait qu'une requête d'annotation intégrée existe dans tous les tableaux de bord. Cette requête d'annotation récupère tous les événements d'annotation provenant du tableau de bord actuel et les affiche sur le panneau dans lequel ils ont été créés. Cela inclut les annotations de l'historique de l'état des alertes. Vous pouvez empêcher l'extraction et l'affichage des annotations en choisissant l'icône des **paramètres du tableau de bord** (engrenage), en choisissant **Annotations**, puis en modifiant la requête nommée. `Annotations & Alerts (Built-in)` 

 Lorsque vous copiez un tableau de bord à l'aide de la fonctionnalité **Enregistrer sous**, le nouveau tableau de bord possède un nouvel identifiant de tableau de bord, de sorte que les annotations créées sur le tableau de bord source ne sont pas visibles sur la copie. Si les annotations du tableau de bord source comportent des balises à utiliser pour filtrer, vous pouvez afficher les annotations sur la copie en ajoutant une nouvelle **requête d'annotation** et en filtrant selon les balises. 

### Requête par tag
<a name="annotation-query-by-tag"></a>

 **Vous pouvez créer de nouvelles requêtes d'annotation qui récupèrent les annotations depuis le magasin d'annotations natif en utilisant la source de `-- Grafana --` données et en définissant **Filtrer par balises**.** Spécifiez au moins une balise. Par exemple, créez une requête d'annotation nommée `outages` et spécifiez une balise nommée`outage`. Cette requête affichera toutes les annotations que vous créez (depuis n'importe quel tableau de bord ou via une API) qui ont le `outage` tag.

Par défaut, si vous ajoutez plusieurs balises dans la requête d'annotation, Amazon Managed Grafana n'affichera que les annotations contenant toutes les balises que vous avez fournies. Pour afficher les annotations contenant au moins l'une des balises que vous avez fournies, activez **Match any**. 

 Dans Amazon Managed Grafana, il est possible d'utiliser des variables de modèle dans la requête de balise. Par exemple, si vous disposez d'un tableau de bord affichant les statistiques de différents services et d'une variable de modèle qui contrôle les services à afficher, vous pouvez utiliser la même variable de modèle dans votre requête d'annotation pour n'afficher les annotations que pour ces services. 

## Interrogation d'autres sources de données
<a name="querying-other-data-sources"></a>

 Les événements d'annotation sont récupérés à l'aide de requêtes d'annotation. Pour ajouter une nouvelle requête d'annotation à un tableau de bord, choisissez l'icône des **paramètres du tableau** de bord (engrenage)`Annotations`, puis choisissez **Nouveau**. 

 Spécifiez le nom de la requête d'annotation. Ce nom est affiché par la case à cocher permettant d'afficher ou de masquer les événements d'annotation pour cette requête. Par exemple, vous pouvez avoir deux requêtes d'annotation nommées `Deploys` et`Outages`. Vous pouvez sélectionner ou désactiver les cases à cocher pour spécifier les annotations à afficher. 

### Détails de la requête d'annotation
<a name="annotation-query-details"></a>

 Les options de requête d'annotation sont différentes pour chaque source de données. 
+ [Annotations à l'aide de l'éditeur de requêtes Graphite](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [Annotations à l'aide d'une source OpenSearch de données](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [Annotations à l'aide de Prometheus](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [Annotations à l'aide de MySQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [Annotations à l'aide de PostgreSQL](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# dossiers du tableau de bord
<a name="dashboard-folders"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Les dossiers permettent d'organiser et de regrouper les tableaux de bord. C'est utile si vous avez de nombreux tableaux de bord ou si plusieurs équipes utilisent le même espace de travail Grafana. 

## Création d’un dossier
<a name="how-to-create-a-folder"></a>

Pour créer un dossier, effectuez l'une des opérations suivantes :
+  Dans le menu latéral, sous l'icône \$1, cliquez sur le lien **Créer un dossier**. 
+  Sur la page **Gérer les tableaux** de bord, cliquez sur le bouton **Créer un dossier**. 

 Sur la page **Créer un dossier**, entrez un nom unique pour le dossier, puis choisissez **Créer**. 

Lorsque vous enregistrez un tableau de bord, vous pouvez choisir un dossier existant ou en créer un nouveau.

## Gérer les tableaux de bord
<a name="folders-manage-dashboards"></a>

 Sur la page **Gérer les tableaux** de bord, vous pouvez effectuer diverses tâches : 
+  Créez un dossier. 
+  Créez un tableau de bord. 
+  Déplacez les tableaux de bord dans des dossiers. 
+  Supprimez plusieurs tableaux de bord. 
+  Accédez à une page de dossier (où vous pouvez définir des autorisations pour un dossier ou ses tableaux de bord). 

## Page du dossier du tableau de bord
<a name="dashboard-folder-page"></a>

 Pour ouvrir une page de dossier de tableau de bord, choisissez l'icône en forme de roue dentée qui apparaît lorsque vous faites une pause sur un dossier dans la liste des tableaux de bord dans les résultats de recherche ou sur la page Gérer les tableaux de bord. 

 La page Dossier du tableau de bord est similaire à la page Gérer les tableaux de bord. Sur la page Dossier du tableau de bord, vous pouvez effectuer les tâches suivantes : 
+  Déplacez ou supprimez des tableaux de bord dans un dossier. 
+  Renommez un dossier (dans l'onglet **Paramètres**). 
+  Définissez les autorisations pour le dossier (héritées par les tableaux de bord du dossier). 

## Permissions
<a name="folder-permissions"></a>

 Les autorisations peuvent être attribuées à un dossier et héritées par les tableaux de bord qu'il contient. Une liste de contrôle d'accès (ACL) est utilisée lorsque des autorisations peuvent être attribuées au **rôle de l'organisation**, à l'**équipe** et à **l'utilisateur** individuel. Pour de plus amples informations, veuillez consulter [Autorisations du tableau de bord et des dossiers](dashboard-and-folder-permissions.md). 

# Liste de lecture
<a name="dashboard-playlist"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

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

 Amazon Managed Grafana adapte automatiquement les tableaux de bord à toutes les résolutions, y compris les grands écrans. 

 Vous pouvez accéder à la fonctionnalité **Playlist** depuis le menu latéral, dans le sous-menu **Tableaux** de bord. 

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

 Une playlist présente les tableaux de bord dans une séquence, avec un ordre défini et un intervalle de temps entre les tableaux de bord. 

1.  Pour accéder à la fonction **Playlist**, faites une pause dans le menu latéral. 

1.  Choisissez **Playlists**. 

1.  Choisissez **Nouvelle playlist**. 

1.  Dans la zone de texte **Nom**, saisissez le nom de votre playlist. 

1.  Dans la zone de texte **Intervalle**, entrez un intervalle de temps. 

   L'intervalle de temps est le temps pendant lequel Amazon Managed Grafana reste sur un tableau de bord donné avant de passer au suivant sur la playlist. 

1.  À côté de chaque tableau de bord que vous souhaitez ajouter à votre playlist, choisissez **Ajouter à la playlist**. 

1.  Choisissez **Créer**. 

## Modification d'une playlist
<a name="edit-a-playlist"></a>

 Vous pouvez modifier les playlists lors de leur création ou après les avoir enregistrées. 

1.  Pour accéder à la fonction Playlist, faites une pause dans le menu latéral. 

1.  Choisissez **Playlists**. 

1.  Choisissez la playlist que vous souhaitez modifier. 

### Modifier le nom d'une playlist
<a name="edit-the-name-of-a-playlist"></a>

1. Choisissez la zone **de texte Nom**.

1.  Modifiez le nom. 

1.  Choisissez **Save** pour enregistrer les changements. 

### Modifier l'intervalle d'une playlist
<a name="edit-the-interval-of-a-playlist"></a>

1.  Choisissez la zone **de texte Intervalle**. 

1.  Modifiez l'intervalle. 

1.  Choisissez **Save** pour enregistrer les changements. 

### Ajouter un tableau de bord à une playlist
<a name="add-a-dashboard-to-a-playlist"></a>

1.  À côté du tableau de bord que vous souhaitez ajouter, choisissez **Ajouter à la playlist**. 

1.  Choisissez **Save** pour enregistrer les changements. 

### Recherche d'un tableau de bord à ajouter
<a name="search-for-a-dashboard-to-add"></a>

1. Sous **Ajouter des tableaux de bord**, choisissez la zone de texte **Rechercher des tableaux de bord par nom**. 

1.  Entrez un nom ou une expression régulière. 

1. Si nécessaire, filtrez vos résultats par statut ou tags marqués d'un astérisque. Par défaut, vos tableaux de bord favoris apparaissent sous forme d'options à ajouter à la playlist.

1.  Choisissez **Enregistrer** pour enregistrer vos modifications. 

### Réorganisation de l'ordre du tableau de bord
<a name="rearrange-dashboard-order"></a>

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.  Choisissez **Save** pour enregistrer les changements. 

### Supprimer un tableau de bord
<a name="remove-a-dashboard"></a>

1.  Cliquez sur l'icône X pour supprimer un tableau de bord de la playlist. 

1.  Choisissez **Save** pour enregistrer les changements. 

### Supprimer une playlist
<a name="delete-a-playlist"></a>

1.  Choisissez **Playlists**. 

1.  À côté de la playlist que vous souhaitez supprimer, cliquez sur l'icône X. 

## Sauvegarde d'une playlist
<a name="save-a-playlist"></a>

 Vous pouvez enregistrer une playlist pour l'ajouter à votre page **Playlists**, où vous pouvez la démarrer. Assurez-vous d'ajouter tous les tableaux de bord que vous souhaitez voir apparaître dans votre playlist avant de l'enregistrer. 

1.  Pour accéder à la fonction **Playlist**, faites une pause dans le menu latéral. 

1.  Choisissez **Playlists**. 

1.  Choisissez la playlist. 

1.  Modifiez la playlist. 

   Assurez-vous qu'un **nom**, un **intervalle** et au moins un **tableau de bord** ont été ajoutés à votre playlist. 

1.  Choisissez **Enregistrer**. 

## Lancer une playlist
<a name="start-a-playlist"></a>

 Vous pouvez démarrer une playlist dans cinq modes d'affichage différents. Le mode 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**, qui peut être défini lors de la création ou de la modification d'une playlist. Après avoir lancé une playlist, vous pouvez la contrôler à l'aide de la barre de navigation en haut de votre écran. 

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

1.  À côté de la liste de lecture que vous souhaitez démarrer, choisissez **Démarrer la liste de lecture**. 

1.  Dans la liste déroulante, choisissez l'un des modes d'affichage suivants : 
   +  **Mode normal** 
     +  Le menu latéral reste visible. 
     +  Les commandes de la barre de navigation, des lignes et des panneaux apparaissent en haut de l'écran. 
   +  **Mode TV** 
     +  Le menu latéral est masqué ou supprimé. 
     +  Les commandes de la barre de navigation, des lignes et des panneaux apparaissent en haut de l'écran. 
     +  Le mode TV est activé automatiquement après 1 minute d'inactivité de l'utilisateur. 
     +  Vous pouvez activer le mode TV manuellement en utilisant le raccourci de séquence **d v** ou en ajoutant le paramètre `?inactive` à l'URL du tableau de bord. 
     +  Vous pouvez désactiver le mode TV par n'importe quel mouvement de la souris ou du clavier. 
   +  **Mode TV (avec panneaux à ajustement automatique)** 
     +  Le menu latéral est masqué ou supprimé. 
     +  Les commandes de la barre de navigation, des lignes et des panneaux apparaissent en haut de l'écran. 
     +  Les panneaux du tableau de bord s'ajustent automatiquement pour optimiser l'espace à l'écran. 
   +  **Mode kiosque** 
     +  Les commandes du menu latéral, de la barre de navigation, des lignes et du panneau sont complètement masquées ou supprimées de la vue. 
     +  Vous pouvez activer le mode kiosque manuellement en utilisant le raccourci de séquence **d v** une fois la playlist lancée. 
     +  Vous pouvez désactiver le mode kiosque manuellement en utilisant le même raccourci. 
   +  **Mode kiosque (avec panneaux à ajustement automatique) :** 
     +  Les commandes du menu latéral, de la barre de navigation, des lignes et du panneau sont complètement masquées ou supprimées de la vue. 
     +  Les panneaux du tableau de bord s'ajustent automatiquement pour optimiser l'espace à l'écran. 

## Contrôler une playlist
<a name="control-a-playlist"></a>

 Vous pouvez contrôler une playlist en mode **Normal** ou **TV** après son lancement en utilisant la barre de navigation en haut de votre écran. 


|  Button  |  Résultat  | 
| --- | --- | 
|  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é)  |  Met fin à la playlist et passe au tableau de bord actuel.  | 
|  Mode d'affichage du cycle (icône du moniteur)  |  Modifie l'affichage des tableaux de bord en 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 déroulante.  | 
|  Rafraîchir (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.  | 

 Pour arrêter la playlist depuis votre clavier, appuyez sur **Esc**.

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

Vous pouvez partager une playlist en copiant l'URL dans le mode d'affichage souhaité et en collant l'URL vers votre destination.

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

1.  À côté de la liste de lecture que vous souhaitez partager, choisissez **Démarrer la liste de lecture**, puis choisissez le mode d'affichage souhaité. 

1.  Pour copier l'URL dans votre presse-papiers, choisissez **Copier l'adresse du lien**. 

    Par exemple, l'URL d'une playlist sur le site Grafana Play en mode kiosque peut être `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk` 

1.  Collez l'URL vers votre destination. 

# Recherche par tableau de bord
<a name="dashboard-search"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Les tableaux de bord peuvent être recherchés par le nom du tableau de bord, filtrés par une (ou plusieurs) balises ou filtrés par statut marqué d'un astérisque. La recherche dans le tableau de bord est accessible via le sélecteur de tableau de bord, disponible dans la barre de navigation supérieure du tableau de bord. La recherche dans le tableau de bord peut également être ouverte à l'aide du raccourci **F.** 

Lorsque vous utilisez uniquement un clavier, vous pouvez utiliser les flèches du clavier pour parcourir les résultats et appuyer sur **Entrée** pour ouvrir le tableau de bord de votre choix. 

## Recherche par nom de tableau de bord
<a name="find-by-dashboard-name"></a>

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

La recherche dans le tableau de bord est la suivante :
+ En temps réel
+ Ne distingue pas les majuscules
+  Fonctionnel sur les tableaux de bord stockés et basés sur des fichiers

## Filtrage par balise
<a name="filter-by-tags"></a>

 Les balises constituent un moyen utile d'organiser vos tableaux de bord, en particulier lorsque le nombre de tableaux de bord augmente. Les tags peuvent être ajoutés et gérés dans les **paramètres** du tableau de bord. 

 Pour filtrer la liste du tableau de bord par tag, choisissez n'importe quel tag qui apparaît dans la colonne de droite. Vous pouvez filtrer davantage la liste en choisissant des balises supplémentaires. 

Pour voir la liste de tous les tags disponibles, choisissez le menu déroulant **Filtrer par tags**. Lorsque vous sélectionnez un tag, la recherche dans le tableau de bord est instantanément filtrée. 

Lorsque vous utilisez uniquement un clavier, appuyez sur la touche **Tab** pour vous concentrer sur le lien des balises, appuyez sur la flèche vers le bas pour rechercher une balise, puis appuyez sur **Entrée** pour sélectionner la balise. 

**Note**  
 Lorsque plusieurs balises sont sélectionnées, Amazon Managed Grafana affiche des tableaux de bord qui incluent toutes les balises. 

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

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Pour partager un tableau de bord, choisissez **Partager le tableau de bord** (l'icône de partage) dans la barre de navigation supérieure. Cela ouvre la boîte de dialogue **Partager**, dans laquelle vous pouvez obtenir un lien vers le tableau de bord actuel avec la plage de temps sélectionnée et les variables du modèle actuellement sélectionnées. Si vous avez apporté des modifications au tableau de bord, veillez à enregistrer ces modifications avant de copier le lien. 

## Aperçu du tableau de bord
<a name="dashboard-snapshot"></a>

 Un instantané de tableau de bord est un moyen instantané de partager publiquement un tableau de bord interactif. Lors de la création de l'instantané, Amazon Managed Grafana supprime les données sensibles telles que les requêtes (métrique, modèle et annotation) et les liens des panneaux, ne laissant que les données métriques visibles et les noms de séries intégrés dans votre tableau de bord. Les instantanés du tableau de bord sont accessibles à toute personne disposant du lien et pouvant accéder à l'URL. 

## Publier des instantanés
<a name="publish-snapshots"></a>

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

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

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Choisissez un titre de panneau pour ouvrir le menu du panneau, puis choisissez **Partager** dans le menu du panneau pour ouvrir la boîte de dialogue **Partager le panneau**. Vous pouvez copier le lien, qui vous mènera exactement à ce panneau avec la plage de temps actuelle et les variables de modèle sélectionnées. 

# Contrôles de plage de temps
<a name="dashboard-time-range-controls"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Amazon Managed Grafana propose plusieurs méthodes pour gérer les plages temporelles des données visualisées, à la fois au niveau du tableau de bord et au niveau du panneau. 

 Cette rubrique 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. 

**Note**  
Pour pouvoir contrôler le temps, vos données doivent inclure une colonne de temps. 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.

## Unités de temps et plages relatives
<a name="time-units-and-relative-ranges"></a>

 Les unités de temps suivantes sont prises en charge : 
+ `s`(secondes)
+ `m`(minutes)
+ `h`(heures),
+ `d`(jours)
+ `w`(semaines)
+ `M`(mois)
+ `y`(années)

 Utilisez l'opérateur moins pour revenir en arrière par rapport au présent. Pour afficher la période complète de l'unité (jour, semaine ou mois, par exemple), ajoutez. `/<time unit>` 

 Utilisez l'opérateur plus pour avancer dans le temps par rapport au présent. Vous pouvez utiliser cette fonctionnalité pour consulter les données prédites pour le futur. 

 Voici quelques exemples : 


|  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  | 
|  Depuis le début de la semaine  |  now/w  |  now  | 
|  Mois précédent  |  now-1M/M  |  now-1M/M  | 

## Contrôles de plage de temps courants
<a name="common-time-range-controls"></a>

 Les commandes horaires du tableau de bord et du panneau disposent d'une interface utilisateur commune, avec les options suivantes. 

### Plage horaire actuelle
<a name="current-time-range"></a>

 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. 

 Faites une pause sur un champ pour voir les horodatages exacts de la plage et leur source, par exemple le navigateur local. 

 Pour modifier l'intervalle de temps, choisissez l'intervalle de temps actuel. 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 to 2020-05-15 23:59:59`. 

### Plage de temps relative
<a name="relative-time-range"></a>

 Sélectionnez la plage de temps **relative dans la liste Plages de temps relatifs**. Voici quelques exemples de plages temporelles relatives : 
+  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 
+  Jusqu'à présent cette semaine 
+  Ce mois-ci, jusqu'à présent 

### Plage de temps absolue
<a name="absolute-time-range"></a>

 Définissez une plage de temps absolue de deux manières : 
+  Entrez des valeurs dans les champs **From** **et To**. Vous pouvez entrer des valeurs temporelles exactes ou des valeurs relatives, telles que`now-24h`, puis choisir **Appliquer la plage de temps**. 
+  Choisissez le champ **De** ou **À**. Amazon Managed Grafana affiche un calendrier. Choisissez le ou les jours que vous souhaitez utiliser comme plage horaire actuelle, puis choisissez **Appliquer la plage horaire**. 

 Amazon Managed Grafana affiche également les plages absolues récemment utilisées. 

### Zoom arrière (Cmd\$1Z ou Ctrl\$1Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 Pour afficher une plage de temps plus étendue dans la visualisation du tableau de bord ou du panneau, cliquez sur l'icône de **zoom arrière sur la plage de temps**. 

### Zoomer (pour les visualisations graphiques uniquement)
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 Dans la visualisation du graphique, faites glisser le pointeur pour sélectionner la plage de temps que vous souhaitez afficher. 

### Actualiser le tableau de
<a name="refresh-dashboard"></a>

 Cliquez sur l'icône **Actualiser le tableau de bord** pour exécuter immédiatement toutes les requêtes du tableau de bord et actualiser les visualisations. Amazon Managed Grafana annule toutes les demandes en attente lorsqu'une nouvelle actualisation est lancée. 

 Par défaut, Amazon Managed 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. 

## Paramètres horaires du tableau de bord
<a name="dashboard-time-settings"></a>

 Les paramètres horaires sont enregistrés pour chaque tableau de bord. 

 Pour accéder aux paramètres horaires du tableau de bord, choisissez l'icône des **paramètres du tableau** de bord (engrenage) en haut de l'écran. Les paramètres se trouvent dans la section **Options temporelles** de l'onglet **Général**. 
+  **Fuseau horaire** : fuseau horaire local du service ou du système que vous surveillez. Cela peut être utile lorsque vous surveillez un système ou un service qui fonctionne sur plusieurs fuseaux horaires. 
  +  **Par défaut** : 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, une équipe dont l'utilisateur est membre ou l'organisation Amazon Managed Grafana utilise l'heure locale du navigateur. 
  +  **Heure du navigateur** Fuseau horaire configuré pour le navigateur utilisé. Il s'agit généralement du fuseau horaire défini sur l'ordinateur. 
  +  **Temps universel coordonné — Fuseaux** horaires conformes à la norme ISO 8601, y compris UTC. Pour plus d'informations, consultez [la liste des fuseaux horaires](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). 
+  **Actualisation automatique** : options personnalisables, temps relatif et paramètres d'actualisation automatique. Les entrées sont séparées par des virgules et peuvent être n'importe quelle unité de temps valide. 
+  **Now delay now-** — Valeur de temporisation qui remplace la `now` valeur. Le plus souvent, cette fonctionnalité est utilisée pour éviter les valeurs nulles en tenant compte des délais connus dans l'agrégation des données. 
+  **Masquer le sélecteur de temps** : option permettant de ne pas afficher le sélecteur de temps. 

## Dérogations temporelles et décalage horaire
<a name="panel-time-overrides-and-timeshift"></a>

 Dans[Options de requête](panel-queries.md#query-options), vous pouvez modifier la plage de temps relative pour les différents panneaux, les rendant ainsi différents de ceux sélectionnés dans le sélecteur de temps du tableau de bord situé dans la barre de navigation supérieure. Vous pouvez afficher les statistiques de différentes périodes ou de différents jours en même temps. 

## Contrôle de l'intervalle de temps à l'aide d'une URL
<a name="control-the-time-range-using-a-url"></a>

 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 l'intervalle de temps, spécifiée en ms d'époque ou en temps relatif. Pour de plus amples informations, veuillez consulter [Plage de temps relative](#relative-time-range). 
+  `to`— Définit la limite supérieure de la plage de temps, spécifiée en ms d'époque ou en temps relatif. Pour de plus amples informations, veuillez consulter [Plage de temps relative](#relative-time-range). 
+  `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 millisecondes. Par exemple, cela `?time=1500000000000&time.window=10000` donne une plage de temps de 10 secondes comprise entre 1499999995000 et 1500000005000 

# Exportation et importation de tableaux de bord
<a name="dashboard-export-and-import"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Les tableaux de bord Amazon Managed Grafana peuvent être facilement exportés et importés, soit depuis l'interface utilisateur, soit depuis l' [API HTTP] 

## Exporter un tableau de bord
<a name="exporting-a-dashboard"></a>

 Les tableaux de bord sont exportés au format Amazon Managed Grafana JSON et contiennent tout ce dont vous avez besoin, notamment la mise en page, les variables, les styles, les sources de données et les requêtes, pour importer le tableau de bord ultérieurement. 

 La fonctionnalité d'exportation est accessible dans la fenêtre de partage, que vous pouvez ouvrir en cliquant sur le bouton de partage dans le menu du tableau de bord.

### Rendre un tableau de bord portable
<a name="making-a-dashboard-portable"></a>

 Lorsque vous exportez un tableau de bord pour que d'autres utilisateurs puissent l'utiliser, il est conseillé d'ajouter des variables de modèle pour des valeurs telles qu'un préfixe métrique (utilisez une variable constante) et un nom de serveur. 

 Une variable de modèle de ce type `Constant` est automatiquement masquée dans le tableau de bord. Il est également ajouté en tant qu'entrée obligatoire lors de l'importation du tableau de bord. Pour plus d'informations sur la création de modèles et les variables de modèle, consultez[Modèles et variables](templates-and-variables.md). 

## Importation d'un tableau de bord
<a name="importing-a-dashboard"></a>

 Pour importer un tableau de bord, cliquez sur l'icône \$1 dans le menu latéral, puis sur **Importer**. 

 Vous pouvez télécharger un fichier JSON de tableau de bord, coller une URL de tableau de bord ou coller le texte JSON du tableau de bord directement dans la zone de texte. 

 À l'étape 2 du processus d'importation, vous pouvez modifier le nom du tableau de bord, spécifier la source de données que vous souhaitez que le tableau de bord utilise et spécifier les préfixes de mesure (si le tableau de bord en utilise un). 

## Découvrez les tableaux de bord sur Grafana.com
<a name="discover-dashboards-on-grafana.com"></a>

 Trouvez des tableaux de bord pour les applications serveur courantes sur [Grafana.com/Dashboards](https://grafana.com/dashboards). 

# Historique des versions du tableau de bord
<a name="dashboard-version-history"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 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 choisissant **Paramètres du tableau de bord**, puis en sélectionnant **Versions** dans le menu de gauche. 

 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
<a name="comparing-two-dashboard-versions"></a>

 Pour comparer deux versions de tableau de bord, sélectionnez les deux versions dans la liste que vous souhaitez comparer. Après avoir sélectionné deux versions, choisissez **Comparer les versions** pour ouvrir la vue des différences. Par défaut, vous verrez un résumé textuel des modifications, comme dans l'image suivante.

 Pour afficher le diff du code JSON brut qui représente votre tableau de bord, choisissez **View JSON Diff**. 

 Pour restaurer la version précédente à laquelle vous comparez, choisissez **Restaurer à la version**<x>.

## Restauration vers une version de tableau de bord précédemment enregistrée
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

 Si vous devez restaurer une version du tableau de bord précédemment enregistrée, vous pouvez le faire soit en cliquant sur le bouton « Restaurer » à droite d'une ligne de la liste des versions du tableau de bord, soit en choisissant **Restaurer à la version** <x>qui apparaît dans la vue des différences. Une fois que vous avez choisi de restaurer, une fenêtre contextuelle vous invite à confirmer la restauration. 

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

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

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Amazon Managed Grafana propose un certain nombre de raccourcis clavier. Pour afficher tous les raccourcis clavier disponibles dans votre version d'Amazon Managed Grafana, appuyez sur **Shift \$1 ?** sur votre clavier. 

 **Amazon Managed Grafana inclut les raccourcis populaires suivants :** 
+  **Ctrl\$1S** enregistre le tableau de bord actuel. 
+  **Ctrl\$1F** ouvre le moteur de recherche ou de recherche du tableau de bord. 
+  **Ctrl\$1H** masque toutes les commandes (le masquage des commandes fonctionne bien pour les écrans de télévision). 
+  **Escape** quitte un graphique en mode plein écran ou en mode édition. 

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

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Dans Amazon Managed Grafana, un tableau de bord 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.  Ouvrez un tableau de bord. 

1.  Dans la barre de navigation supérieure, choisissez **Gérer le tableau de bord**. 

1.  Sélectionnez **Afficher le JSON** dans le menu déroulant. 

## Champs JSON
<a name="dashboard-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é. Après avoir enregistré un tableau de bord, une valeur entière est attribuée au `id` champ. 

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "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": []
}
```

 Le tableau suivant fournit les détails d'utilisation pour chaque champ du tableau de bord JSON. 


|  Name  |  Usage  | 
| --- | --- | 
|  id  |  Identifiant numérique unique du tableau de bord (généré par la base de données).  | 
|  uid  |  L'identifiant unique du tableau de bord qui peut être généré par n'importe qui. uidIl s'agit d'une chaîne de 8 à 40 caractères.  | 
|  title  |  Titre actuel du tableau de bord.  | 
|  tags  |  Les balises associées au tableau de bord. Dans le JSON, les balises sont un tableau de chaînes.  | 
|  style  |  Le thème du tableau de bord (par exemple, dark oulight).  | 
|  timezone  |  Fuseau horaire du tableau de bord (utcoubrowser).  | 
|  editable  |  Si un tableau de bord peut être modifié.  | 
|  graphTooltip  |  Le style de l'infobulle. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  La plage horaire du tableau de bord (par exemple, les 6 dernières heures, les 7 derniers jours).  | 
|  timepicker  |  Les métadonnées du timepicker. Pour de plus amples informations, veuillez consulter [Sélecteur de temps](#dashboard-json-timepicker).  | 
|  templating  |  Les métadonnées de modélisation. Pour de plus amples informations, veuillez consulter [Modèles et variables](templates-and-variables.md).  | 
|  annotations  |  Les métadonnées des annotations. Pour de plus amples informations, veuillez consulter [Annotations](dashboard-annotations.md).  | 
|  refresh  |  Intervalle d'actualisation automatique.  | 
|  schemaVersion  |  Version du schéma JSON (entier), qui est incrémentée chaque fois qu'une mise à jour d'Amazon Managed Grafana modifie le schéma.  | 
|  version  |  Version du tableau de bord (entier), qui est incrémentée chaque fois que le tableau de bord est mis à jour.  | 
|  panels  |  La gamme de panneaux. Pour de plus amples informations, veuillez consulter [Panneaux](#dashboard-JSON-panels).  | 

## Panneaux
<a name="dashboard-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 et d'autres données. 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. L'exemple suivant montre le 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
<a name="panel-size-and-position"></a>

 La `gridPos` propriété décrit la taille et la position du panneau en coordonnées de la grille : 
+  `w`— 1 à 24 ans. La largeur du tableau de bord est divisée en 24 colonnes. 
+  `h`— En unités de hauteur de grille. Chaque unité de hauteur de grille représente 30 pixels. 
+  `x`— La position X. La position x utilise la même unité de colonne que`w`. 
+  `y`— La position y. La position y utilise la même unité de hauteur de grille 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. 

### Sélecteur de temps
<a name="dashboard-json-timepicker"></a>

L'exemple suivant montre les `timepicker` options.

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

 Le tableau suivant fournit des informations sur l'utilisation de`timepicker`. 


|  Name  |  Usage  | 
| --- | --- | 
|  collapse  |  S'il timepicker est effondré  | 
|  enable  |  Si elle timepicker est activée  | 
|  notice  |  Liste de tâches  | 
|  now  |  Liste de tâches  | 
|  refresh\$1intervals  |  Liste de tâches  | 
|  status  |  Liste de tâches  | 
|  type  |  Liste de tâches  | 

### Création de modèles
<a name="json-templating"></a>

 Le `templating` champ contient un tableau de variables de modèle avec leurs valeurs enregistrées et d'autres métadonnées. L'exemple suivant montre `templating` les 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 fournit les détails d'utilisation de la section de création de modèles. 


|  Name  |  Usage  | 
| --- | --- | 
|  activer  |  Si la création de modèles est activée.  | 
|  liste  |  Un tableau d'objets, chacun représentant une variable de modèle  | 
|  Tous les formats  |  Format à utiliser lors de l'extraction de toutes les valeurs de la source de données (par exemplewildcard,, globregex, etpipe).  | 
|  actuel  |  Affiche le texte ou la valeur de la variable actuellement sélectionnée sur le tableau de bord  | 
|  source de données  |  Affiche la source de données pour les variables  | 
|  Tout inclure  |  Si l'option « toutes les valeurs » est disponible  | 
|  multi  |  Si plusieurs valeurs peuvent être sélectionnées dans la liste des valeurs variables  | 
|  Multiformat  |  Le format à utiliser lors de la récupération des séries temporelles à partir de la source de données  | 
|  nom  |  Le nom d'une variable  | 
|  options  |  Le tableau de text/value paires de variables disponibles pour la sélection sur le tableau de bord  | 
|  query  |  La requête de source de données utilisée pour récupérer les valeurs d'une variable  | 
|  rafraîchir  |  Liste de tâches  | 
|  regex  |  Liste de tâches  | 
|  type  |  Le type de variable (customquery, ouinterval)  | 

# Tableaux de bord scriptés
<a name="scripted-dashboards"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

**Avertissement**  
 Cette fonctionnalité est obsolète et sera supprimée dans une future version. 

 Si de nombreux noms de métriques changent (par exemple, de nouveaux serveurs) selon un schéma défini, la création constante de nouveaux tableaux de bord peut prendre beaucoup de temps. 

 Avec les tableaux de bord scriptés, vous pouvez créer dynamiquement vos tableaux de bord à l'aide de. JavaScript Dans le dossier d'installation de Grafana, en dessous`public/dashboards/`, se trouve un fichier nommé. `scripted.js` Ce fichier contient un exemple de tableau de bord scripté. Vous pouvez y accéder en utilisant l'URL : `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName` 

 Lorsque vous l'ouvrez`scripted.js`, vous pouvez voir comment il lit les paramètres d'URL à partir de la `ARGS` variable, puis comment il ajoute des lignes et des panneaux. 

## Exemple : scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## Exemples supplémentaires
<a name="more-examples"></a>

 Vous trouverez d'autres exemples dans le `public/dashboards/` répertoire de votre installation de Grafana. 

# Explorez
<a name="explore"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Dans un espace de travail Grafana, l'interface utilisateur du tableau de bord fournit des outils permettant de créer des tableaux de bord à des fins de visualisation. *Explore* supprime toutes les options du tableau de bord et du panneau afin que vous puissiez vous concentrer sur la requête. Effectuez une itération jusqu'à obtenir une requête fonctionnelle, puis planifiez et créez un tableau de bord. 

 Pour la surveillance de l'infrastructure et la réponse aux incidents, vous n'avez plus besoin de passer à d'autres outils pour corriger les problèmes. Vous pouvez utiliser Explore pour approfondir vos statistiques et vos journaux afin d'en trouver la cause.

 Explore facilite l'affichage de vos données sans créer de tableau de bord. 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 d'obtenir plus de détails en même temps. 

## Commencez à explorer
<a name="start-exploring"></a>

**Note**  
 Par défaut, les utilisateurs dotés du rôle Viewer ne peuvent pas modifier et n'ont pas accès à Explore. 

 L'icône **Explorer** dans le menu de gauche ouvre un onglet Explore vide. 

 Pour commencer avec une requête existante dans un panneau, choisissez l'option **Explorer** dans le menu **Panneau**. Cela ouvre un onglet Explore qui contient la requête du panneau. Vous pouvez ensuite modifier ou itérer la requête en dehors de votre tableau de bord. 

 Choisissez votre source de données dans la liste déroulante en haut à gauche. Prometheus dispose d'une implémentation Explore personnalisée. Les autres sources de données utilisent leur éditeur de requêtes standard. 

 Dans le champ de requête, vous pouvez écrire votre requête et explorer vos données. Trois boutons se trouvent à côté du champ de requête : un bouton effacer (X), un bouton d'ajout de requête (\$1) et un bouton de suppression de requête (-). Comme dans l'éditeur de requêtes du panneau, vous pouvez ajouter et supprimer plusieurs requêtes. 

## Diviser et comparer
<a name="split-and-compare"></a>

 La fonction d'affichage partagé permet de comparer des graphiques et des tableaux side-by-side ou d'examiner les données associées ensemble sur une seule page. Choisissez **Split** pour dupliquer la requête en cours et diviser la page en deux side-by-side requêtes. Vous avez la possibilité de sélectionner une autre source de données pour la nouvelle requête. Cela vous permet de comparer la même requête pour deux serveurs différents ou de comparer l'environnement de préparation à l'environnement de production. 

 En mode partagé, les sélecteurs temporels des deux panneaux peuvent être liés (si vous modifiez l'un, l'autre sera également modifié) en choisissant l'un des boutons de synchronisation horaire attachés aux sélecteurs de temps. L'association des sélecteurs temporels permet de synchroniser les heures de début et de fin des requêtes de vue fractionnée, de sorte que vous puissiez consulter le même intervalle de temps dans les deux panneaux divisés. 

 Vous pouvez fermer la requête nouvellement créée en choisissant **Fermer le partage**.

## Partage d'un lien raccourci
<a name="share-shortened-link"></a>

 Utilisez la fonctionnalité **Partager des liens raccourcis** pour créer des formats plus petits et plus simples URLs `/goto/:uid` au lieu de partager des liens plus longs URLs contenant des paramètres de requête complexes. Vous pouvez créer un lien raccourci en choisissant l'option **Partager** dans la barre d'outils Explore. Tous les liens abrégés qui ne sont jamais utilisés sont automatiquement supprimés au bout de 7 jours. 

## Historique des requêtes
<a name="query-history"></a>

 L'historique des requêtes est une liste des requêtes que vous avez utilisées dans Explore. L'historique est local à votre navigateur et n'est pas partagé. Pour ouvrir votre historique et interagir avec celui-ci, choisissez **Historique des requêtes** dans Explore. 

### Afficher l'historique des requêtes
<a name="view-query-history"></a>

 FIn dans l'historique des requêtes, vous pouvez effectuer les opérations suivantes : 
+  Exécuter une requête. 
+  Créez ou modifiez un commentaire. 
+  Copiez une requête dans le presse-papiers. 
+  Copiez un lien abrégé contenant la requête dans le presse-papiers. 
+  Lancez une requête. 

### Gestion des requêtes favorites
<a name="manage-favorite-queries"></a>

 Toutes les requêtes qui ont été marquées dans l'onglet Historique des requêtes sont affichées dans l'onglet Marqué. Vous pouvez accéder plus rapidement à vos requêtes préférées et les réutiliser sans les retaper depuis. 

### Trier l'historique des requêtes
<a name="sort-query-history"></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. 

Sur le côté droit de l'historique des requêtes, dans la liste déroulante, choisissez l'une des options suivantes : champ.
+  Le plus récent en premier 
+  Le plus vieux d'abord 
+  Source de données de A à Z 
+  Source de données Z-A 

**Note**  
 Si vous êtes en mode affichage partagé, le mode de tri s'applique uniquement au panneau actif. 

### Filtrer l'historique des requêtes
<a name="filter-query-history"></a>

 Dans les onglets **Historique des requêtes** et **Favoris**, vous pouvez filtrer l'historique des requêtes par nom de source de données. 

1. Choisissez **Filtrer les requêtes pour des sources de données spécifiques**.

1. Sélectionnez la source de données que vous souhaitez utiliser pour filtrer votre historique. Vous pouvez sélectionner plusieurs sources de données.

Dans l'onglet **Historique des requêtes**, vous pouvez utiliser le curseur vertical pour filtrer les requêtes par date :
+ Faites glisser la poignée inférieure pour ajuster la date de début.
+ Faites glisser la poignée supérieure pour ajuster la date de fin. 

**Note**  
Si vous êtes en mode affichage partagé, les filtres ne sont appliqués qu'au panneau actif. 

### Recherche dans l'historique des requêtes
<a name="search-in-query-history"></a>

 Vous pouvez effectuer des recherches dans votre historique parmi les requêtes et les commentaires. La recherche est possible pour les requêtes dans les onglets **Historique des requêtes** **et Favoris**. 

1.  Choisissez le champ **Requêtes de recherche**. 

1.  Dans le champ de recherche, saisissez votre terme de recherche. 

### Paramètres de l'historique des requêtes
<a name="query-history-settings"></a>

 Vous pouvez personnaliser l'historique des requêtes dans l'onglet **Paramètres**. Le tableau suivant répertorie les options disponibles. 


|  Paramètre  |  Valeur par défaut  | 
| --- | --- | 
|  Spécifiez la durée pendant laquelle Grafana enregistrera l'historique de vos requêtes.  |  1 semaine  | 
|  Modifiez l'onglet actif par défaut. |  Onglet Historique des requêtes  | 
|  Afficher les requêtes uniquement pour la source de données actuellement active dans Explore.  |  True  | 
|  Efface l'historique des requêtes.  |  (Choisissez Effacer l'historique des requêtes pour supprimer définitivement toutes les requêtes enregistrées.)  | 

**Note**  
Les paramètres de l'historique des requêtes sont globaux et ils sont appliqués aux deux panneaux en mode partagé.

## Caractéristiques spécifiques à Prometheus
<a name="prometheus-specific-features"></a>

 La première version d'Explore propose une expérience de requête personnalisée pour Prometheus. Lorsque vous exécutez une requête, Grafana exécute en fait deux requêtes : une requête Prometheus normale pour le graphique et une requête instantanée pour la table. Une requête instantanée renvoie la dernière valeur pour chaque série chronologique, qui présente un bon résumé des données affichées dans le graphique. 

### Explorateur de métriques
<a name="metrics-explorer"></a>

 Sur le côté gauche du champ de requête, choisissez **Metrics** pour ouvrir l'explorateur de métriques. Cela montre un menu hiérarchique avec des métriques groupées par leur préfixe. Par exemple, toutes les métriques d'Alertmanager sont regroupées sous le `alertmanager` préfixe. Il s'agit d'un bon point de départ pour explorer les indicateurs disponibles. 

### Champ de requête
<a name="query-field"></a>

 Le champ Query prend en charge la saisie automatique des noms et des fonctions des métriques et fonctionne essentiellement de la même manière que l'éditeur de requêtes Prometheus standard. Appuyez sur **Entrée** pour exécuter une requête. 

 Le menu Autocomplete est accessible en appuyant sur **Ctrl\$1Espace**. Le menu Autocomplete contient une nouvelle section Historique avec une liste des requêtes récemment exécutées. 

 Des suggestions peuvent apparaître sous le champ Requête. Choisissez une suggestion pour mettre à jour votre requête avec la modification suggérée. 
+  Pour les compteurs (métriques augmentant de façon monotone), une fonction de débit est suggérée. 
+  Pour les buckets, une fonction d'histogramme est suggérée. 
+  Pour les règles d'enregistrement, il est possible d'étendre les règles.

### Filtres de table
<a name="table-filters"></a>

 Cliquez sur le bouton **Filtrer** dans la colonne d'**étiquette** d'un panneau de tableau pour ajouter des filtres à l'expression de requête. Vous pouvez également ajouter des filtres pour plusieurs requêtes. Le filtre est ajouté pour toutes les requêtes. 

## Intégration des journaux
<a name="logs-integration"></a>

 Vous pouvez également utiliser Explore pour examiner vos journaux à l'aide des sources de données suivantes : 
+  InfluxDB 
+  Elasticsearch 

### Visualisation des journaux
<a name="logs-visualization"></a>

 Les résultats des requêtes de journal sont présentés sous forme d'histogrammes dans le graphique, et les journaux individuels sont affichés ci-dessous. Si la source de données n'envoie pas de données d'histogramme pour la plage de temps demandée, le modèle de journaux calcule une série chronologique en fonction du nombre de lignes de journal regroupées par intervalles de temps calculés automatiquement. Le début de l'histogramme est ensuite ancré par l'horodatage de la première ligne du journal à partir du résultat. La fin de la série chronologique est ancrée dans la plage To du sélecteur **de** temps. 

#### Niveau du journal
<a name="log-level"></a>

 Pour les journaux où une étiquette de **niveau** est spécifiée, Grafana utilise la valeur de l'étiquette pour déterminer le niveau de journalisation et mettre à jour la couleur en conséquence. Si aucune étiquette de niveau n'est spécifiée pour le journal, Grafana analyse le journal pour savoir si son contenu correspond à l'une des expressions prises en charge. 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 le niveau de journalisation **inconnu**. Le tableau suivant répertorie les niveaux de journalisation et le mappage des abréviations et expressions des niveaux de journalisation. 


|  Expressions prises en charge  |  Niveau du journal  |  Couleur  | 
| --- | --- | --- | 
|  émerger  |  critique  |  pourpre  | 
|  fatal  |  critique  |  pourpre  | 
|  alerte  |  critique  |  pourpre  | 
|  critique  |  critique  |  pourpre  | 
|  critique  |  critique  |  pourpre  | 
|  err  |  error  |  red  | 
|  erreur  |  error  |  red  | 
|  error  |  error  |  red  | 
|  prévenir  |  warning  |  yellow  | 
|  warning  |  warning  |  yellow  | 
|  info  |  info  |  green  | 
|  Informations  |  info  |  green  | 
|  remarquer  |  info  |  green  | 
|  dbug  |  debug  |  blue  | 
|  debug  |  debug  |  blue  | 
|  trace  |  trace  |  bleu clair  | 
|  \$1  |  inconnu  |  gris  | 

### Options de visualisation
<a name="visualization-options"></a>

 Vous pouvez personnaliser le mode d'affichage des journaux et sélectionner les colonnes à afficher. 

#### Heure
<a name="visualization-options-time"></a>

 Cette option 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
<a name="visualization-options-unique-labels"></a>

 Cette option affiche ou masque la colonne des étiquettes uniques, qui inclut uniquement les étiquettes non courantes. Toutes les étiquettes courantes sont affichées ci-dessus.

#### Lignes d'emballage
<a name="visualization-options-wrap-lines"></a>

 Pour utiliser l'habillage des lignes à l'écran, définissez ce paramètre sur **True**. La définition de cette option sur **False** entraîne un défilement horizontal. 

#### Déduplication
<a name="visualization-options-deduping"></a>

 Les données du journal peuvent être très répétitives. Explore peut vous aider en masquant les lignes de journal dupliquées. Vous pouvez choisir parmi différents algorithmes de déduplication : 
+  **Exact** — Les correspondances exactes sont effectuées sur l'ensemble de la ligne, à l'exception des champs de date. 
+  **Chiffres** — Les correspondances sont effectuées sur la ligne après avoir retiré des nombres tels que les durées, les adresses IP, etc. 
+  **Signature** — La déduplication la plus agressive consiste à supprimer toutes les lettres et tous les chiffres. Les correspondances sont effectuées sur les espaces blancs et les signes de ponctuation restants. 

#### Inverser l'ordre des résultats
<a name="visualization-options-flip-results-order"></a>

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

### Libellés et champs détectés
<a name="labels-and-detected-fields"></a>

 Chaque ligne de journal possède une zone extensible avec ses étiquettes et ses champs détectés, pour une interaction plus robuste. Pour toutes les étiquettes, vous pouvez filtrer (filtre positif) et filtrer (filtre négatif) les étiquettes sélectionnées. Chaque champ ou étiquette possède également une icône de statistiques pour afficher des statistiques ponctuelles relatives à tous les journaux affichés. 

### Activer/désactiver les champs détectés
<a name="toggle-detected-fields"></a>

 Si vos journaux sont structurés en JSON ou logfmt, vous pouvez afficher ou masquer les champs détectés. Développez une ligne de journal, puis cliquez sur l'icône en forme d'œil pour afficher ou masquer les champs. 

 \$1\$1< docs-imagebox img= »/img/docs/explore/parsed-fields-7-2.gif "max-width="800px » caption="Modification des champs détectés dans Explore » >\$1\$1 

## Intégration du traçage
<a name="tracing-integration"></a>

 Vous pouvez visualiser des traces à partir de sources de données de suivi dans Explore. Sources de données actuellement prises en charge : 
+ [Connectez-vous à une source de données Jaeger](jaeger-data-source.md) 
+ [Connectez-vous à une source de données Tempo](tempo-data-source.md) 
+ [Se connecter à une source AWS X-Ray de données](x-ray-data-source.md) 
+ [Connect à une source de données Zipkin](zipkin-data-source.md) 

 Pour plus d'informations sur l'utilisation de l'éditeur de requêtes, consultez la documentation de la source de données spécifique. 

### En-tête
<a name="explore-header"></a>

L'en-tête inclut les éléments suivants :
+  Titre de l'en-tête, qui indique le nom de l'intervalle racine et l'ID de trace 
+  Recherche, qui met en évidence les plages contenant le texte recherché 
+  Métadonnées relatives à la trace 

### Mini-carte
<a name="explore-minimap"></a>

 La minicarte montre une vue condensée ou la chronologie du tracé. Faites glisser votre souris 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. Si vous faites une pause sur la mini-carte, lorsque vous zoomez, vous pouvez voir le bouton **Réinitialiser la sélection**, qui réinitialise le zoom. 

### Chronologie
<a name="explore-timeline"></a>

 La chronologie affiche une liste des intervalles de la trace. Chaque ligne d'espacement comprend les composants suivants : 
+ Bouton **Élargir les enfants** : élargit ou réduit toutes les tranches pour enfants de la période sélectionnée 
+ Nom du service : nom du service qui a enregistré le span
+ Nom de l'opération : nom de l'opération que cette plage représente
+ Barre de durée de l'intervalle : représentation visuelle de la durée de l'opération dans le tracé

Si vous choisissez n'importe où sur la ligne d'intervalle, les détails de l'intervalle s'affichent. 

### Détails de l'envergure
<a name="explore-span-details"></a>

Les détails de l'intervalle incluent les éléments suivants :
+  Nom de l’opération 
+  Métadonnées Span 
+  Tags (tous les tags associés à 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. 

## Navigation entre Explore et un tableau de bord
<a name="navigating-between-explore-and-a-dashboard"></a>

 Pour accélérer les flux de travail qui impliquent de passer régulièrement d'Explore à un tableau de bord et vice-versa, nous avons ajouté la possibilité de revenir au tableau de bord d'origine après avoir accédé à Explore dans le menu déroulant du panneau. 

 Après avoir accédé à Explore, vous devriez remarquer un bouton « Retour » dans la barre d'outils Explore. 

 Le simple fait de choisir le bouton vous ramènera au tableau de bord d'origine ou, si vous souhaitez réintégrer les modifications que vous apportez dans Explore dans le tableau de bord, il vous suffit de cliquer sur la flèche à côté du bouton pour afficher un élément de menu « Retourner au panneau avec les modifications ». 

## Inspecteur de requêtes
<a name="query-inspector"></a>

 Pour faciliter le débogage des requêtes, Explore vous permet d'étudier les demandes et les réponses aux requêtes, ainsi que les statistiques des requêtes, via l'inspecteur de requêtes. Cette fonctionnalité est similaire à l'onglet **Statistiques** et à l'onglet **Requête** de l'inspecteur du panneau. Pour plus d'informations, consultez [Inspectez les performances des requêtes](inspect-a-panel.md#inspect-query-performance) et [Afficher la demande brute et la réponse à la source de données](inspect-a-panel.md#view-raw-request-and-response-to-data-source). 

# Liens
<a name="linking-in-Amazon-Managed-Service-for-Grafana"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 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. 

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

## Quel lien devriez-vous utiliser ?
<a name="which-link-should-you-use"></a>

 Commencez par examiner la façon dont 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. Bien que tous les types de liens de Grafana soient utilisés pour créer des raccourcis vers d'autres tableaux de bord ou des sites Web externes, ils fonctionnent dans différents contextes. 
+  Pour ajouter des liens relatifs à la plupart ou à tous les panneaux du tableau de bord, utilisez[Liens du tableau de bord](dashboard-links.md). 
+  Pour accéder à des panneaux spécifiques, utilisez[Liens vers le panneau](panel-links.md).
+  Pour créer un lien vers des sites externes, vous pouvez utiliser un lien de tableau de bord ou un lien de panneau. 
+  Pour approfondir une série spécifique, ou même une seule mesure, utilisez[Liaisons de données](data-links.md). 

## Contrôle de l'intervalle de temps à l'aide de l'URL
<a name="controlling-time-range-using-the-url"></a>

 Vous pouvez contrôler la plage horaire d'un panneau ou 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. 
+  `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 millisecondes. Par exemple, il en `?time=1500000000000&time.window=10000` résultera une plage de temps de 10 secondes comprise entre 1499999995000 et 1500000005000 

# Liens du tableau de bord
<a name="dashboard-links"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 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. Cela permet de s'assurer que la personne à qui vous envoyez le lien consulte les bonnes données. Pour les autres types de liens, voir[Variables de liaison de données](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

 Une fois que vous avez ajouté un lien au tableau de bord, celui-ci apparaît dans le coin supérieur droit de votre tableau de bord. 

## Ajouter des liens aux tableaux de bord
<a name="add-links-to-dashboards"></a>

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

1.  Lorsque vous consultez le tableau de bord auquel vous souhaitez ajouter un lien, cliquez sur l'icône en forme de roue dentée en haut de l'écran pour ouvrir les **paramètres du tableau de bord**. 

1.  Choisissez **Liens**, puis choisissez **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 : 
   +  **Avec des balises** : entrez des balises pour limiter les tableaux de bord liés à ceux contenant les balises que vous avez saisies. Sinon, l'espace de travail Grafana inclut des liens vers tous les autres tableaux de bord. 
   +  **Sous forme de liste déroulante** : sélectionnez cette option si vous créez un lien vers de nombreux tableaux de bord et ajoutez un titre facultatif à la liste déroulante. Si cette option n'est pas sélectionnée, l'espace de travail Grafana affiche les liens du tableau de bord côte à côte en haut de votre tableau de bord. 
   +  **Plage de temps** : sélectionnez cette option pour inclure la plage horaire du tableau de bord dans le lien. Lorsque l'utilisateur choisit 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 les variables de modèle actuellement utilisées comme paramètres de requête dans le lien. Lorsque l'utilisateur choisit le lien, tous les modèles correspondants du tableau de bord lié sont définis selon les valeurs du lien.
   +  **Ouvrir dans un nouvel onglet** : sélectionnez cette option pour ouvrir le lien du tableau de bord dans un nouvel onglet ou une nouvelle fenêtre. 

1.  Choisissez **Ajouter**. 

## Ajouter un lien URL à un tableau de bord
<a name="add-a-url-link-to-a-dashboard"></a>

 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 voit les données spécifiques dans l'espace de travail de Grafana. 

1.  Lorsque vous consultez le tableau de bord vers lequel vous souhaitez créer un lien, cliquez sur l'icône en forme de roue dentée en haut de l'écran pour ouvrir **les paramètres du tableau de bord**. 

1.  Choisissez **Liens**, puis choisissez **Ajouter un lien au tableau de bord** ou **Nouveau**. 

1.  Dans **Type**, sélectionnez le **lien**. 

1.  Sélectionnez les options de lien : 
   +  **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 vous souhaitez que le lien affiche. 
   +  **Info-bulle** — Entrez l'infobulle que vous souhaitez que le lien affiche lorsque l'utilisateur le survole. 
   +  **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 choisit le lien, le tableau de bord associé s'ouvre avec la plage de temps indiquée déjà définie. 
     +  `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é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 millisecondes. Par exemple, cela `?time=1500000000000&time.window=10000` donne une plage de temps de 10 secondes comprise entre 1499999995000 et 1500000005000. 
   +  **Valeurs des variables** : sélectionnez cette option pour inclure les variables de modèle actuellement utilisées comme paramètres de requête dans le lien. Lorsque l'utilisateur choisit le lien, tous les modèles correspondants du tableau de bord lié sont définis selon les valeurs du lien ; par exemple, https://play.grafana. org/d/000000074/alerting? var-app=backend&var-server=backend\$101&var-server=backend\$103&var-interval = 1h 
   +  **Ouvrir dans un nouvel onglet** : sélectionnez cette option pour ouvrir le lien du tableau de bord dans un nouvel onglet ou une nouvelle fenêtre. 

1.  Choisissez **Ajouter**. 

## Mettre à jour un lien de tableau de bord
<a name="update-a-dashboard-link"></a>

 Pour modifier ou mettre à jour un lien de tableau de bord existant, procédez comme suit. 

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

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

## Dupliquer le lien d'un tableau de bord
<a name="duplicate-a-dashboard-link"></a>

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

## Supprimer un lien vers un tableau de bord
<a name="delete-a-dashboard-link"></a>

 Pour supprimer un lien de tableau de bord existant, choisissez l'icône de la corbeille correspondant au lien que vous souhaitez supprimer. 

# Liens vers le panneau
<a name="panel-links"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 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 tous les sites disponibles URLs, 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 voit les données spécifiques dans l'espace de travail de Grafana. 

Cliquez sur l'icône dans le coin supérieur gauche d'un panneau pour voir les liens disponibles. 

## Ajouter un lien vers un panneau
<a name="add-a-panel-link"></a>

1.  Faites une pause sur le panneau auquel vous souhaitez ajouter un lien, puis appuyez sur **e.** Ou choisissez la flèche déroulante à côté du titre du panneau, puis sélectionnez **Modifier**. 

1.  Dans l'onglet **Panneau**, faites défiler l'écran jusqu'à la section **Liens**. 

1.  Développez **les liens**, puis choisissez **Ajouter un lien**. 

1.  Entrez un **titre** pour le lien. Le titre sera affiché dans l'interface utilisateur. 

1.  Entrez l'**URL** vers laquelle vous souhaitez créer un lien. Vous pouvez inclure l'une des variables de modèle définies dans le tableau de bord. Appuyez sur **Ctrl\$1Espace** ou **Cmd\$1Espace**, puis choisissez le champ **URL** pour voir les variables disponibles. Lorsque vous ajoutez 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é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 millisecondes. Par exemple, cela `?time=1500000000000&time.window=10000` donne une plage de 10 secondes comprise entre 1499999995000 et 1500000005000. 

1.  Pour ouvrir dans un nouvel onglet, sélectionnez **Ouvrir dans un nouvel onglet**. 

1.  Choisissez **Enregistrer** pour enregistrer les modifications et fermer la fenêtre. 

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

## Mettre à jour le lien d'un panneau
<a name="update-a-panel-link"></a>

1.  Dans l'onglet **Panneau**, recherchez le lien que vous souhaitez modifier. 

1.  Cliquez sur l'icône **Modifier** (crayon) pour ouvrir la fenêtre **Modifier le lien**. 

1.  Apportez toutes les modifications nécessaires. 

1.  Choisissez **Enregistrer** pour enregistrer les modifications et fermer la fenêtre. 

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

## Supprimer un lien vers un panneau
<a name="delete-a-panel-link"></a>

1.  Dans l'onglet **Panneau**, recherchez le lien que vous souhaitez supprimer. 

1.  Cliquez sur l'icône **X** à côté du lien que vous souhaitez supprimer. 

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

# Liaisons de données
<a name="data-links"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Les liens de données fournissent 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. Par exemple, si votre visualisation montre quatre serveurs, vous pouvez ajouter un lien de données vers un ou deux d'entre eux. 

 Le lien lui-même est accessible de différentes manières, en fonction de la visualisation. Pour le panneau graphique, vous devez choisir un point de données ou une ligne. Pour un panneau tel que stat, gauge ou bar gauge, vous pouvez choisir n'importe où dans la visualisation pour ouvrir le menu contextuel. 

 Vous pouvez utiliser des variables dans les liens de données pour rediriger les utilisateurs vers un tableau de bord détaillé avec des filtres de données préservés. Par exemple, vous pouvez utiliser des variables pour spécifier une plage de temps, une série et une sélection de variables. Pour de plus amples informations, veuillez consulter [Variables de liaison de données](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

## Suggestions de saisie
<a name="typeahead-suggestions"></a>

 Lorsque vous créez ou mettez à jour un lien de données, appuyez sur les **touches Ctrl\$1Espace** ou **Cmd\$1Espace** sur votre clavier pour ouvrir les suggestions de saisie anticipée afin d'ajouter plus facilement des variables à votre URL. 

## Ajouter un lien de données
<a name="add-a-data-link"></a>

1.  Faites une pause sur le panneau auquel vous souhaitez ajouter un lien, puis appuyez sur **e.** Ou choisissez la flèche déroulante à côté du titre du panneau, puis sélectionnez **Modifier**. 

1.  Dans l'onglet **Champ**, faites défiler l'écran jusqu'à la section **Liens de données**. 

1.  Développez **les liens de données**, puis choisissez **Ajouter un lien**. 

1.  Entrez un **titre** pour le lien. Le titre sera affiché dans l'interface utilisateur. 

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

    Vous pouvez ajouter l'une des variables de modèle définies dans le tableau de bord. Choisissez le champ **URL**, puis tapez **\$1**, ou appuyez sur **** Ctrl\$1Espace ou **Cmd\$1Espace** pour afficher la liste des variables disponibles. Lorsque vous ajoutez 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. Pour de plus amples informations, veuillez consulter [Variables de liaison de données](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables). 

1.  Pour ouvrir dans un nouvel onglet, sélectionnez **Ouvrir dans un nouvel onglet**. 

1.  Choisissez **Enregistrer** pour enregistrer les modifications et fermer la fenêtre. 

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

## Mettre à jour un lien de données
<a name="update-a-data-link"></a>

1.  Dans l'onglet **Champ**, recherchez le lien que vous souhaitez modifier. 

1.  Cliquez sur l'icône **Modifier** (crayon) pour ouvrir la fenêtre **Modifier le lien**. 

1.  Apportez toutes les modifications nécessaires. 

1.  Choisissez **Enregistrer** pour enregistrer les modifications et fermer la fenêtre. 

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

## Supprimer un lien de données
<a name="delete-a-data-link"></a>

1.  Dans l'onglet **Champ**, recherchez le lien que vous souhaitez supprimer. 

1.  Cliquez sur l'icône **X** à côté du lien que vous souhaitez supprimer. 

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

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

 Vous pouvez utiliser des variables dans les liaisons de données pour voir les champs de série, les étiquettes et les valeurs. Pour plus d'informations sur les liaisons de données, consultez[Liaisons de données](data-links.md). 

 Pour voir la liste des variables disponibles, entrez **\$1** dans le champ **URL** du lien de données. 

 Vous pouvez également utiliser des variables de modèle dans vos liens de données URLs. Pour de plus amples informations, veuillez consulter [Modèles et variables](templates-and-variables.md). 

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

 Vous pouvez utiliser les variables suivantes pour inclure la plage horaire actuelle dans l'URL du lien de données : 
+  `__url_time_range`— La plage horaire du tableau de bord actuel ; par exemple, `?from=now-6h&to=now` 
+  `$__from and $__to`— Pour plus d'informations, consultez [Variables globales] (\$1\$1< relref «.. /variables/variable-types/global-variables.md \$1\$1\$1from -and-\$1\$1to » >\$1\$1). 

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

 Les variables spécifiques aux séries sont disponibles dans l'`__series`espace de noms : 
+  `__series.name`— Ajoute le nom de la série à l'URL 
+  `__series.labels.<LABEL>`— Ajoute la valeur de l'étiquette à l'URL. Si votre étiquette contient des points, utilisez `__series.labels["<LABEL>"]` la syntaxe. 

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

 Les variables spécifiques aux champs sont disponibles sous l'`__field`espace de noms : 
+  `__field.name`— Le nom du champ 

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

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

### Variables du modèle
<a name="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 choisit le lien. 

 Utiliser`var-myvar=${myvar}`, où `myvar` est le nom de la variable de modèle qui correspond à celui du tableau de bord actuel que vous souhaitez utiliser. 

 Pour ajouter toutes les variables du tableau de bord actuel à l'URL, utilisez`__all_variables`. 

# Modèles et variables
<a name="templates-and-variables"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Une variable est un espace réservé pour une valeur. Vous pouvez utiliser des variables dans les requêtes métriques et dans les titres des panneaux. Les variables vous permettent de créer des tableaux de bord plus interactifs et dynamiques. Au lieu de coder en dur des éléments tels que les noms des serveurs, des applications et des capteurs dans vos requêtes métriques, vous pouvez utiliser des variables à leur place. 

Les variables sont affichées sous forme de listes déroulantes en haut du tableau de bord. Lorsque vous modifiez la valeur à l'aide de la liste déroulante en haut du tableau de bord, les requêtes métriques de votre panneau reflètent la nouvelle valeur. 

Elles peuvent être particulièrement utiles pour les administrateurs qui souhaitent permettre aux utilisateurs d'ajuster rapidement les visualisations, mais qui ne souhaitent pas leur accorder des autorisations de modification complètes. Les visualiseurs de Grafana peuvent utiliser des variables. 

En utilisant des variables et des modèles, vous pouvez créer des tableaux de bord à source unique. Si vous disposez de plusieurs sources de données ou serveurs identiques, vous pouvez créer un tableau de bord unique et utiliser des variables pour modifier ce que vous visualisez. Cela simplifie la maintenance et l'entretien. 

Pour obtenir la liste des types de variables pris en charge et les instructions pour ajouter chaque type de variable, voir [Types de variables](variables-types.md)

## Modèles
<a name="templates"></a>

 Un *modèle* est une requête contenant une variable. 

Par exemple, si vous administriez un tableau de bord pour surveiller plusieurs serveurs, vous pourriez créer un tableau de bord pour chaque serveur. Vous pouvez également créer un tableau de bord et utiliser des panneaux contenant des modèles de requêtes, comme illustré dans l'exemple suivant. 

```
wmi_system_threads{instance=~"$server"}
```

Les valeurs des variables sont toujours synchronisées avec l'URL à l'aide de la syntaxe`var-<varname>=value`. 

## Bonnes pratiques variables
<a name="variable-best-practices"></a>

Les listes déroulantes de variables sont affichées dans l'ordre dans lequel elles sont répertoriées dans la liste des variables dans les **paramètres du tableau de bord.**

Placez les variables que vous allez souvent modifier en haut, afin qu'elles apparaissent en premier, à l'extrême gauche du tableau de bord.

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

 Les titres des panneaux et les requêtes métriques peuvent voir les variables à l'aide de deux syntaxes différentes : 
+  `$varname`Cette syntaxe est plus facile à lire, comme dans l'exemple suivant : `apps.frontend.$server.requests.count` Cependant, vous ne pouvez pas utiliser de variable au milieu d'un mot. 
+  `${var_name}`Utilisez cette syntaxe lorsque vous souhaitez interpoler une variable au milieu d'une expression. 
+  `${var_name:<format>}`Ce format vous permet de mieux contrôler la façon dont Grafana interpole les valeurs. Pour de plus amples informations, veuillez consulter [Options avancées de format variable](#advanced-variable-format-options). 

 Avant que les requêtes ne soient envoyées à votre source de données, elles sont *interpolées*, ce qui signifie que la variable est remplacée par sa valeur actuelle. Pendant l'interpolation, la valeur de la variable peut être *évitée* pour se conformer à la syntaxe du langage de requête et à l'endroit où elle est utilisée. Par exemple, une variable utilisée dans une expression régulière d'une requête Prometheus sera échappée à une expression régulière. Consultez la rubrique de documentation spécifique à la source de données pour plus de détails sur l'échappement de valeur lors de l'interpolation. 

 Pour plus d'informations sur la syntaxe avancée permettant de remplacer le formatage par défaut de la source de données, consultez[Options avancées de format variable](#advanced-variable-format-options). 

# Types de variables
<a name="variables-types"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

 Grafana utilise plusieurs types de variables. 


|  Type de variable  |  Description  | 
| --- | --- | 
|  Query  |  Liste de valeurs générée par requête, telles que les noms des métriques, les noms des serveurs, les capteurs IDs, les centres de données, etc. Pour de plus amples informations, veuillez consulter [Ajouter une variable de requête](#add-a-query-variable).  | 
|  Personnalisé  |  Définissez les options des variables manuellement à l'aide d'une liste séparée par des virgules. Pour de plus amples informations, veuillez consulter [Ajouter une variable personnalisée](#add-a-custom-variable).  | 
|  Zone de texte  |  Affichez un champ de saisie de texte avec une valeur par défaut facultative. Pour de plus amples informations, veuillez consulter [Ajouter une variable de zone de texte](#add-a-text-box-variable).  | 
|  Constant  |  Définissez une constante cachée. Pour de plus amples informations, veuillez consulter [Ajouter une variable constante](#add-a-constant-variable).  | 
|  Source de données  |  Modifiez rapidement la source de données d'un tableau de bord complet. Pour de plus amples informations, veuillez consulter [Ajouter une variable de source de données](#add-a-data-source-variable).  | 
|  Interval  |  Les variables d'intervalle représentent des intervalles de temps. Pour de plus amples informations, veuillez consulter [Ajouter une variable d'intervalle](#add-an-interval-variable).  | 
|  Filtres ad hoc  |  Key/value filtres qui sont automatiquement ajoutés à toutes les requêtes métriques pour une source de données (InfluxDB, Prometheus et uniquement). OpenSearch Pour de plus amples informations, veuillez consulter [Ajouter des filtres ad hoc](#add-ad-hoc-filters).  | 
|  Variables globales  |  Variables intégrées qui peuvent être utilisées dans les expressions de l'éditeur de requêtes. Pour de plus amples informations, veuillez consulter [Variables globales](#global-variables).  | 
|  Variables enchaînées  |  Les requêtes de variables peuvent contenir d'autres variables. Pour de plus amples informations, veuillez consulter [Variables enchaînées](#chained-variables).  | 

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

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

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

### Expressions de requête
<a name="query-expressions"></a>

Les expressions de requête sont différentes pour chaque source de données. Pour plus d'informations, consultez la documentation de votre source de données à l'adresse[Connexion aux sources de données](AMG-data-sources.md).

### Saisie des options générales
<a name="enter-general-options"></a>

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

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

1.  Dans l'onglet **Variables**, choisissez **Nouveau**. 

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

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

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

1.  Choisissez une option **Masquer** : 
   +  **Aucune sélection (vide)** : la liste déroulante des variables affiche le **nom** ou la valeur de l'**étiquette** de la variable. Il s’agit de l’option par défaut. 
   +  **Libellé** — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas. 
   +  **Variable** — Aucune liste déroulante de variables n'est affichée sur le tableau de bord. 

### Saisie des options de requête
<a name="enter-query-options"></a>

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

1. Dans la liste **des sources de données**, sélectionnez la source de données cible pour la requête. Pour plus d'informations sur les sources de données, consultez[Connexion aux sources de données](AMG-data-sources.md).

1.  Dans la liste **Actualiser**, sélectionnez le moment où la variable doit mettre à jour les options. 
   +  **Jamais** : met en cache les requêtes variables et les valeurs ne sont pas mises à jour. C'est bien si les valeurs ne changent jamais, mais problématique si elles sont dynamiques et changent beaucoup. 
   +  **Lors du chargement du tableau de bord** : interroge la source de données à chaque fois que le tableau de bord se charge. Cela ralentit le chargement du tableau de bord, car la requête variable doit être terminée avant que le tableau de bord puisse être initialisé. 
   +  **En cas de changement d'intervalle de temps** : interroge la source de données lorsque la plage horaire du tableau de bord change. Utilisez cette option uniquement si votre requête d'options variables contient un filtre de plage de temps ou dépend de la plage de temps du tableau de bord. 

1.  Dans le champ **Requête**, entrez une requête. 
   +  Le champ de requête varie en fonction de votre source de données. Certaines sources de données disposent d'éditeurs de requêtes personnalisés. 
   + Si vous avez besoin de plus d'espace dans un éditeur de requêtes pour un seul champ de saisie, faites une pause sur les lignes situées dans le coin inférieur droit du champ et faites glisser le pointeur vers le bas pour l'agrandir. 

1. (Facultatif) Dans le champ **Regex**, tapez une expression regex pour filtrer ou capturer des parties spécifiques des noms renvoyés par votre requête de source de données. Pour obtenir des exemples, consultez [Filtrer les variables avec regex](templates-and-variables.md#filter-variables-with-regex). 

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

1. (Facultatif) Entrez les **options de sélection**. Pour de plus amples informations, veuillez consulter [Saisie des options de sélection des variables](templates-and-variables.md#enter-variable-selection-options). 

1.  Dans **Aperçu des valeurs**, l'espace de travail Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes. 

1.  Choisissez **Ajouter** pour ajouter la variable au tableau de bord. 

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

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

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

### Saisie des options générales
<a name="variables-enter-general-options"></a>

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

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

1.  Dans l'onglet **Variables**, choisissez **Nouveau**. 

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

1.  Dans la liste **Type**, sélectionnez **Personnalisé**. 

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

1.  Choisissez une option **Masquer** : 
   +  **Aucune sélection (vide)** : la liste déroulante des variables affiche le **nom** ou la valeur de l'**étiquette** de la variable. Il s’agit de l’option par défaut. 
   +  **Libellé** ‐ La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas. 
   +  **Variable** — Aucune liste déroulante de variables n'est affichée sur le tableau de bord. 

### Saisie d'options personnalisées
<a name="enter-custom-options"></a>

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

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

1.  (Facultatif) Entrez les **options de sélection**. Pour de plus amples informations, veuillez consulter [Saisie des options de sélection des variables](templates-and-variables.md#enter-variable-selection-options). 

1.  Dans **Aperçu des valeurs**, l'espace de travail Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes. 

1. Choisissez **Ajouter** pour ajouter la variable au tableau de bord. 

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

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

### Saisie des options générales
<a name="text-box-enter-general-options"></a>

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

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

1.  Dans l'onglet **Variables**, choisissez **Nouveau**. 

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

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

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

1.  Choisissez une option **Masquer** : 
   +  **Aucune sélection (vide)** : la liste déroulante des variables affiche le **nom** ou la valeur de l'**étiquette** de la variable. Il s’agit de l’option par défaut. 
   +  **Libellé** — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas. 
   +  **Variable** — Aucune liste déroulante de variables n'est affichée sur le tableau de bord. 

### Saisie des options de texte
<a name="enter-text-options"></a>

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

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

1.  Dans **Aperçu des valeurs**, Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes. 

1. Choisissez **Ajouter** pour ajouter la variable au tableau de bord. 

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

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

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

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

### Saisie des options générales
<a name="constant-variable-enter-general-options"></a>

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

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

1.  Dans l'onglet **Variables**, choisissez **Nouveau**. 

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

1.  Dans la liste **Type**, sélectionnez **Constante**. 

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

1.  Choisissez une option **Masquer** : 
   +  **Variable** — Aucune liste déroulante de variables n'est affichée sur le tableau de bord. Il s’agit de l’option par défaut. 
   +  **Aucune sélection (vide)** : la liste déroulante des variables affiche le **nom** ou la valeur de l'**étiquette** de la variable. 
   +  **Libellé** — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas. 

### Saisie d'options constantes
<a name="enter-constant-options"></a>

**Pour saisir des options constantes pour une variable constante**

1. Dans le champ **Valeur**, entrez la valeur de la variable. Vous pouvez saisir des lettres, des chiffres et des symboles. Si vous utilisez des options de format variable avancées, vous pouvez même utiliser des caractères génériques. Pour de plus amples informations, veuillez consulter [Options avancées de format variable](templates-and-variables.md#advanced-variable-format-options). 

1. Dans **Aperçu des valeurs**, l'espace de travail Grafana affiche la valeur de la variable actuelle. Révisez-le pour vous assurer qu'il correspond à vos attentes. 

1. Choisissez **Ajouter** pour ajouter la variable au tableau de bord. 

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

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

### Saisie des options générales
<a name="data-source-enter-general-options"></a>

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

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

1.  Dans l'onglet **Variables**, choisissez **Nouveau**. 

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

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

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

1.  Choisissez une option **Masquer** : 
   +  **Aucune sélection (vide)** : la liste déroulante des variables affiche le **nom** ou la valeur de l'**étiquette** de la variable. Il s’agit de l’option par défaut. 
   +  **Libellé** — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas. 
   +  **Variable** — Aucune liste déroulante de variables n'est affichée sur le tableau de bord. 

### Saisie des options de source de données
<a name="enter-data-source-options"></a>

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

1.  Dans la liste **Type**, sélectionnez la source de données cible pour la variable. Pour plus d'informations sur les sources de données, consultez[Connexion aux sources de données](AMG-data-sources.md). 

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

1.  (Facultatif) Entrez les **options de sélection**. Pour de plus amples informations, veuillez consulter [Saisie des options de sélection des variables](templates-and-variables.md#enter-variable-selection-options). 

1.  Dans **Aperçu des valeurs**, Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes. 

1. Choisissez **Ajouter** pour ajouter la variable au tableau de bord. 

## Ajouter une variable d'intervalle
<a name="add-an-interval-variable"></a>

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

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

### Saisie des options générales
<a name="interval-variable-enter-general-options"></a>

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

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

1.  Dans l'onglet **Variables**, choisissez **Nouveau**. 

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

1.  Dans la liste **Type**, sélectionnez **Intervalle**. 

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

1.  Choisissez une option **Masquer** : 
   +  **Aucune sélection (vide)** : la liste déroulante des variables affiche le **nom** ou la valeur de l'**étiquette** de la variable. Il s’agit de l’option par défaut. 
   +  **Libellé** — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas. 
   +  **Variable** — Aucune liste déroulante de variables n'est affichée sur le tableau de bord. 

### Saisie des options d'intervalle
<a name="enter-interval-options"></a>

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

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

1. (Facultatif) Activez **l'option automatique** si vous souhaitez ajouter l'`auto`option à la liste. Utilisez cette option pour spécifier combien de fois la plage de temps actuelle doit être divisée pour calculer la `auto` période actuelle. Si vous l'activez, deux autres options apparaissent : 
   +  **Nombre de pas** : sélectionnez le nombre de fois que la plage de temps actuelle sera divisée pour calculer la valeur, comme pour l'option de requête **Max data points**. Par exemple, si la plage de temps visible actuelle est de 30 minutes, l'`auto`intervalle regroupe les données en 30 incréments d'une minute. La valeur par défaut est de 30 étapes. 
   +  **Intervalle minimum** : seuil minimal en dessous duquel les intervalles de décompte des pas ne divisent pas le temps. Pour continuer l'exemple de 30 minutes, si l'intervalle minimum est défini sur`2m`, Grafana regroupe les données en 15 incréments de 2 minutes. 

1.  Dans **Aperçu des valeurs**, Grafana affiche une liste des valeurs des variables actuelles. Révisez-les pour vous assurer qu'ils correspondent à vos attentes. 

1. Choisissez **Ajouter** pour ajouter la variable au tableau de bord. 

### Exemples de variables d'intervalle
<a name="interval-variable-examples"></a>

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

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

 Un exemple de graphite plus complexe : 

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

## Ajouter des filtres ad hoc
<a name="add-ad-hoc-filters"></a>

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

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

### Saisie des options générales
<a name="ad-hoc-filters-enter-general-options"></a>

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

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

1.  Dans l'onglet **Variables**, choisissez **Nouveau**. 

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

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

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

1.  Choisissez une option **Masquer** : 
   +  **Aucune sélection (vide)** : la liste déroulante des variables affiche le **nom** ou la valeur de l'**étiquette** de la variable. Il s’agit de l’option par défaut. 
   +  **Libellé** — La liste déroulante des variables affiche uniquement la valeur de variable sélectionnée et une flèche vers le bas. 
   +  **Variable** — Aucune liste déroulante de variables n'est affichée sur le tableau de bord. 

### Options de saisie
<a name="ad-hoc-enter-options"></a>

**Pour saisir les options d'un filtre ad hoc**

1.  Dans la liste **des sources de données**, sélectionnez la source de données cible. Pour plus d'informations sur les sources de données, consultez[Connexion aux sources de données](AMG-data-sources.md). 

1. Choisissez **Ajouter** pour ajouter la variable au tableau de bord. 

### Création de filtres ad hoc
<a name="create-ad-hoc-filters"></a>

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

## Variables enchaînées
<a name="chained-variables"></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. Cette section explique le fonctionnement des variables chaînées et fournit des liens vers des exemples de tableaux de bord utilisant des variables chaînées. 

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

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

### Bonnes pratiques et conseils
<a name="variables-best-practices-and-tips"></a>

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

#### Création de nouvelles variables chaînées
<a name="creating-new-linked-variables"></a>
+  Le chaînage de variables crée des dépendances parent-enfant. Vous pouvez les imaginer comme une échelle ou un arbre. 
+ Le moyen le plus rapide de créer une nouvelle variable chaînée consiste à copier la variable sur laquelle vous souhaitez baser la nouvelle variable. Dans la liste des variables, cliquez sur l'icône **Dupliquer la variable** à droite de l'entrée de variable pour créer une copie. Vous pouvez ensuite ajouter un élément à la requête pour la variable parent.
+ Les nouvelles variables chaînées que vous créez de cette manière apparaissent en bas de la liste. Pour donner un ordre logique à la liste, faites glisser la variable vers une autre position dans la liste. 

#### Ordre variable
<a name="variable-order"></a>

Pour modifier l'ordre des variables dans la liste des variables du tableau de bord, cliquez sur les flèches haut et bas à droite de chaque entrée. L'espace de travail Grafana répertorie les listes déroulantes de variables de gauche à droite en fonction de cette liste, en affichant la variable en haut de la liste à l'extrême gauche. 
+  Répertoriez les variables qui n'ont pas de dépendances en haut, avant leurs variables enfants. 
+  Chaque variable doit suivre celle dont elle dépend. 
+ L'interface utilisateur n'indique pas quelles variables ont des relations de dépendance. Répertoriez les variables dans un ordre logique afin de le rendre plus clair pour les utilisateurs finaux (et pour vous-même). 

#### Considération de complexité
<a name="complexity-consideration"></a>

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

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

## Variables globales
<a name="global-variables"></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
<a name="global-variable-dashboard"></a>

Cette variable est le nom du tableau de bord actuel. 

### \$1\$1\$1from et \$1\$1\$1to
<a name="global-variable-from-and-__to"></a>

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


|  Syntaxe  |  Exemple de résultat  |  Description  | 
| --- | --- | --- | 
|  \$1\$1\$1\$1from\$1  |  1594671549254  |  Époque Unix en millisecondes  | 
|  \$1\$1\$1\$1from:date\$1  |  2020-07-13T 20:19:09.254 Z  |  Aucun argument, la valeur par défaut est ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:iso\$1  |  2020-07-13T 20:19:09.254 Z  |  ISO 8601/RFC 3339  | 
|  \$1\$1\$1\$1from:date:seconds\$1  |  1594671549  |  Époque des secondes Unix  | 
|  \$1\$1\$1\$1from:date:YYYY-MM\$1  |  2020-07  |  Tout format de données personnalisé. Pour plus d'informations, consultez la section [Affichage](https://momentjs.com/docs/#/displaying/).  | 

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

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

### \$1\$1\$1interval
<a name="global-variable-interval"></a>

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

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

 Calcul approximatif : `(from - to) / resolution` 

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

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

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

### \$1\$1\$1interval ms
<a name="global-variable-interval_ms"></a>

 Cette variable est la `$__interval` variable exprimée en millisecondes, et non une chaîne formatée par intervalle de temps. Par exemple, si le `$__interval` est`20m`, alors le `$__interval_ms` est`1200000`. 

### \$1\$1\$1nom
<a name="global-variable-name"></a>

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

### \$1\$1\$1org
<a name="global-variable-org"></a>

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

### \$1\$1\$1utilisateur
<a name="global-variable-user"></a>

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

### \$1\$1\$1range
<a name="global-variable-range"></a>

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

### \$1timeFilter ou \$1\$1\$1timeFilter
<a name="global-variable-timefilter-or-__timefilter"></a>

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

 Cette variable est utilisée à plusieurs endroits, notamment : 
+ La clause WHERE pour la source de données InfluxDB. **Grafana l'ajoute automatiquement aux requêtes InfluxDB en mode éditeur de requêtes.** Vous pouvez l'ajouter manuellement en mode **éditeur de texte** :`WHERE $timeFilter`. 
+  Enregistrez les requêtes Analytics dans la source de données Azure Monitor. 
+  Requêtes SQL dans MySQL, Postgres et MSSQL. 
+  La `$__timeFilter` variable est utilisée dans la source de données MySQL. 

## Autres options variables
<a name="other-variable-options"></a>

Cette section explique les autres options de variables disponibles.

### Saisie des options de sélection des variables
<a name="enter-variable-selection-options"></a>

Vous pouvez utiliser les **options de sélection** pour gérer les sélections d'options variables. Toutes les options de sélection sont facultatives et sont désactivées par défaut. 

#### Valeurs multiples
<a name="multi-value"></a>

Si vous activez cette option, la liste déroulante des variables permet de sélectionner plusieurs options en même temps. Pour de plus amples informations, veuillez consulter [Formatage de variables à valeurs multiples](#formatting-multi-value-variables). 

#### Option Tout inclure
<a name="include-all-option"></a>

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

#### Toutes les valeurs personnalisées
<a name="custom-all-value"></a>

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

Pour définir la valeur de l'`All`option, entrez la syntaxe regex, glob ou Lucene dans le champ **Personnaliser** toutes les valeurs. 

Par défaut, la `All` valeur inclut toutes les options de l'expression combinée. Cela peut devenir très long et entraîner des problèmes de performance. Parfois, il peut être préférable de spécifier une valeur complète personnalisée, comme une expression régulière joker. 

Lorsque vous utilisez une syntaxe regex, glob ou Lucene **personnalisée dans l'option Personnaliser toutes les valeurs**, elle n'est jamais évitée. Vous devez donc déterminer quelle est une valeur valide pour votre source de données. 

### Options avancées de format variable
<a name="advanced-variable-format-options"></a>

 Le formatage de l'interpolation variable dépend de la source de données, mais dans certains cas, vous souhaiterez peut-être modifier le formatage par défaut. 

 Par exemple, la source de données MySQL par défaut consiste à joindre plusieurs valeurs séparées par des virgules par des guillemets :. `'server01','server02'` Dans certains cas, vous souhaiterez peut-être avoir une chaîne séparée par des virgules sans guillemets :. `server01,server02` Pour ce faire, utilisez les options avancées de mise en forme des variables suivantes. 

#### Syntaxe générale
<a name="general-syntax"></a>

 Syntaxe : `${var_name:option}` 

Si une option de mise en forme non valide est spécifiée, `glob` c'est l'option par défaut, ou option de secours. 

#### CSV
<a name="variables-csv"></a>

 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
<a name="distributed---opentsdb"></a>

 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
<a name="doublequote"></a>

 Formate les variables à valeur unique et à valeurs multiples dans une chaîne séparée par des virgules, exclut chaque valeur par et `"` met chaque valeur entre `\"` guillemets avec. `"` 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:doublequote}'
Interpolation result: '"test1","test2"'
```

#### Globe - Graphite
<a name="glob---graphite"></a>

 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
<a name="json"></a>

 Formate les variables comportant plusieurs valeurs sous forme de chaîne séparée par des virgules. 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:json}'
Interpolation result: '["test1", "test2"]'
```

#### Lucène - OpenSearch
<a name="lucene---opensearch"></a>

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

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

#### Code en pourcentage
<a name="percentencode"></a>

 Formate les variables à valeur unique et à valeurs multiples à utiliser dans les paramètres d'URL. 

```
servers = ['foo()bar BAZ', 'test2']
String to interpolate: '${servers:percentencode}'
Interpolation result: 'foo%28%29bar%20BAZ%2Ctest2'
```

#### Barre verticale
<a name="pipe"></a>

 Formate les variables comportant plusieurs valeurs dans une chaîne séparée par des tubes. 

```
servers = ['test1.', 'test2']
String to interpolate: '${servers:pipe}'
Interpolation result: 'test1.|test2'
```

#### Raw
<a name="raw"></a>

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

```
servers = ['test1.', 'test2']
String to interpolate: '${var_name:raw}'
Interpolation result: '{test.1,test2}'
```

#### Regex
<a name="regex"></a>

 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
<a name="singlequote"></a>

 Formate les variables à valeur unique ou multiple dans une chaîne séparée par des virgules, saisit chaque valeur par `\'` et `'` met chaque valeur entre guillemets avec. `'` 

```
servers = ['test1', 'test2']
String to interpolate: '${servers:singlequote}'
Interpolation result: "'test1','test2'"
```

#### Chaîne SQL
<a name="sqlstring"></a>

 Formate les variables à valeur unique ou multiple dans une chaîne séparée par des virgules, saisit chaque valeur par `''` et `'` met chaque valeur entre guillemets avec. `'` 

```
servers = ["test'1", "test2"]
String to interpolate: '${servers:sqlstring}'
Interpolation result: "'test''1','test2'"
```

#### Texte
<a name="text"></a>

 Formate les variables à valeur unique et à valeurs multiples dans leur représentation textuelle. Pour une seule variable, elle renverra simplement la représentation textuelle. Pour les variables à valeurs multiples, elle renverra la représentation textuelle combinée avec`+`. 

```
servers = ["test1", "test2"]
String to interpolate: '${servers:text}'
Interpolation result: "test1 + test2"
```

### Formatage de variables à valeurs multiples
<a name="formatting-multi-value-variables"></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 vous laissez ce champ vide, le Grafana concatène (additionne) toutes les valeurs de la requête. Quelque chose comme`value1,value2,value3`. Si une `all` valeur personnalisée est utilisée, elle sera plutôt quelque chose comme `*` ou`all`. 

#### Variables à valeurs multiples avec une source de données Graphite
<a name="multi-value-variables-with-a-graphite-data-source"></a>

 Graphite utilise des expressions globulaires. *Dans ce cas, une variable comportant plusieurs valeurs serait interpolée comme `{host1,host2,host3}` si la valeur actuelle de la variable était *host1, host2* *et host3*.* 

#### Variables à valeurs multiples avec une source de données Prometheus ou InfluxDB
<a name="multi-value-variables-with-a-prometheus-or-influxdb-data-source"></a>

 InfluxDB et Prometheus utilisent des expressions regex, de sorte que la même variable serait interpolée comme. `(host1|host2|host3)` Chaque valeur serait également échappée à une regex. Dans le cas contraire, une valeur avec un caractère de contrôle regex briserait l'expression regex. 

#### Variables à valeurs multiples avec une source de données Elastic
<a name="multi-value-variables-with-an-elastic-data-source"></a>

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

#### Résolution des problèmes de format
<a name="formatting-troubles"></a>

 L'échappement automatique et le formatage peuvent poser problème. Il peut être difficile de comprendre la logique d'un problème, en particulier pour InfluxDB et Prometheus, où l'utilisation de la syntaxe regex nécessite que la variable soit utilisée dans le contexte d'un opérateur regex. 

 Si vous ne voulez pas que Grafana effectue cet échappement et ce formatage automatiques des regex, vous devez effectuer l'une des opérations suivantes :
+ Désactivez les **options Inclure tout** à **valeurs multiples**.
+ Utilisez le [format de variable brut] (\$1\$1< relref "advanced-variable-format-options.md \$1raw" >\$1\$1).

### Filtrer les variables avec regex
<a name="filter-variables-with-regex"></a>

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

Cette section explique comment utiliser une expression régulière pour filtrer et modifier les valeurs de la liste déroulante des variables. 

 À l'aide de l'option Regex Query, vous filtrez la liste des options renvoyées par la requête Variable ou vous modifiez les options renvoyées. Pour plus d'informations, consultez la section [Expressions régulières](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions). 

 Exemples de filtrage dans la liste d'options suivante : 

```
backend_01
backend_02
backend_03
backend_04
```

#### Filtrer de manière à ce que seules les options se terminant par `01` ou `02` soient renvoyées
<a name="filter-so-that-only-the-options-that-end-with-01-or-02-are-returned"></a>

 Régex : 

```
/.*[01|02]/
```

 Résultat : 

```
backend_01
backend_02
```

#### Filtrer et modifier les options à l'aide d'un groupe de capture regex pour renvoyer une partie du texte
<a name="filter-and-modify-the-options-using-a-regex-capture-group-to-return-part-of-the-text"></a>

 Régex : 

```
/.*(01|02)/
```

 Résultat : 

```
01
02
```

#### Filtrer et modifier - Exemple Prometheus
<a name="filter-and-modify---prometheus-example"></a>

 Liste des options : 

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

 Régex : 

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

 Résultat : 

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

#### Filtrage et modification à l'aide de textes nommés et de groupes de capture de valeurs
<a name="filter-and-modify-using-named-text-and-value-capture-groups"></a>

À l'aide de groupes de capture nommés, vous pouvez capturer des parties « texte » et « valeur » distinctes à partir des options renvoyées par la requête variable. La liste déroulante des variables peut contenir un nom convivial pour chaque valeur pouvant être sélectionnée. 

 Par exemple, lorsque vous interrogez la métrique `node_hwmon_chip_names` Prometheus, la valeur est plus conviviale `chip_name` que la valeur. `chip` Commencez par le résultat de requête variable suivant. 

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

 Passez-le dans le Regex suivant. 

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

 La liste déroulante suivante est produite. 

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

 **Remarque :** seuls les noms de groupes de `value` capture `text` et de capture sont pris en charge. 

### Panneaux ou lignes répétitifs
<a name="repeat-panels-or-rows"></a>

 Vous pouvez créer des tableaux de bord dynamiques à l'aide de *variables de modèle*. Toutes les variables de vos requêtes sont étendues à la valeur actuelle de la variable avant que la requête ne soit envoyée à la base de données. Avec les variables, vous pouvez réutiliser un tableau de bord unique pour tous vos services. 

 Les variables de modèle peuvent être très utiles pour modifier dynamiquement vos requêtes sur l'ensemble d'un tableau de bord. Si vous souhaitez que Grafana crée dynamiquement de nouveaux panneaux ou lignes en fonction des valeurs que vous avez sélectionnées, vous pouvez utiliser la fonction *Répéter*. 

#### Panneaux répétitifs
<a name="repeating-panels"></a>

 Si une variable `Multi-value` ou des `Include all value` options sont activées, vous pouvez choisir un panneau et demander à Grafana de répéter ce panneau pour chaque valeur sélectionnée. Vous pouvez trouver la fonction de *répétition* sous l'*onglet Général* en mode édition du panneau. 

 Le `direction` contrôle la façon dont les panneaux sont disposés. 

Si vous le souhaitez`horizontal`, les panneaux sont disposés side-by-side. Grafana ajuste automatiquement la largeur de chaque panneau répété afin que toute la ligne soit remplie. À l'heure actuelle, vous ne pouvez pas mélanger d'autres panneaux d'une ligne avec un panneau répété. 

 Réglez `Max per row` cette option pour indiquer à Grafana le nombre maximum de panneaux par ligne que vous souhaitez. La valeur par défaut est *4*. 

Si vous le souhaitez`vertical`, les panneaux sont disposés de haut en bas dans une colonne. La largeur des panneaux répétés est la même que celle du premier panneau (le gabarit original) répété. 

Apportez des modifications uniquement au premier panneau (le modèle d'origine). Pour que les modifications prennent effet sur tous les panneaux, vous devez lancer une refonte dynamique du tableau de bord. Vous pouvez le faire soit en modifiant la valeur de la variable (c'est-à-dire la base de la répétition), soit en rechargeant le tableau de bord. 

**Note**  
Les panneaux récurrents nécessitent des variables pour qu'un ou plusieurs éléments soient sélectionnés. Vous ne pouvez pas répéter un panneau zéro fois pour le masquer.

#### Lignes répétitives
<a name="repeating-rows"></a>

 Comme indiqué ci-dessus, avec les panneaux, vous pouvez également répéter des lignes si vous avez défini des variables `Multi-value` ou une option `Include all value` de sélection. 

 Pour activer cette fonctionnalité, vous devez d'abord ajouter une nouvelle *ligne* à l'aide du menu *Ajouter un panneau*. Faites ensuite une pause sur le titre de la ligne et cliquez sur le bouton en forme de roue dentée pour accéder au panneau `Row Options` de configuration. Vous pouvez ensuite sélectionner la variable pour laquelle vous souhaitez répéter la ligne. 

 Il est recommandé d'utiliser également une variable dans le titre de la ligne. 

# Alerte Grafana
<a name="alerts-overview"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Les alertes Grafana vous fournissent des alertes robustes et exploitables qui vous aident à détecter les problèmes dans les systèmes quelques instants après leur survenue, minimisant ainsi les perturbations de vos services.

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. Il inclut les fonctionnalités suivantes :
+ Créez et gérez les alertes Grafana dans une vue centralisée.
+ Créez et gérez les alertes gérées par Cortex et Loki via une interface unique. Pour de plus amples informations, veuillez consulter [Gérez vos règles d'alerte](v9-alerting-managerules.md).
+ Consultez les informations d'alerte provenant de Prometheus, d'Amazon Managed Service for Prometheus et d'autres sources de données compatibles avec Alertmanager.
+ Créez plusieurs instances d'alerte à partir d'une seule règle d'alerte. Pour de plus amples informations, veuillez consulter [Règles uniques et multidimensionnelles](v9-alerting-managerules-grafana.md#v9-alerting-single-multi-rule).
+ Gérez vos ressources d'alerte avec Terraform ou Provisioning. APIs Pour de plus amples informations, veuillez consulter [Approvisionnement des ressources d'alerte Grafana](v9-alerting-setup-provision.md).

Pour l'espace de travail Amazon Managed Grafana existant, la valeur par défaut est. [Alertes classiques sur le tableau](old-alerts-overview.md) Pour migrer vers les alertes Grafana, vous devez migrer [vers les alertes Grafana](alert-opt-in.md).

Pour en savoir plus sur les alertes Grafana, consultez. [Nouveautés en matière d'alertes Grafana](alerts-whats-new.md)

Les alertes Grafana comportent quatre éléments clés :
+ [Règle d'alerte](alert-rules.md) : critères d'évaluation qui déterminent si une alerte est déclenchée. Il comprend une ou plusieurs requêtes et expressions, une condition, la fréquence d'évaluation et, éventuellement, la durée pendant laquelle la condition est remplie.
+ [Point de contact](alert-contact-points.md) : canal d'envoi de notifications lorsque les conditions d'une règle d'alerte sont remplies. 
+ [Politique de notification](alert-notifications.md) - Ensemble de critères de correspondance et de regroupement utilisés pour déterminer la fréquence des notifications.
+ [Silences](alert-silences.md) : date et critères de correspondance utilisés pour désactiver les notifications.

Lorsque les alertes Grafana sont activées, vous pouvez :
+ [Créez des règles d'alerte gérées par Grafana](alert-rules.md#create-grafana-alert-rule)
+ [Créez des règles d'alerte gérées par Cortex ou Loki](alert-rules.md#create-alert-rule)
+ [Afficher les règles d'alerte existantes et gérer leur état actuel](alert-rules.md#manage-alert-rules)
+ [Afficher l'état et l'état de santé des règles d'alerte](alert-fundamentals.md#alerts-state)
+ [Ajouter ou modifier un point de contact d'alerte](alert-contact-points.md#alert-working-contact-points)
+ [Ajouter ou modifier des politiques de notification](alert-notifications.md#alert-notifications-working)
+ [Ajouter ou modifier des silences](alert-silences.md)

## Limitations
<a name="alert-limitations"></a>
+ 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.
+ Les règles d'alerte définies dans Grafana, plutôt que dans Prometheus, envoient plusieurs notifications à votre point de contact. Si vous utilisez les alertes Grafana natives, nous vous recommandons de rester sur les alertes classiques du tableau de bord et de ne pas activer la nouvelle fonctionnalité d'alerte Grafana. Si vous souhaitez consulter les alertes définies dans votre source de données Prometheus, nous vous recommandons d'activer Grafana Alerting, qui n'envoie qu'une seule notification pour les alertes créées dans Prometheus Alertmanager.
**Note**  
Cette limitation n'est plus une limitation dans les espaces de travail Amazon Managed Grafana compatibles avec Grafana v10.4 et versions ultérieures.

**Topics**
+ [Limitations](#alert-limitations)
+ [Nouveautés en matière d'alertes Grafana](alerts-whats-new.md)
+ [Migration des alertes classiques du tableau de bord vers les alertes Grafana](alert-opt-in.md)
+ [Principes fondamentaux des alertes](alert-fundamentals.md)
+ [Création et gestion des règles d'alerte Grafana](alert-rules.md)
+ [Groupes d'alertes](alert-groups.md)
+ [Désactiver les notifications d'alerte pour les sources de données Prometheus](alert-silences.md)
+ [Travailler avec les points de contact](alert-contact-points.md)
+ [Utilisation de modèles de messagerie](alert-message-templates.md)
+ [Utilisation des politiques de notification](alert-notifications.md)

# Nouveautés en matière d'alertes Grafana
<a name="alerts-whats-new"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Les alertes Grafana présentent plusieurs améliorations par rapport aux alertes classiques du tableau de bord.

## Créez des alertes multidimensionnelles
<a name="alerts-new-dimensional"></a>

Vous pouvez désormais créer une règle d'alerte unique qui vous donne une visibilité à l'échelle du système, en générant 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.

**Note**  
Chaque instance d'alerte est prise en compte dans le quota d'alertes. Les règles multidimensionnelles qui créent un nombre d'instances supérieur au quota d'alerte ne sont pas évaluées et renvoient une erreur de quota. Pour de plus amples informations, veuillez consulter [Erreurs liées au quota atteint](alert-rules.md#rule-quota-reached).

## Créez des alertes en dehors des tableaux de bord
<a name="alerts-new-not-dashboard"></a>

Contrairement aux alertes classiques du 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 Loki et Cortex
<a name="alerts-new-loki-cortex"></a>

Dans les alertes Grafana, vous pouvez gérer les règles d'alerte Loki et Cortex à l'aide de la même interface utilisateur et de la même API que vos alertes gérées par Grafana.

## Afficher et rechercher des alertes provenant d'Amazon Managed Service pour Prometheus et d'autres sources de données compatibles avec Prometheus
<a name="alerts-new-prometheus"></a>

Les alertes pour Amazon Managed Service for Prometheus et les sources de données compatibles avec Prometheus sont désormais répertoriées dans l'interface d'alerte. 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="alerts-new-error"></a>

Les alertes Grafana génèrent des alertes spéciales portant les étiquettes suivantes, lorsque l'évaluation d'une règle d'alerte produit un état ou : `NoData` `Error`
+ `alertname`avec une valeur `DatasourceNoData` ou `DatasourceError` en fonction de l'état.
+ `rulename`avec le nom de la règle d'alerte à laquelle appartient l'alerte spéciale.
+ `datasource_uid`possède l'UID de la source de données à l'origine de l'état.
+ Toutes les étiquettes et annotations de la règle d'origine.

Vous pouvez gérer ces alertes de la même manière que les alertes ordinaires, par exemple en ajoutant un silence ou en les acheminant vers un point de contact.

**Note**  
Si la règle utilise plusieurs sources de données et qu'une ou plusieurs ne renvoient aucune donnée, l'alerte spéciale est créée pour chaque source de données à l'origine de l'état d'alerte.

# Migration des alertes classiques du tableau de bord vers les alertes Grafana
<a name="alert-opt-in"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Les espaces de travail existants, ou les espaces de travail qui choisissent de ne pas utiliser les alertes Grafana, utilisent les alertes classiques du tableau de bord. Pour migrer vers la nouvelle alerte Grafana, vous devez activer cette fonctionnalité.

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)

**Note**  
Lorsque vous utilisez les alertes Grafana, les règles d'alerte définies dans Grafana, plutôt que dans Prometheus, envoient plusieurs notifications à votre point de contact. Si vous utilisez les alertes Grafana natives, nous vous recommandons de rester sur les alertes classiques du tableau de bord et de ne pas activer la nouvelle fonctionnalité d'alerte Grafana. Si vous souhaitez consulter les alertes définies dans votre source de données Prometheus, nous vous recommandons d'activer Grafana Alerting, qui n'envoie qu'une seule notification pour les alertes créées dans Prometheus Alertmanager.  
Cette limitation est supprimée dans les espaces de travail Amazon Managed Grafana compatibles avec Grafana v10.4 et versions ultérieures.

## Migration vers le système d'alerte Grafana
<a name="alert-opt-in-migrating"></a>

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="alert-migration-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.

# Principes fondamentaux des alertes
<a name="alert-fundamentals"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Cette section fournit des informations sur les concepts fondamentaux des alertes Grafana.

## Concepts d'alerte
<a name="alert-fundamentals-terms"></a>

Le tableau suivant décrit les concepts clés des alertes Grafana.


| Concept ou fonctionnalité clé | Définition | 
| --- | --- | 
|  Sources de données pour les alertes  |  Sélectionnez les sources de données à partir desquelles vous souhaitez interroger et visualiser les métriques, les journaux et les traces.  | 
|  Planificateur  |  Évalue vos règles d'alerte ; il s'agit du composant qui exécute régulièrement des requêtes sur des sources de données. Elle ne s'applique qu'aux règles gérées par Grafana.  | 
|  Gestionnaire d'alertes  |  Gère le routage et le regroupement des instances d'alerte.  | 
|  Règle d'alerte  |  Ensemble de critères d'évaluation indiquant à quel moment une règle d'alerte doit être déclenchée. Une règle d'alerte comprend une ou plusieurs requêtes et expressions, une condition, la fréquence d'évaluation et la durée pendant laquelle la condition est remplie. Une règle d'alerte peut produire plusieurs instances d'alerte.  | 
|  Instance d'alerte  |  Une instance d'alerte est une instance d'une règle d'alerte. Une règle d'alerte unidimensionnelle possède une instance d'alerte. Une règle d'alerte multidimensionnelle comporte une ou plusieurs instances d'alerte. Une seule règle d'alerte qui correspond à plusieurs résultats, tels que le nombre de processeurs par rapport à 10 VMs, est comptée comme plusieurs instances d'alerte (dans ce cas, 10). Ce nombre peut varier au fil du temps. Par exemple, une règle d'alerte qui surveille l'utilisation du processeur pour tous les VMs membres d'un système comporte davantage d'instances d'alerte au fur et à mesure qu' VMs elles sont ajoutées. Pour plus d'informations sur les quotas d'instance d'alerte, consultez. [Erreurs liées au quota atteint](alert-rules.md#rule-quota-reached)  | 
|  Groupe d'alertes  |  L'Alertmanager regroupe les instances d'alerte par défaut en utilisant les étiquettes de la politique de notification racine. Cela permet de contrôler la déduplication et les groupes d'instances d'alerte envoyés aux points de contact.  | 
|  Point de contact  |  Définissez la manière dont vos contacts sont avertis lorsqu'une règle d'alerte est déclenchée.  | 
|  Modélisation de messages  |  Créez des modèles personnalisés réutilisables et utilisez-les dans les points de contact.  | 
|  Politique de notification  |  Ensemble de règles indiquant où, quand et comment les alertes sont regroupées et acheminées vers les points de contact.  | 
|  Étiquettes et dispositifs d'appariement  |  Les étiquettes identifient de manière unique les règles d'alerte. Ils relient les règles d'alerte aux politiques de notification et aux silences, afin de déterminer quelle politique doit les gérer et quelles règles d'alerte doivent être réduites au silence.  | 
|  Silences  |  Arrêtez les notifications provenant d'une ou de plusieurs instances d'alerte. La différence entre un temps de silence et un temps de sourdine réside dans le fait qu'un silence dure pendant une période spécifiée, pendant laquelle un temps de silence se produit selon un calendrier récurrent. Utilise des analyseurs d'étiquettes pour désactiver les instances d'alerte.  | 
|  Horaire du mode muet  |  Spécifiez un intervalle de temps pendant lequel vous ne souhaitez pas que de nouvelles notifications soient générées ou envoyées. Vous pouvez geler les notifications d'alerte pendant des périodes récurrentes, par exemple pendant une période de maintenance. Doit être lié à une politique de notification existante.  | 

## Sources de données d'alerte
<a name="alert-sources"></a>

Les alertes gérées par Grafana interrogent les sources de données principales suivantes pour lesquelles les alertes sont activées.
+ Sources de données intégrées, ou développées et gérées par Grafana :`Alertmanager`,`Graphite`, `Prometheus` (y compris Amazon Managed Service for Prometheus),,,,,`Loki`,`InfluxDB`,`Amazon OpenSearch Service`,`Google Cloud Monitoring`,, `Amazon CloudWatch` `Azure Monitor``MySQL`, `PostgreSQL` et. `MSSQL` `OpenTSDB` `Oracle` `Azure Monitor`

## Alertes sur les données numériques
<a name="alert-numeric"></a>

Les données numériques qui ne sont pas au format de série chronologique peuvent être directement alertées ou transmises aux expressions côté serveur. 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="alert-tabular-data"></a>

Cette fonctionnalité est prise en charge par les sources de données principales qui interrogent des données tabulaires, notamment les sources de données SQL, telles que MySQL, Postgres, MSSQL et Oracle.

Une requête contenant des alertes gérées par Grafana ou des expressions côté serveur est considérée comme numérique avec les sources de données suivantes :
+ Si l'`Format AS`option est définie sur `Table` dans la requête de source de données.
+ Si la réponse de table renvoyée à Grafana par la requête ne comprend qu'une seule colonne numérique (par exemple, int, double ou 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 de la 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 par son étiquette.

### Exemple
<a name="alert-tabular-example"></a>

Si vous avez une table MySQL appelée Diskspace, comme suit.


| 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 lancée par hôte ou disque lorsqu'il y a moins de 5 % d'espace libre peut ressembler à ce qui suit.

```
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 du tableau suivant à 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, les cas où la valeur est différente de zéro sont une alerte. Par conséquent, trois instances d'alerte sont produites, comme indiqué dans le tableau suivant.


| Étiquettes | Statut | 
| --- | --- | 
|  \$1Host=Web1, disk=/etc\$1  |  Alerte  | 
|  \$1Host=Web2, disk=/var\$1  |  Alerte  | 
|  \$1Host=Web3, disk=/var\$1  |  Normal  | 

## Gestionnaire d'alertes
<a name="alert-alertmanager"></a>

Grafana inclut un support intégré pour Prometheus Alertmanager. L'Alertmanager permet à la fois de regrouper et de gérer les règles d'alerte, en ajoutant une couche d'orchestration au-dessus des moteurs d'alerte. Par défaut, les notifications relatives aux alertes gérées par Grafana sont gérées par le gestionnaire d'alertes intégré qui fait partie du noyau de Grafana. Vous pouvez configurer les points de contact, les politiques de notification et les modèles du gestionnaire d'alertes à partir de l'interface utilisateur d'alerte Grafana en sélectionnant l'option Grafana dans la liste déroulante du gestionnaire d'alertes.

Les alertes Grafana prennent en charge la configuration externe d'Alertmanager (pour plus d'informations sur Alertmanager en tant que source de données externe, voir). [Se connecter à une source de données Alertmanager](data-source-alertmanager.md) Lorsque vous ajoutez un Alertmanager externe, le menu déroulant Alertmanager affiche une liste des sources de données Alertmanager externes disponibles. Sélectionnez une source de données pour créer et gérer des alertes pour les sources de données Cortex ou Loki autonomes.

## État et état des règles d'alerte
<a name="alerts-state"></a>

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 l'alerte, l'état de la règle d'alerte et l'état de la règle d'alerte. Bien que lié, chaque composant transmet des informations légèrement différentes.

**État de la règle d'alerte**
+ **Normal** — Aucune des séries chronologiques renvoyées par le moteur d'évaluation n'est à `Firing` l'état `Pending` or.
+ **En attente** — Au moins l'une des séries chronologiques renvoyées par le moteur d'évaluation est`Pending`.
+ Mise à **feu** — Au moins l'une des séries chronologiques renvoyées par le moteur d'évaluation est`Firing`.

**État de l'alerte**
+ **Normal** — La condition de la règle d'alerte est **fausse** pour chaque série chronologique renvoyée par le moteur d'évaluation.
+ **Alerte** : la condition de la règle d'alerte est **vraie** pour au moins une série chronologique renvoyée par le moteur d'évaluation. Durée pendant laquelle la condition doit être vraie avant qu'une alerte ne soit déclenchée, si elle est définie, si elle est remplie ou si elle est dépassée.
+ **En attente** : la condition de la règle d'alerte est **vraie** pour au moins une série chronologique renvoyée par le moteur d'évaluation. La durée pendant laquelle la condition doit être vraie avant qu'une alerte ne soit déclenchée, si elle est définie, n'est pas remplie.
+ **NoData**— La règle d'alerte n'a renvoyé aucune série chronologique, toutes les valeurs de la série chronologique sont nulles ou toutes les valeurs de la série chronologique sont nulles.
+ **Erreur** : erreur lors de la tentative d'évaluation d'une règle d'alerte.

**État des règles d'alerte**
+ **Ok** — Aucune erreur lors de l'évaluation d'une règle d'alerte.
+ **Erreur** : erreur lors de l'évaluation d'une règle d'alerte.
+ **NoData**— L'absence de données dans au moins une série chronologique renvoyée lors de l'évaluation d'une règle.

# Création et gestion des règles d'alerte Grafana
<a name="alert-rules"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Une règle d'alerte est un ensemble de critères d'évaluation qui déterminent si une alerte est déclenchée. La règle comprend une ou plusieurs requêtes et expressions, une condition, la fréquence d'évaluation et éventuellement la durée pendant laquelle la condition est remplie.

Alors que les requêtes et les expressions sélectionnent l'ensemble de données à évaluer, une condition définit le seuil qu'une alerte doit 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 peuvent également définir le comportement d'alerte en l'absence de données.

Les sections suivantes décrivent la création et la gestion de différents types de règles d'alerte Grafana.

**Topics**
+ [Création de règles d'alerte gérées par Cortex ou Loki](#create-alert-rule)
+ [Création de règles d'enregistrement gérées par Cortex ou Loki](#create-alert-recording-rule)
+ [Création de règles d'alerte gérées par Grafana](#create-grafana-alert-rule)
+ [Annotations et étiquettes pour les règles d'alerte](#alert-rule-labels)
+ [Gestion des règles d'alerte](#manage-alert-rules)
+ [Groupes de règles et espaces de noms Cortex ou Loki](#alert-rule-groups)

## Création de règles d'alerte gérées par Cortex ou Loki
<a name="create-alert-rule"></a>

Grafana vous permet de créer des règles d'alerte pour une instance externe de Cortex ou Loki.

**Note**  
Cortex est la base de données de séries chronologiques utilisée par Amazon Managed Service pour les sources de données Prometheus et Prometheus.

**Conditions préalables**
+ Vérifiez que vous disposez des autorisations d'écriture sur la source de données Prometheus. Dans le cas contraire, vous ne pourrez pas créer ou mettre à jour les règles d'alerte gérées par Cortex.
+ Pour les sources de données Cortex 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.
  + **Cortex** — N'utilisez pas `/prometheus` l'ancien `/api/prom` préfixe. La source de données Prometheus prend en charge Cortex 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 ajouter une règle d'alerte gérée par Cortex ou Loki**

1. Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte (cloche) pour ouvrir la page d'alerte répertoriant** les **alertes** existantes.

1. Choisissez **Nouvelle règle d'alerte**.

1. À **l'étape 1**, ajoutez le nom, le type et l'emplacement de stockage de la règle, comme suit :
   + Dans **Nom de la règle**, ajoutez un nom descriptif. 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.
   + Dans le menu déroulant **Type de règle**, sélectionnez Alerte gérée par **Cortex/Loki**.
   + **Dans le menu déroulant Sélectionner une source de données**, sélectionnez une source de données Prometheus ou Loki.
   + Dans le menu déroulant **Namespace**, sélectionnez un espace de noms de règles existant. Sinon, choisissez **Ajouter nouveau** et entrez un nom pour en créer un. Les espaces de noms peuvent contenir un ou plusieurs groupes de règles et n'ont qu'un objectif organisationnel. Pour de plus amples informations, veuillez consulter [Groupes de règles et espaces de noms Cortex ou Loki](#alert-rule-groups).
   + Dans le menu déroulant **Groupe**, sélectionnez un groupe existant dans l'espace de noms sélectionné. Sinon, choisissez **Ajouter nouveau** et entrez un nom pour en créer un. Les règles nouvellement créées sont ajoutées à la fin du groupe. Les règles d'un groupe s'exécutent séquentiellement à intervalles réguliers, avec le même temps d'évaluation.

1. À **l'étape 2**, ajoutez la requête à évaluer.

   La valeur peut être une expression ProMQL ou LogQL. La règle déclenche une alerte si le résultat de l'évaluation comporte au moins une série dont la valeur est supérieure à 0. Une alerte est créée pour chaque série.

1. À **l'étape 3**, ajoutez des conditions.

   Dans la zone de texte Pour de la condition, spécifiez la durée pendant laquelle la condition doit être vraie avant que l'alerte ne soit déclenchée. Si vous le spécifiez`5m`, les conditions doivent être vraies pendant cinq minutes avant que l'alerte ne soit déclenchée.
**Note**  
Une fois qu'une condition est remplie, l'alerte passe à `Pending` l'état. Si la condition reste active pendant la durée spécifiée, l'alerte passe à l'`Firing`état. S'il n'est plus atteint, il revient à l'`Normal`état.

1. À **l'étape 4**, ajoutez des métadonnées supplémentaires associées à la règle.
   + Ajoutez une description et un résumé pour personnaliser les messages d'alerte. Utilisez les directives dans[Annotations et étiquettes pour les règles d'alerte](#alert-rule-labels).
   + Ajoutez l'URL, le panneau, le tableau de bord et l'alerte IDs Runbook.
   + Ajoutez des étiquettes personnalisées.

1. Choisissez **Prévisualiser les alertes** pour évaluer la règle et voir quelles alertes elle produirait. Il affiche une liste d'alertes avec l'état et la valeur de chacune d'entre elles.

1. Choisissez **Enregistrer** pour enregistrer la règle ou **Enregistrer et quitter** pour enregistrer la règle et revenir à la page **d'alerte**.

## Création de règles d'enregistrement gérées par Cortex ou Loki
<a name="create-alert-recording-rule"></a>

Vous pouvez créer et gérer des règles d'enregistrement pour une instance externe de Cortex ou de 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.

**Conditions préalables**

Pour les sources de données Cortex 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.
+ **Cortex** — Lorsque vous configurez une source de données Grafana Prometheus pour qu'elle pointe vers Cortex, utilisez l'ancien préfixe et non. `/api/prom` `/prometheus` La source de données Prometheus prend en charge Cortex 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 ajouter une règle d'enregistrement géré par Cortex ou Loki**

1. Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte (cloche) pour ouvrir la page d'alerte répertoriant** les **alertes** existantes.

1. Choisissez **Nouvelle règle d'alerte**.

1. À **l'étape 1**, ajoutez le nom, le type et l'emplacement de stockage de la règle, comme suit.
   + Dans **Nom de la règle**, ajoutez un nom descriptif. 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.
   + Dans le menu déroulant **Type de règle**, sélectionnez Alerte gérée par **Cortex/Loki**.
   + **Dans le menu déroulant Sélectionner une source de données**, sélectionnez une source de données Prometheus ou Loki.
   + Dans le menu déroulant **Namespace**, sélectionnez un espace de noms de règles existant. Sinon, choisissez **Ajouter nouveau** et entrez un nom pour en créer un. Les espaces de noms peuvent contenir un ou plusieurs groupes de règles et n'ont qu'un objectif organisationnel. Pour de plus amples informations, veuillez consulter [Groupes de règles et espaces de noms Cortex ou Loki](#alert-rule-groups).
   + Dans le menu déroulant **Groupe**, sélectionnez un groupe existant dans l'espace de noms sélectionné. Sinon, choisissez **Ajouter nouveau** et entrez un nom pour en créer un. Les règles nouvellement créées sont ajoutées à la fin du groupe. Les règles d'un groupe s'exécutent séquentiellement à intervalles réguliers, avec le même temps d'évaluation.

1. À **l'étape 2**, ajoutez la requête à évaluer.

   La valeur peut être une expression ProMQL ou LogQL. La règle déclenche une alerte si le résultat de l'évaluation comporte au moins une série dont la valeur est supérieure à 0. Une alerte est créée pour chaque série.

1. À **l'étape 3**, ajoutez des métadonnées supplémentaires associées à la règle.
   + Ajoutez une description et un résumé pour personnaliser les messages d'alerte. Utilisez les directives dans[Annotations et étiquettes pour les règles d'alerte](#alert-rule-labels).
   + Ajoutez l'URL, le panneau, le tableau de bord et l'alerte IDs Runbook.
   + Ajoutez des étiquettes personnalisées.

1. Choisissez **Enregistrer** pour enregistrer la règle ou **Enregistrer et quitter** pour enregistrer la règle et revenir à la page **d'alerte**.

## Création de règles d'alerte gérées par Grafana
<a name="create-grafana-alert-rule"></a>

Grafana vous permet de créer des règles d'alerte qui interrogent une ou plusieurs sources de données, réduisent ou transforment les résultats et les comparent entre eux ou fixent des seuils. Lorsque celles-ci sont traitées, Grafana envoie des notifications au point de contact.

**Note**  
La création de règles d'alerte gérées par Grafana lors de l'utilisation des alertes Grafana entraîne l'envoi de plusieurs notifications lorsque la règle correspond. Certains fournisseurs de points de contact peuvent disposer d'options configurables pour dédupliquer les notifications.

**Pour ajouter une règle gérée par Grafana**

1. Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte (cloche) pour ouvrir la page d'alerte répertoriant** les **alertes** existantes.

1. Choisissez **Nouvelle règle d'alerte**.

1. À **l'étape 1**, ajoutez le nom, le type et l'emplacement de stockage de la règle, comme suit :
   + Dans **Nom de la règle**, ajoutez un nom descriptif. 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.
   + Dans la liste déroulante **Type de règle**, sélectionnez Alerte gérée par **Grafana**.
   + Dans le menu déroulant **Dossier**, sélectionnez le dossier dans lequel vous souhaitez stocker la règle. Si vous ne sélectionnez aucun dossier, la règle est enregistrée dans le `General` dossier. Pour créer un dossier, sélectionnez le menu déroulant et entrez un nouveau nom de dossier.

1. À **l'étape 2**, ajoutez les requêtes et les expressions à évaluer.
   + Conservez le nom par défaut ou passez la souris dessus et cliquez sur l'icône d'édition pour modifier le nom.
   + Pour les requêtes, sélectionnez une source de données dans le menu déroulant.
   + Ajoutez une ou plusieurs [requêtes](panel-queries.md) ou expressions (pour plus de détails sur les expressions, voir [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dans la *documentation de Grafana*).
   + 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** ou **Rééchantillonner** pour générer des alertes distinctes pour chaque série. Pour plus de détails sur ces options, consultez[Règles uniques et multidimensionnelles](#single-multi-rule).
   + Choisissez **Exécuter les requêtes** pour vérifier que la requête est réussie.

1. À **l'étape 3**, ajoutez des conditions.
   + Dans le menu déroulant **Condition**, sélectionnez la requête ou l'expression pour lancer la règle d'alerte.
   + Pour **Evaluer chaque**, spécifiez la fréquence d'évaluation. Ce doit être un multiple de 10 secondes. Par exemple, `1m`, `30s`.
   + Pour **Evaluer pour**, spécifiez la durée pendant laquelle la condition doit être vraie avant qu'une alerte ne soit déclenchée.
**Note**  
Lorsqu'une condition est violée, l'alerte passe à `Pending` l'état. Si la condition reste violée pendant la durée spécifiée, l'alerte passe à l'`Firing`état. S'il n'est plus atteint, il revient à l'`Normal`état.
   + 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 instructions contenues dans. [Gestion de l'absence de données ou des cas d'erreur](#rule-no-data-error)
   + Choisissez **Prévisualiser les alertes** pour vérifier le résultat de l'exécution de la requête en ce moment. L'aperçu exclut l'absence de données et les conditions de gestion des erreurs.

1. À **l'étape 4**, ajoutez des métadonnées supplémentaires associées à la règle.
   + Ajoutez une description et un résumé pour personnaliser les messages d'alerte. Utilisez les directives dans[Annotations et étiquettes pour les règles d'alerte](#alert-rule-labels).
   + Ajoutez l'URL, le panneau, le tableau de bord et l'alerte IDs Runbook.
   + Ajoutez des étiquettes personnalisées.

1. Choisissez **Enregistrer** pour enregistrer la règle ou **Enregistrer et quitter** pour enregistrer la règle et revenir à la page **d'alerte**.

### Règles uniques et multidimensionnelles
<a name="single-multi-rule"></a>

Pour les règles d'alerte 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 unidimensionnelle (condition classique)**

Utilisez une 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.

Pour plus d'informations sur le formatage des expressions, voir [Expressions](https://grafana.com/docs/grafana/next/panels/query-a-data-source/) dans la documentation de *Grafana*.

**Règle multidimensionnelle**

Pour générer une instance d'alerte distincte pour chaque série renvoyée dans la requête, créez une règle multidimensionnelle.

**Note**  
Chaque instance d'alerte générée par une règle multidimensionnelle est prise en compte dans votre quota total d'alertes. Les règles ne sont pas évaluées lorsque vous atteignez votre quota d'alertes. Pour plus d'informations sur les quotas pour les règles multidimensionnelles, consultez[Erreurs liées au quota atteint](#rule-quota-reached).

Pour créer plusieurs instances à partir d'une seule règle `Math``Reduce`, utilisez ou `Resample` expressions pour créer une règle multidimensionnelle. Par exemple, vous pouvez effectuer les actions suivantes :
+ 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. (Non nécessaire pour les [règles utilisant des données numériques](alert-fundamentals.md#alert-numeric)).
+ Ajoutez une `Math` expression avec la condition de la règle. Cela n'est pas nécessaire si une requête ou une expression de réduction renvoie déjà 0 si la règle ne doit pas déclencher d'alerte, ou un nombre positif si elle doit lancer une alerte. 

  Voici quelques exemples : 
  + `$B > 70`s'il doit lancer une alerte si la valeur de B query/expression est supérieure à 70. 
  + `$B < $C * 100`au cas où il devrait déclencher une alerte 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. Plus d'informations sont disponibles sur la page de communauté Les [variables de modèle ne sont pas prises en charge dans les requêtes d'alerte lors de la configuration d'Alert](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514).



**Considérations relatives aux performances pour les règles multidimensionnelles**

Chaque instance d'alerte est prise en compte dans le quota d'alertes. Les règles multidimensionnelles qui créent un nombre d'instances supérieur au quota d'alerte ne sont pas évaluées et renvoient une erreur de quota. Pour de plus amples informations, veuillez consulter [Erreurs liées au quota atteint](#rule-quota-reached).

Les alertes multidimensionnelles peuvent avoir un impact important sur les performances de votre espace de travail Grafana, ainsi que sur les performances de vos sources de données lorsque Grafana les interroge pour évaluer vos règles d'alerte. Les considérations suivantes peuvent être utiles lorsque vous essayez d'optimiser les performances de votre système de surveillance.
+ **Fréquence d'évaluation des règles** — La propriété **Evaluer chaque** règle d'alerte contrôle la fréquence d'évaluation des règles. Nous recommandons d'utiliser la fréquence d'évaluation la plus basse acceptable. 
+ **Cardinalité de l'ensemble de résultats** : le nombre d'instances d'alerte que vous créez avec une règle influe sur ses performances. Supposons que vous surveillez les erreurs de réponse d'API pour chaque chemin d'API, sur chaque machine virtuelle de votre parc. Cet ensemble a pour cardinalité le nombre de chemins multiplié par le nombre de VMs. Vous pouvez réduire la cardinalité du jeu de résultats, par exemple en surveillant le nombre total d'erreurs par machine virtuelle plutôt que par chemin par machine virtuelle.
+ **Complexité de la requête** : les requêtes que les sources de données peuvent traiter et auxquelles elles peuvent répondre rapidement consomment moins de ressources. Bien que cette considération soit moins importante que les autres considérations répertoriées ci-dessus, si vous les réduisez autant que possible, l'examen des performances de chaque requête peut faire la différence. Vous devez également être conscient de l'impact de l'évaluation de ces règles sur les performances de vos sources de données. Les requêtes d'alerte constituent souvent la grande majorité des requêtes traitées par les bases de données de surveillance, de sorte que les mêmes facteurs de charge qui affectent l'instance de Grafana les affectent également.

### Erreurs liées au quota atteint
<a name="rule-quota-reached"></a>

Il existe un quota pour le nombre d'instances d'alerte que vous pouvez avoir dans un même espace de travail. Lorsque vous atteignez ce nombre, vous ne pouvez plus créer de nouvelles règles d'alerte dans cet espace de travail. Avec les alertes multidimensionnelles, le nombre d'instances d'alerte peut varier dans le temps.

Il est important de garder à l'esprit les points suivants lorsque vous travaillez avec des instances d'alerte.
+ Si vous créez uniquement des règles unidimensionnelles, chaque règle est une instance d'alerte unique. Vous pouvez créer le même nombre de règles dans un même espace de travail que votre quota d'instance d'alerte, mais pas plus.
+ Les règles multidimensionnelles créent plusieurs instances d'alerte, mais leur nombre n'est pas connu tant qu'elles ne sont pas évaluées. Par exemple, si vous créez une règle d'alerte qui suit l'utilisation du processeur de vos instances Amazon EC2, il se peut qu'il y ait 50 instances EC2 lorsque vous la créez (et donc 50 instances d'alerte), mais si vous ajoutez 10 instances EC2 supplémentaires une semaine plus tard, l'évaluation suivante comportera 60 instances d'alerte.

  Le nombre d'instances d'alerte est évalué lorsque vous créez une alerte multidimensionnelle, et vous ne pouvez pas en créer une qui vous fasse immédiatement dépasser votre quota d'instances d'alerte. Le nombre d'instances d'alerte pouvant changer, votre quota est vérifié chaque fois que vos règles sont évaluées.
+ Au moment de l'évaluation d'une règle, si une règle vous oblige à dépasser votre quota d'instances d'alerte, cette règle n'est pas évaluée tant qu'une mise à jour n'est pas apportée à la règle d'alerte qui ramène le nombre total d'instances d'alerte en dessous du quota de service. Dans ce cas, vous recevez une notification d'alerte vous informant que votre quota a été atteint (la notification utilise la politique de notification de la règle en cours d'évaluation). La notification inclut une `Error` annotation avec la valeur`QuotaReachedError`.
+ Règle qui entraîne l'évaluation d'un `QuotaReachedError` arrêt. L'évaluation ne reprend que lorsqu'une mise à jour est effectuée et l'évaluation après la mise à jour ne provoque pas elle-même de`QuotaReachedError`. Une règle qui n'est pas en cours d'évaluation indique l'erreur **Quota atteint** dans la console Grafana.
+ Vous pouvez réduire le nombre d'instances d'alerte en supprimant les règles d'alerte ou en modifiant les alertes multidimensionnelles afin de réduire le nombre d'instances d'alerte (par exemple, en ayant une alerte sur les erreurs par machine virtuelle, plutôt qu'une alerte sur les erreurs par API dans une machine virtuelle).
+ Pour reprendre les évaluations, mettez à jour l'alerte et enregistrez-la. Vous pouvez le mettre à jour pour réduire le nombre d'instances d'alerte, ou si vous avez apporté d'autres modifications pour réduire le nombre d'instances d'alerte, vous pouvez l'enregistrer sans le modifier. Si elle peut être reprise, elle l'est. Si cela en cause un autre`QuotaReachedError`, vous ne pouvez pas l'enregistrer.
+ Lorsqu'une alerte est enregistrée et reprend son évaluation sans dépasser le quota d'alertes, l'erreur **Quota atteint** peut continuer à s'afficher dans la console Grafana pendant un certain temps (jusqu'à son intervalle d'évaluation). Cependant, l'évaluation des règles d'alerte démarre et des alertes sont envoyées si le seuil de la règle est atteint.
+ Pour plus de détails sur le quota d'alertes, ainsi que sur les autres quotas, consultez[Quotas de service Amazon Managed Grafana](AMG_quotas.md).

### Gestion de l'absence de données ou des cas d'erreur
<a name="rule-no-data-error"></a>

Choisissez des options pour gérer le comportement des alertes en l'absence de données ou en cas d'erreur.

Les options permettant de ne traiter aucune donnée sont répertoriées dans le tableau suivant.


| Option « Aucune donnée » | Comportement | 
| --- | --- | 
|  Aucune donnée  |  Créez une 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éfinissez l'état de la règle d'alerte sur`Alerting`.  | 
|  OK  |  Définissez l'état de la règle d'alerte sur`Normal`.  | 

Les options de gestion des cas d'erreur sont répertoriées dans le tableau suivant.


| Option d'erreur ou de délai d'expiration | Comportement | 
| --- | --- | 
|  Alerte  |  Définissez l'état de la règle d'alerte sur `Alerting`  | 
|  OK  |  Définissez l'état de la règle d'alerte sur `Normal`  | 
|  Erreur  |  Créez une 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.  | 

## Annotations et étiquettes pour les règles d'alerte
<a name="alert-rule-labels"></a>

Les annotations et les étiquettes sont des paires clé-valeur associées aux alertes provenant de la règle d'alerte, de la réponse de la source de données et de l'évaluation de la règle d'alerte. Ils peuvent être utilisés directement dans les notifications d'alerte ou dans les [modèles](alert-message-templates.md) et les [fonctions des modèles](alert-message-templates.md#alert-template-functions) pour créer un contact de notification de manière dynamique.

**Annotations**

Les annotations sont des paires clé-valeur qui fournissent des informations supplémentaires sur une alerte. Vous pouvez utiliser les annotations suivantes :`description`,`summary`,`runbook_url`, `alertId``dashboardUid`, et`panelId`. Ils sont affichés dans les détails des règles et des alertes dans l'interface utilisateur et peuvent être utilisés dans les modèles de messages des points de contact.

**Etiquettes**

Les étiquettes sont des paires clé-valeur qui contiennent des informations sur une alerte. L'étiquette définie pour une alerte est générée et complétée tout au long du processus d'évaluation et de notification des alertes. Ils sont utilisés de la manière suivante.
+ L'ensemble complet d'étiquettes d'une alerte identifie de manière unique cette alerte dans Grafana Alerts.
+ [Le gestionnaire d'alertes utilise des étiquettes pour faire correspondre les alertes relatives aux [silences](alert-silences.md) et aux [groupes d'alertes](alert-groups.md) dans les politiques de notification.](alert-notifications.md)
+ L'interface utilisateur d'alerte affiche des étiquettes pour chaque instance d'alerte générée par 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.
+ Des étiquettes peuvent être ajoutées à une [règle d'alerte](#alert-rules). Ces étiquettes configurées manuellement peuvent utiliser des fonctions de modèle et faire référence à d'autres étiquettes. Les étiquettes ajoutées à une règle d'alerte ici sont prioritaires en cas de collision entre étiquettes.

Les variables de modèle suivantes sont disponibles lorsque vous développez des annotations et des étiquettes.


| Nom | Description | 
| --- | --- | 
|  `$labels`  |  Les libellés de la requête ou de la condition. Par exemple : `{{ $labels.instance }}` et `{{ $labels.job }}`. Cette option n'est pas disponible lorsque la règle utilise une condition classique.  | 
|  `$values`  |  Les valeurs de toutes les expressions mathématiques et de réduction évaluées pour cette règle d'alerte. Par exemple`{{ $values.A }}`, `{{ $values.A.Labels }}` et `{{ $values.A.Value }}` où `A` est le `refID` de l'expression. Ceci n'est pas disponible lorsque la règle utilise une condition classique  | 
|  `$value`  |  Chaîne de valeur de l'instance d'alerte. Par exemple, `[ var='A' labels={instance=foo} value=10 ]`.  | 

## Gestion des règles d'alerte
<a name="manage-alert-rules"></a>



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, et la section **Cortex/Loki** répertorie les règles relatives aux sources de données compatibles avec Prometheus. Vous pouvez consulter les règles d'alerte pour les sources de données compatibles avec Prometheus, mais vous ne pouvez pas les modifier.

### Afficher les règles d'alerte
<a name="manage-alerts-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 l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.** Par défaut, les règles sont affichées par groupes par type de source de données. Vous pouvez également consulter l'état actuel de chaque alerte (ces informations sont décrites plus en détail dans le texte suivant).

1. Dans **Afficher sous**, vous pouvez basculer entre les vues de groupe et d'état en choisissant l'option que vous préférez.

1. Cliquez sur la flèche à côté d'une ligne pour afficher plus de détails sur cette ligne. Les détails d'une règle incluent les étiquettes des règles, les annotations, les sources de données et les requêtes, ainsi qu'une liste des instances d'alerte résultant de la règle.

**Vue de groupe**

La vue de groupe 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 d'alerte de filtrage**

Vous pouvez filtrer les règles d'alerte qui apparaissent sur la page **Alertes de** plusieurs manières.
+ Vous pouvez filtrer pour afficher les règles qui interrogent une source de données spécifique en choisissant **Sélectionner les sources de données**, puis en sélectionnant une source de données sur laquelle filtrer.
+ Vous pouvez filtrer par étiquette en choisissant des critères de recherche dans **Rechercher par étiquette**. Certains exemples de critères incluent`environment=production`,`region=~US|EU`,`severity!=warning`.
+ Vous pouvez filtrer pour afficher les règles dans un état spécifique en choisissant **Filtrer les alertes par état**, puis en sélectionnant l'état que vous souhaitez afficher.

### Modifier ou supprimer des règles d'alerte
<a name="manage-alerts-edit"></a>

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. Les règles d'alerte pour une instance externe de Cortex ou Loki peuvent être modifiées ou supprimées par les utilisateurs ayant des rôles d'éditeur ou d'administrateur.

**Pour modifier ou supprimer une règle**

1. Développez une règle jusqu'à ce que vous puissiez voir les commandes de règle pour **Afficher**, **Modifier** et **Supprimer**.

1. Choisissez **Modifier** pour ouvrir la page de création de règles. Effectuez les mises à jour de la même manière que vous créez une règle. Pour plus de détails, consultez les instructions figurant dans [Création de règles d'alerte gérées par Grafana](#create-grafana-alert-rule) ou[Création de règles d'alerte gérées par Cortex ou Loki](#create-alert-rule).

1. Choisissez éventuellement **Supprimer** pour supprimer une règle.

## Groupes de règles et espaces de noms Cortex ou Loki
<a name="alert-rule-groups"></a>

Vous pouvez organiser vos règles. Les règles sont créées au sein de groupes de règles, et les groupes de règles sont organisés en espaces de noms. Les règles d'un groupe de règles 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 Cortex ou Loki, et modifier les intervalles d'évaluation des groupes de règles.

**Pour modifier un groupe de règles ou un espace de noms**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**

1. Accédez à une règle au sein du groupe de règles ou de l'espace de noms que vous souhaitez modifier.

1. Choisissez l'icône **Modifier** (stylo).

1. Apportez des modifications au groupe de règles ou à l'espace de noms.
**Note**  
Pour les espaces de noms, vous ne pouvez modifier que le nom. Pour les groupes de règles, vous modifiez le nom ou l'intervalle d'évaluation des règles du groupe. Par exemple, vous pouvez `1m` choisir d'évaluer les règles une fois par minute ou `30s` toutes les 30 secondes.

1. Sélectionnez **Enregistrer les modifications**.

# Groupes d'alertes
<a name="alert-groups"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Les groupes d'alertes affichent les alertes groupées provenant d'une instance d'Alertmanager. Par défaut, les alertes sont regroupées selon les clés d'étiquette de la politique racine dans[Utilisation des politiques de notification](alert-notifications.md). Le regroupement des alertes communes dans un seul groupe d'alertes empêche le lancement d'alertes dupliquées.

**Pour afficher les groupes d'alertes**

1. Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche), puis l'élément de **regroupement d'alertes** pour ouvrir la page répertoriant les groupes existants.

1. Dans le menu déroulant **Alertmanager**, sélectionnez un Alertmanager externe comme source de données. Par défaut, le `Grafana` gestionnaire d'alertes est sélectionné.

1. Dans le menu déroulant **personnalisé**, sélectionnez une combinaison d'étiquettes pour afficher un regroupement autre que celui par défaut. Vous pouvez utiliser cette vue pour déboguer ou vérifier votre regroupement de politiques de notification.

Les alertes sans étiquette spécifiée dans le regroupement de la politique racine ou dans le regroupement personnalisé sont ajoutées à un groupe avec un en-tête de`No grouping`.

**Filtrer les alertes**

Vous pouvez utiliser les filtres suivants pour afficher les alertes correspondant à des critères spécifiques :
+ **Recherche par étiquette** : dans **Rechercher**, entrez une étiquette existante pour afficher les alertes correspondant à cette étiquette. Par exemple, `environment=production`, `region=~US|EU`, `severity!=warning`.
+ **Filtrer les alertes par état** : dans **États**, sélectionnez parmi `Active``Suppressed`, ou `Unprocessed` états pour afficher les alertes correspondant à cet état.

# Désactiver les notifications d'alerte pour les sources de données Prometheus
<a name="alert-silences"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

*Pour les sources de données Alertmanager externes (y compris Amazon Managed Service for Prometheus), vous pouvez supprimer les notifications d'alerte en les taisant.* 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.

Vous pouvez configurer des silences pour une source de données externe d'Alertmanager.

**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](alert-notifications.md#alert-notification-muting) plutôt que des silences.

**Pour ajouter un silence**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**

1. Choisissez **Silences** pour ouvrir une page répertoriant les [points de contact](alert-contact-points.md) existants.

1. Choisissez le gestionnaire d'alertes externe dans la liste déroulante du gestionnaire d'**alertes**.

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

   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 **Nom** et **Valeur**, entrez une ou plusieurs *étiquettes correspondantes*. Les matchers déterminent les règles auxquelles le silence s'applique. La correspondance des étiquettes est abordée plus en détail à la suite de cette procédure.

1. Ajoutez éventuellement un **commentaire** ou modifiez le **créateur** pour définir le propriétaire du silence.

**Correspondance des étiquettes pour la suppression des alertes**

Lorsque vous créez un silence, vous créez un ensemble d'*étiquettes correspondantes* dans le cadre du silence. Il s'agit d'un ensemble de règles concernant les libellés qui doivent correspondre pour que l'alerte soit supprimée. Les étiquettes correspondantes se composent de trois parties :
+ **Étiquette** : nom de l'étiquette à associer. Il doit correspondre exactement au nom de l'étiquette de l'alerte.
+ **Opérateur** : opérateur utilisé pour comparer la valeur de l'étiquette avec la valeur d'étiquette correspondante. Les opérateurs disponibles sont les suivants :
  + `=`Sélectionnez les libellés dont la valeur correspond exactement à la chaîne fournie.
  + `!=`Sélectionnez les libellés dont la valeur ne correspond pas à la chaîne fournie.
  + `=~`Sélectionnez les étiquettes dont la valeur correspond à la valeur interprétée par regex de la chaîne fournie (la chaîne fournie est interprétée comme une expression régulière).
  + `!=`Sélectionnez les libellés qui ne correspondent pas à l'expression régulière fournie.
+ **Valeur** : valeur à laquelle doit correspondre la valeur de l'étiquette. Il peut correspondre sous forme de chaîne ou d'expression régulière, selon l'opérateur choisi.

Le silence prend fin à la date de fin indiquée, mais vous pouvez mettre fin à la suppression manuellement à tout moment.

**Pour mettre fin à un silence manuellement**

1. Sur la page **Alertes**, 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.

**Création d'un lien vers le formulaire de création de silence**

Vous pouvez créer une URL vers le formulaire de création de silence avec les informations déjà renseignées. Les opérateurs peuvent l'utiliser pour supprimer rapidement une alarme lors d'un événement opérationnel.

Lorsque vous créez un lien vers un formulaire de silence, utilisez un paramètre de `matchers` requête pour spécifier les libellés correspondants et un paramètre de `comment` requête pour spécifier un commentaire. Le `matchers` paramètre nécessite une ou plusieurs valeurs dans le formulaire`[label][operator][value]`, séparées par des virgules.

**Exemple d'URL**

Pour créer un lien vers un formulaire de silence, avec les libellés correspondants `severity=critical` et`cluster!~europe-.*`, avec un commentaire indiquant`Silencing critical EU alerts`, utilisez une URL comme celle-ci. *mygrafana*Remplacez-le par le nom d'hôte de votre instance Grafana.

```
https://mygrafana/alerting/silence/new?matchers=severity%3Dcritical%2Ccluster!~europe-*&comment=Silence%20critical%20EU%20alert
```

Pour créer un lien vers une nouvelle page de silence pour un Alertmanager externe, ajoutez un paramètre de `alertmanager` requête portant le nom de la source de données Alertmanage, tel que. `alertmanager=myAlertmanagerdatasource`

# Travailler avec les points de contact
<a name="alert-contact-points"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Utilisez les points de contact pour définir la manière dont vos contacts sont avertis lorsqu'une alerte est déclenchée. Un point de contact peut avoir un ou plusieurs types de points de contact, par exemple Amazon Simple Notification Service ou Slack. Lorsqu'une alerte est lancée, une notification est envoyée à tous les types de points de contact répertoriés pour un point de contact. Utilisez-le éventuellement [Utilisation de modèles de messagerie](alert-message-templates.md) pour personnaliser les messages de notification pour les types de points de contact.

**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 Alertmanager sont en lecture seule.

## Travailler avec les points de contact
<a name="alert-working-contact-points"></a>

Les procédures suivantes expliquent comment ajouter, modifier, tester et supprimer des points de contact.

**Pour ajouter un point de contact**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**

1. Choisissez **Points de contact**, puis **Nouveau point de contact**.

1. Dans le menu déroulant **Alertmanager**, sélectionnez un Alertmanager. Le Grafana Alertmanager est sélectionné par défaut.

1. Entrez un **nom** pour le point de contact.

1. Dans **Type de point de contact**, choisissez un type et 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 éventuellement les **paramètres facultatifs** 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. Si votre point de contact a besoin de plusieurs types de points de contact, vous pouvez choisir **Nouveau type de point de contact** et répéter les étapes pour chaque type de point de contact requis.

1. Choisissez **Enregistrer le point de contact** pour enregistrer vos modifications.

**Pour modifier un point de contact**

1. Choisissez **Points de contact** pour voir la liste des points de contact existants.

1. Sélectionnez le point de contact à modifier, puis cliquez sur l'icône **Modifier** (stylo).

1. Apportez les modifications nécessaires, puis choisissez **Enregistrer le point de contact** pour enregistrer vos modifications.

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. Choisissez **Points de contact** pour ouvrir la liste des points de contact existants.

1. Sélectionnez le point de contact à tester, puis cliquez sur l'icône **Modifier** (stylo).

1. Sélectionnez l'icône **Test** (avion en papier).

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.

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. Choisissez **Points de contact** pour ouvrir la liste des points de contact existants.

1. Sélectionnez le point de contact à supprimer, puis cliquez sur l'icône **Supprimer** (corbeille).

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.

## Liste des notificateurs pris en charge
<a name="alert-supported-notifiers"></a>


|  Name  |  Type  | 
| --- | --- | 
| Amazon SNS  |  sns  | 
|  OpsGenie  |  opsgenie  | 
| Devoir de téléavertisseur  |  pagerduty  | 
| Slack  |  slack  | 
|  VictorOps  |  victorops  | 

# Utilisation de modèles de messagerie
<a name="alert-message-templates"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

Les notifications envoyées via [Travailler avec les points de contact](alert-contact-points.md) sont créées à l'aide *de modèles de messagerie*. 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).

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. La [Données du modèle](#alert-template-data) rubrique répertorie les variables disponibles pour la création de modèles.

**Utilisation de modèles**

Les modèles sont utilisés pour créer un message. Par exemple, avec un message d'alerte Slack, vous pouvez définir le titre et le corps du point de contact. L'exemple suivant montre comment utiliser des modèles par défaut pour créer un titre contenant le nombre d'alertes déclenchées et résolues, ainsi qu'un corps répertoriant les alertes et leur statut.
+ **Titre** :

  ```
  {{ len .Alerts.Firing }} firing, {{ len .Alerts.Resolved }} resolved
  ```
+ **Corps du texte** : 

  ```
  {{ range .Alerts }}{{ .Status }}: {{ .Labels.alertname }}
  {{end }}
  ```

Vous pouvez créer vos propres modèles personnalisés, comme dans l'exemple suivant.
+ **Titre** :

  ```
  {{ template "slack.default.title" .}}
  ```
+ **Corps du texte** : 

  ```
  {{ template "mymessage" .}}
  ```

Voici un exemple de modèle.

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Les procédures suivantes indiquent comment créer, modifier et supprimer des modèles de messages personnalisés.

**Pour créer un modèle de message**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**

1. Choisissez **Points de contact**.

1. Dans la liste déroulante **Alertmanager**, sélectionnez l'instance Alertmanager pour laquelle vous souhaitez créer un modèle de message. La valeur par défaut est le Grafana Alertmanager.

1. Choisissez **Ajouter un modèle**.

1. Ajoutez un **nom** descriptif.

1. Ajoutez le **contenu** du modèle, par exemple :

   ```
   {{ define "mymessage" }}
     {{ range .Alerts }}
       [{{ .Status }}] {{ range .Labels }} {{ .Name }}={{.Value }}{{end}}
     {{ end }}
   {{ end }}
   ```

   La `define` balise de la section Contenu attribue le nom du modèle. Cette balise est facultative, et lorsqu'elle est omise, le nom du modèle est dérivé du champ **Nom**. Lorsque les deux sont spécifiés, il est recommandé de les conserver identiques.

1. Choisissez **Enregistrer le modèle**.

**Note**  
Dans les modèles de messages d'alerte, le code HTML est affiché sous forme de texte, les caractères de contrôle étant ignorés. Le rendu du code HTML dans la notification résultante n'est pas pris en charge par Grafana.

**Pour modifier un modèle de message**

1. Sur la page **Alertes**, choisissez **Points de contact** pour ouvrir la liste des points de contact.

1. Dans le **tableau Modèle**, recherchez le modèle que vous souhaitez modifier, puis cliquez sur l'icône **Modifier** (stylo).

1. Apportez vos modifications, puis choisissez **Enregistrer le modèle**.

**Pour supprimer un modèle de message**

1. Sur la page **Alertes**, choisissez **Points de contact** pour ouvrir la liste des points de contact.

1. Dans le **tableau Modèle**, recherchez le modèle que vous souhaitez supprimer, puis cliquez sur l'icône **Supprimer** (corbeille).

1. Choisissez **Oui, supprimer** pour supprimer le modèle.

**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 les options de modèle intégrées suivantes pour intégrer des modèles personnalisés.


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

**Exemples de modèles personnalisés**

Voici des exemples d'utilisation de modèles personnalisés.

Modèle pour afficher une seule alerte :

```
{{ define "myalert" }}
  [{{.Status}}] {{ .Labels.alertname }}

  Labels:
  {{ range .Labels.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}

  {{ if gt (len .Annotations) 0 }}
  Annotations:
  {{ range .Annotations.SortedPairs }}
    {{ .Name }}: {{ .Value }}
  {{ end }}
  {{ end }}

  {{ if gt (len .SilenceURL ) 0 }}
    Silence alert: {{ .SilenceURL }}
  {{ end }}
  {{ if gt (len .DashboardURL ) 0 }}
    Go to dashboard: {{ .DashboardURL }}
  {{ end }}
{{ end }}
```

Modèle pour afficher l'intégralité du message de notification :

```
{{ define "mymessage" }}
  {{ if gt (len .Alerts.Firing) 0 }}
    {{ len .Alerts.Firing }} firing:
    {{ range .Alerts.Firing }} {{ template "myalert" .}} {{ end }}
  {{ end }}
  {{ if gt (len .Alerts.Resolved) 0 }}
    {{ len .Alerts.Resolved }} resolved:
    {{ range .Alerts.Resolved }} {{ template "myalert" .}} {{ end }}
  {{ end }}
{{ end }}
```

## Données du modèle
<a name="alert-template-data"></a>

Les données suivantes sont transmises aux modèles de messages.


| Name | Type | Remarques | 
| --- | --- | --- | 
|  `Receiver`  |  chaîne  |  Nom du point de contact auquel la notification est envoyée.  | 
|  `Status`  |  chaîne  |  déclenchement si au moins une alerte est déclenchée, sinon résolu.  | 
|  `Alerts`  |  Alerte  |  Liste des objets d'alerte inclus dans cette notification (voir ci-dessous).  | 
|  `GroupLabels`  |  KeyValue  |  Étiquettes selon lesquelles ces alertes ont été regroupées.  | 
|  `CommonLabels`  |  KeyValue  |  Libellés communs à toutes les alertes incluses dans cette notification.  | 
|  `CommonAnnotations`  |  KeyValue  |  Annotations communes à toutes les alertes incluses dans cette notification.  | 
|  `ExternalURL`  |  chaîne  |  Lien de retour vers le Grafana qui a envoyé la notification. Si vous utilisez un Alertmanager externe, renvoyez le lien vers ce Alertmanager.  | 

Le `Alerts` type expose deux fonctions permettant de filtrer les alertes renvoyées.
+ `Alerts.Firing`— Renvoie la liste des alertes de déclenchement.
+ `Alerts.Resolved`— Renvoie la liste des alertes résolues.

**Alerte (type)**

Le type d'alerte contient les données suivantes.


| Name | Type | Remarques | 
| --- | --- | --- | 
|  Statut  |  chaîne  |  `firing` ou `resolved`.  | 
|  Étiquettes  |  KeyValue  |  Ensemble d'étiquettes associées à l'alerte.  | 
|  Annotations  |  KeyValue  |  Ensemble d'annotations associées à l'alerte.  | 
|  StartsAt  |  Heure. Heure  |  Heure à laquelle l'alerte a commencé à se déclencher.  | 
|  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.  | 
|  URL du générateur  |  chaîne  |  Un lien de retour vers Grafana ou un Alertmanager externe.  | 
|  URL de silence  |  chaîne  |  Lien vers le formulaire Grafana Silence avec des étiquettes préremplies pour cette alerte. Uniquement pour les alertes gérées par Grafana.  | 
|  URL du tableau de bord  |  chaîne  |  Lien vers le tableau de bord de Grafana, si la règle d'alerte en appartient à une. Uniquement pour les alertes gérées par Grafana.  | 
|  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.  | 
|  Empreinte  |  chaîne  |  Empreinte digitale qui peut être utilisée pour identifier l'alerte.  | 
|  ValueString  |  chaîne  |  Chaîne contenant les libellés et la valeur de chaque expression réduite de l'alerte.  | 

**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 | 
| --- | --- | --- | --- | 
|  SortedPairs  |    |  Liste triée des paires de chaînes de clés et de valeurs  |    | 
|  Supprimer  |  [] chaîne  |  KeyValue  |  Renvoie une copie de la Key/Value carte sans les clés données.  | 
|  Noms  |    |  [] chaîne  |  Liste des noms d'étiquettes  | 
|  Valeurs  |    |  [] chaîne  |  Liste des valeurs d'étiquette  | 



## Fonctions du modèle
<a name="alert-template-functions"></a>

À l'aide des fonctions du modèle, vous pouvez traiter les étiquettes et les annotations pour générer des notifications dynamiques. Les fonctions suivantes sont disponibles.


| Name | Type d’argument | Type de retour | Description | 
| --- | --- | --- | --- | 
|  `humanize`  |  nombre ou chaîne  |  chaîne  |  Convertit un nombre dans un format plus lisible à l'aide de préfixes métriques.  | 
|  `humanize1024`  |  nombre ou chaîne  |  chaîne  |  Comme humanize, mais utilise 1024 comme base au lieu de 1000.  | 
|  `humanizeDuration`  |  nombre ou chaîne  |  chaîne  |  Convertit une durée en secondes dans un format plus lisible.  | 
|  `humanizePercentage`  |  nombre ou chaîne  |  chaîne  |  Convertit une valeur de ratio en une fraction de 100.  | 
|  `humanizeTimestamp`  |  nombre ou chaîne  |  chaîne  |  Convertit un horodatage Unix en secondes dans un format plus lisible.  | 
|  `title`  |  chaîne  |  chaîne  |  Strings.title, met en majuscule le premier caractère de chaque mot.  | 
|  `toUpper`  |  chaîne  |  chaîne  |  cordes. ToUpper, convertit tous les caractères en majuscules.  | 
|  `toLower`  |  chaîne  |  chaîne  |  cordes. ToLower, convertit tous les caractères en minuscules.  | 
|  `match`  |  motif, texte  |  boolean  |  expression régulière. MatchString Teste une correspondance regexp non ancrée.  | 
|  `reReplaceAll`  |  modèle, remplacement, texte  |  chaîne  |  Expression régulière. ReplaceAllString Substitution de Regexp, non ancrée.  | 
|  `graphLink`  |  string - Objet JSON avec `datasource` champs `expr` et  |  chaîne  |  Renvoie le chemin d'accès à la vue graphique dans Explore pour l'expression et la source de données données.  | 
|  `tableLink`  |  string - Objet JSON avec `datasource` champs `expr` et  |  chaîne  |  Renvoie le chemin d'accès à la vue tabulaire dans Explore pour l'expression et la source de données données.  | 
|  `args`  |  [] interface \$1\$1  |  carte [chaîne] interface \$1\$1  |  Convertit une liste d'objets en carte avec des clés, par exemple arg0, arg1. Utilisez cette fonction pour transmettre plusieurs arguments aux modèles.  | 
|  `externalURL`  |  rien  |  chaîne  |  Renvoie une chaîne représentant l'URL externe.  | 
|  `pathPrefix`  |  rien  |  chaîne  |  Renvoie le chemin de l'URL externe.  | 

Le tableau suivant présente des exemples d'utilisation de chaque fonction.


| Fonction | TemplateString | Input | Expected | 
| --- | --- | --- | --- | 
|  humaniser  |  \$1humaniser \$1value\$1  |  1234567,0  |  1,235 M  | 
|  humaniser 1024  |  \$1humaniser 1024\$1 de valeur\$1  |  1048576,0  |  1 mi  | 
|  Humaniser la durée  |  \$1HumanizeDuration \$1value\$1  |  899,99  |  14 m 59 s  | 
|  Pourcentage d'humanisation  |  \$1humanizePercentage \$1value\$1  |  0,1234567  |  12,35 %  | 
|  Humaniser l'horodatage  |  \$1humanizeTimestamp \$1value\$1  |  1435065584,128  |  23/06/2015 13:19:44,128 \$10000 UTC  | 
|  title  |  \$1\$1value \$1 titre\$1  |  un B C  |  Aa Bb CC  | 
|  toUpper  |  \$1\$1value \$1 toUpper\$1  |  un B C  |  AA BB CC  | 
|  toLower  |  \$1\$1value \$1 toLower\$1  |  un B C  |  AA BB CC  | 
|  match  |  \$1correspond à « a\$1 » \$1labels.instance\$1  |  aa  |  true  | 
|  reReplaceAll  |  \$1\$1 reReplaceAll « localhost :( .\$1) » « my.domain : \$11 » \$1labels.instance\$1\$1  |  hôte local : 3000  |  mon domaine .domain : 3000  | 
|  GraphLink  |  \$1\$1GraphLink « \$1\$1" expr \$1 » : \$1 "up \$1 », \$1 "source de données \$1 » : \$1 "gdev-prometheus \$1"\$1 »\$1  |    |  /explorer ? left= ["now-1h », « now », « gdev-prometheus », \$1"source de données » « gdev-prometheus », « expr » « up », « instant » :false, "range » :true\$1]  | 
|  Tableau Link  |  \$1\$1TableLink « \$1\$1" expr \$1 » : \$1 "up \$1 », \$1 "source de données \$1 » : \$1 "gdev-prometheus \$1"\$1 »\$1  |    |  /explorer ? left= ["now-1h », « now », « gdev-prometheus », \$1"source de données » « gdev-prometheus », « expr » « up », « instant » :true, "range » :false\$1]  | 
|  args  |  \$1\$1define « x »\$1\$1 \$1\$1.arg0\$1\$1 \$1\$1.arg1\$1\$1 \$1\$1end\$1\$1 \$1\$1modèle « x » (args 1 « 2 »)\$1\$1  |    |  1 2  | 
|  URL externe  |  \$1URL externe\$1  |    |  http ://localhost/path/prefix  | 
|  Préfixe de chemin  |  \$1PathPrefix\$1  |    |  /chemin/préfixe  | 

# Utilisation des politiques de notification
<a name="alert-notifications"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana, voir. [Travailler dans la version 10 de Grafana](using-grafana-v10.md)  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)

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 comporter une ou plusieurs politiques relatives aux enfants. Chaque politique, à l'exception de la stratégie racine, peut également correspondre à des étiquettes d'alerte spécifiques. Chaque alerte est évaluée par la politique racine, puis par chaque politique enfant. Si vous activez l'`Continue matching subsequent sibling nodes`option pour une politique spécifique, 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 racine régit toute alerte qui ne correspond pas à une politique spécifique.

**Note**  
Vous pouvez créer et modifier des politiques de notification pour les alertes gérées par Grafana. Les politiques de notification pour les alertes Alertmanager sont en lecture seule.

**Notifications de regroupement**

Le regroupement permet de classer les notifications d'alerte de nature similaire dans un entonnoir unique. Cela vous permet de contrôler les notifications d'alerte lors de pannes importantes lorsque de nombreuses parties d'un système tombent en panne simultanément, ce qui entraîne le déclenchement simultané d'un grand nombre d'alertes.

**Exemple de regroupement**

Supposons que 100 services soient connectés à une base de données dans différents environnements. Ces services sont différenciés par le label`env=environmentname`. Une règle d'alerte est en place pour vérifier si vos services peuvent accéder à la base de données. La règle d'alerte crée des alertes nommées`alertname=DatabaseUnreachable`.

En cas de partition réseau empêchant la moitié de vos services d'accéder à la base de données, 50 alertes différentes sont déclenchées. Dans ce cas, vous souhaitez recevoir une notification d'une seule page (au lieu de 50) contenant la liste des environnements concernés.

Vous pouvez configurer le regroupement de manière à ce qu'il soit `group_by: [alertname]` (sans utiliser l'`env`étiquette, qui est différente pour chaque service). Une fois cette configuration en place, Grafana envoie une seule notification compacte répertoriant tous les environnements concernés par cette règle d'alerte.

**Groupes spéciaux**

Grafana compte deux groupes spéciaux. Le groupe par défaut `group_by: null` regroupe *toutes les* alertes en un seul groupe. Vous pouvez également utiliser une étiquette spéciale nommée `...` pour regrouper les alertes par toutes les étiquettes, désactiver efficacement le regroupement et envoyer chaque alerte dans son propre groupe.

## Utilisation des notifications
<a name="alert-notifications-working"></a>

Les procédures suivantes vous montrent comment créer et gérer des politiques de notification.

**Pour modifier la politique de notification root**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**

1. Choisissez **Politiques de notification**.

1. Dans le menu déroulant **Alertmanager**, sélectionnez le Alertmanager que vous souhaitez modifier.

1. Dans la section **Politique racine**, choisissez l'icône **Modifier** (stylo).

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 (ou les groupes spéciaux) selon lesquels regrouper les alertes.

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 ajouter une nouvelle politique spécifique de haut niveau**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**

1. Choisissez **Politiques de notification**.

1. Dans le menu déroulant **Alertmanager**, sélectionnez le Alertmanager que vous souhaitez modifier.

1. Dans la section **Routage spécifique**, choisissez **Nouvelle politique spécifique**.

1. Dans la section **Étiquettes correspondantes**, ajoutez une ou plusieurs étiquettes d'alerte correspondantes. Vous trouverez plus d'informations sur la correspondance des étiquettes plus loin dans cette rubrique.

1. Dans **Point de contact**, ajoutez le point de contact auquel envoyer des notifications si l'alerte correspond à cette politique spécifique. Les politiques imbriquées remplacent ce point de contact.

1. Sélectionnez éventuellement **Remplacer le regroupement** pour spécifier un regroupement différent de la politique racine.

1. Sélectionnez éventuellement Annuler les **horaires généraux** pour annuler les options de synchronisation de la politique de notification de groupe.

1. Choisissez **Enregistrer la politique** pour enregistrer les changements.

**Pour ajouter une politique imbriquée**

1. Développez la stratégie spécifique sous laquelle vous souhaitez créer une politique imbriquée.

1. Choisissez **Ajouter une politique imbriquée**, puis ajoutez les détails (comme lors de l'ajout d'une politique spécifique de haut niveau).

1. Choisissez **Enregistrer la politique** pour enregistrer les changements.

**Pour modifier une politique spécifique**

1. Sur la page **Alertes**, choisissez **Politiques de notification** pour ouvrir la page répertoriant les politiques existantes.

1. Sélectionnez la politique que vous souhaitez modifier, puis cliquez sur l'icône **Modifier** (stylo).

1. Apportez des modifications (comme lors de l'ajout d'une politique spécifique de haut niveau).

1. Choisissez **Enregistrer la stratégie**.

**Comment fonctionne la correspondance des étiquettes**

Une politique correspond à une alerte si les libellés de l'alerte correspondent à tous les *libellés correspondants* spécifiés dans la stratégie.
+ **Étiquette** : nom de l'étiquette à associer. Il doit correspondre exactement au nom de l'étiquette de l'alerte.
+ **Opérateur** : opérateur utilisé pour comparer la valeur de l'étiquette avec la valeur d'étiquette correspondante. Les opérateurs disponibles sont les suivants :
  + `=`Sélectionnez les libellés dont la valeur correspond exactement à la chaîne fournie.
  + `!=`Sélectionnez les libellés dont la valeur ne correspond pas à la chaîne fournie.
  + `=~`Sélectionnez les étiquettes dont la valeur correspond à la valeur interprétée par regex de la chaîne fournie (la chaîne fournie est interprétée comme une expression régulière).
  + `!=`Sélectionnez les libellés qui ne correspondent pas à l'expression régulière fournie.
+ **Valeur** — La valeur à laquelle doit correspondre la valeur de l'étiquette. Il peut correspondre sous forme de chaîne ou d'expression régulière, selon l'opérateur choisi.

## Horaire du mode muet
<a name="alert-notification-muting"></a>

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 comparés aux silences**

Le tableau suivant met en évidence les différences entre les temps de 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  | 

**Pour créer un chronométrage muet**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez l'icône d'**alerte** (cloche) pour ouvrir la page d'alerte.**

1. Choisissez **Politiques de notification**.

1. Dans le menu déroulant **Alertmanager**, sélectionnez le Alertmanager que vous souhaitez modifier.

1. Dans la section Durée de mise en **sourdine, cliquez sur le bouton Ajouter une temporisation** **de mise en sourdine.**

1. Choisissez l'intervalle de temps auquel vous souhaitez appliquer la temporisation du mode muet.

1. Choisissez **Soumettre** pour créer la temporisation du mode muet.

**Pour ajouter une temporisation muette à une politique de notification**

1. Sélectionnez la politique de notification à laquelle vous souhaitez ajouter le temps de sourdine, puis cliquez sur le bouton **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.

   Cliquez sur le bouton **Enregistrer la politique**.

**Intervalles de temps**

Un intervalle de temps est la définition d'une plage de temps. Si une alerte est déclenchée pendant cet intervalle, elle est supprimée. Les plages sont prises en charge à l'aide de `:` (par exemple,`monday:thursday`). Une temporisation muette peut contenir plusieurs intervalles de temps. Un intervalle de temps se compose de plusieurs champs (détails dans la liste suivante), qui doivent tous correspondre pour supprimer les alertes. Par exemple, si vous spécifiez des jours de la semaine `monday:friday` et une plage horaire comprise entre 8 h et 9 h, les alertes sont supprimées du 8 au 9, du lundi au vendredi, mais pas, par exemple, de 8 h à 9 h le samedi.
+ **Plage horaire** : heure à laquelle les notifications doivent être supprimées. Composé de deux sous-champs, Heure de **début et Heure** de **fin.** Un exemple de temps est`14:30`. L'heure est exprimée en notation de 24 heures, en UTC.
+ **Jours de la semaine** — Les jours de la semaine. Il peut s'agir d'un jour unique`monday`, tel qu'une plage`monday:friday`, ou d'une liste de jours séparés par des virgules, telle que. `monday, tuesday, wednesday`
+ **Mois** — Les mois à sélectionner. Vous pouvez spécifier les mois avec des désignations numériques ou avec le nom complet du mois, par exemple, `1` ou les `january` deux spécifier janvier. Vous pouvez spécifier un mois unique, une plage de mois ou une liste de mois séparés par des virgules.
+ **Jours du mois** : dates comprises dans un délai d'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. Les jours du mois peuvent être spécifiés sous la forme d'un jour unique, d'une plage de jours ou d'une liste de jours séparés par des virgules.