

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

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

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

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

 通过值映射映射的值会绕过单位格式。这意味着映射到数值的文本值不会使用配置的单位格式化。

 如果面板中存在值映射，Grafana 会在面板编辑器的侧窗格中显示摘要。

**注意**  
 新的值映射与某些可视化效果不兼容，例如图形（旧）、文本和热图。

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

 Grafana 支持以下值映射：
+  **值**：将文本值映射到颜色或其他显示文本。例如，您可以配置一个值映射，使值 **10** 的所有实例都显示为 **Perfection\$1** 而不是数字。
+  **范围**：将数值范围映射到显示文本和颜色。例如，如果某个值在某个范围内，则可以将范围值映射配置为显示**低**或**高**而不是数字。
+  **正则表达式**：将正则表达式映射到替换文本和颜色。例如，如果值为 **www.example.com**，则可以配置正则表达式值映射，以便 Grafana 显示 **www** 并截断域。
+  **特殊**将特殊值（如 **Null**、**NaN**（非数字）和布尔值（如 **true** 和 **false**）映射到显示文本和颜色。例如，您可以配置特殊值映射，使 **null** 值显示为 **N/A**。

 您还可以使用左侧的点在列表中拖动值映射并重新排序。

## 映射值
<a name="v9-panels-value-mappings-map-a-value"></a>

 当您想要格式化单个值时，请映射一个值。

1.  打开要为其映射值的面板。

1.  在面板显示选项中，找到**值映射**部分，然后单击**添加值映射**。

1.  单击**添加新映射**，然后选择**值**。

1.  输入 Grafana 要匹配的值。

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

1.  （可选）设置颜色。

1.  单击**更新**保存值映射。

## 映射范围
<a name="v9-panels-value-mappings-map-a-range"></a>

 当您想要格式化多个连续值时，请映射值范围。

1.  编辑要为其映射值范围的面板。

1.  在面板显示选项中的**值映射**部分，单击**添加值映射**。

1.  单击**添加新映射**，然后选择**范围**。

1.  在 Grafana 要匹配的范围内输入开始值和结束值。

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

1.  （可选）设置颜色。

1.  单击**更新**保存值映射。

## 映射正则表达式
<a name="v9-panels-value-mappings-map-a-regex"></a>

 当您想要格式化正则表达式值的文本和颜色时，请映射正则表达式。

1.  编辑要为其映射正则表达式的面板。

1.  在面板显示选项中的**值映射**部分，单击**添加值映射**。

1.  单击**添加新映射**，然后选择**正则表达式**。

1.  输入 Grafana 要匹配的正则表达式模式。

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

1.  （可选）设置颜色。

1.  单击**更新**保存值映射。

## 映射特殊值
<a name="v9-panels-value-mappings-map-a-special-value"></a>

 当您要格式化不常用值、布尔值或空值时，请映射特殊值。

1.  编辑要为其映射特殊的面板。

1.  在面板显示选项中，找到**值映射**部分，然后单击**添加值映射**。

1.  单击**添加新映射**，然后选择**特殊**。

1.  选择 Grafana 要匹配的特殊值。

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

1.  （可选）设置颜色。

1.  单击**更新**保存值映射。

## 编辑值映射
<a name="v9-panels-value-mappings-edit-a-value"></a>

 您可以随时更改值映射。

1.  编辑包含要编辑的值映射的面板。

1.  在面板显示选项中的**值映射**部分，单击**编辑值映射**。

1.  更改并单击**更新**。