

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.

# Configurer les mappages de valeurs
<a name="v10-panels-configure-value-mappings"></a>

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

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

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

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

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

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

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

Vous pouvez ajouter des mappages de valeur à vos panneaux.

**Pour ajouter un mappage de valeur**

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

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

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

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

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

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

1. (Facultatif) Définissez la couleur.

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

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