本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 配置值映射
<a name="v10-panels-configure-value-mappings"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

除了字段覆盖外，值映射是一种方法，可用来更改数据在可视化中的显示方式。

数值映射可绕过面板编辑器[标准选项](v10-panels-configure-standard-options.md)中设置的单位格式，如显示的颜色或小数位数。当面板中存在值映射时，Grafana 会在面板编辑器的**值映射**部分显示其摘要。

**支持的可视化**
+ 条形图
+ 条形仪表
+ K 线图
+ Canvas
+ 计量表
+ Geomap
+ 直方图
+ 饼图
+ Stat
+ 状态时间轴
+ 状态历史记录
+ 表
+ 时间序列
+ 趋势

## 值映射的类型
<a name="v10-panels-value-mappings-types"></a>

Grafana 支持以下值映射类型：
+ **值**：将特定值映射到文本和颜色。例如，您可以配置一个值映射，使值 `10` 的所有实例都显示为 `Perfection!` 而不是数字。当您想要格式化单个值时，请使用**值**映射。
+ **范围**：将数值范围映射到文本和颜色。例如，如果某个值在某个范围内，则可以将范围值映射配置为显示 `Low` 或 `High` 而不是数字。当您想要格式化多个连续值时，请使用**范围**映射。
+ **正则表达式**：将正则表达式映射到文本和颜色。例如，如果值为 `www.example.com`，则可以配置正则表达式值映射，以便 Grafana 显示 `www` 并截断域。当您想要格式化正则表达式值的文本和颜色时，请使用**正则表达式**映射。
+ **特殊**：将特殊值（如 `Null`、`NaN`（非数字）和布尔值（如 `true` 和 `false`）映射到文本和颜色。例如，您可以配置特殊值映射，使 `null` 值显示为 `N/A`。当您要格式化不常用值、布尔值或空值时，请使用**特殊**映射。

## 添加值映射
<a name="v10-panels-value-mappings-add"></a>

您可以为面板添加值映射。

**添加值映射**

1. 导航到要更新的面板。

1. 将鼠标悬停在面板的任何部分，面板右上角会显示菜单。

1. 从菜单上选择**编辑**。

1. 在**值映射**部分，选择**添加值映射**。

1. 选择**添加新映射**，然后选择以下选项之一：
   + **值**：输入要匹配的单个值。
   + **范围**：输入要匹配的范围起始值和结束值。
   + **正则表达式**：输入要匹配的正则表达式模式。
   + **特殊**：选择要匹配的特殊值。

1. （可选）输入显示文本。

1. （可选）设置颜色。

1. 选择**更新**保存值映射。

添加映射后，**编辑值映射**按钮将取代**添加值映射**按钮。选择编辑按钮以添加或更新映射。