菜单
Grafana Cloud 企业版 开源

配置值映射

除了字段覆盖之外,值映射是一种可用于更改数据在可视化中显示方式的技术。

例如,下图所示的应用的映射使可视化在不同温度范围显示蓝色、绿色和红色的文本 ColdGoodHot,而不是实际温度值。以这种方式使用值映射可以使数据更快、更容易理解和解释。

Value mappings applied to a gauge visualization

值映射会绕过面板编辑器标准选项部分中设置的单位格式,例如颜色或显示的小数位数。当面板中存在值映射时,Grafana 会在编辑器面板的值映射部分显示它们的摘要。

支持的可视化

您可以为以下可视化配置值映射

值映射类型

Grafana 支持以下值映射类型

映射将特定值映射到文本和颜色。例如,您可以配置映射,以便所有值为 10 的实例显示为完美!而不是数字。当您想要格式化单个值时,使用映射。值 10 映射到文本 Perfection!

范围

范围映射将数值范围映射到文本和颜色。例如,如果一个值在特定范围内,您可以配置范围值映射以显示而不是数字。当您想要格式化多个连续值时,使用范围映射。映射到文本 Low 和 High(带有黄色和红色)的数字范围

正则表达

正则表达映射将正则表达式映射到文本和颜色。例如,如果值为 www.example.com,您可以配置正则表达式值映射,使 Grafana 显示 www 并截断域名。当您想要格式化正则表达式值的文本和颜色时,使用正则表达映射。用于将完整 URL 截断为文本 wwww 的正则表达式

特殊值

特殊值映射将特殊值(如 NullNaN(非数字)以及布尔值(如 truefalse))映射到文本和颜色。例如,您可以配置特殊值映射,使 null 值显示为 不适用。当您想要格式化不常见、布尔值或空值时,使用特殊值映射。值为 null 映射到文本 N/A

示例

请参阅以下示例,了解有关值映射的更多信息。

时间序列示例

下图显示了一个带有值映射的时间序列可视化。值映射颜色不会应用于此可视化,但显示文本会显示在轴上。

Value mappings time series example

统计示例

下图显示了一个带有值映射和文本颜色的统计可视化。您可以隐藏迷你图,使其不干扰值。

Value mappings stat example

条形仪表示例

下图显示了一个带有值映射的条形仪表可视化。请注意,值映射颜色应用于文本,但不应用于仪表。

Value mappings bar gauge example

表格示例

下图显示了一个带有值映射的表格可视化。如果您希望在表格上显示值映射颜色,请将单元格显示模式设置为文本颜色背景颜色

Value mappings table example

添加值映射

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

  2. 将鼠标悬停在要操作的面板的任意部分,以显示右上角的菜单。

  3. 点击菜单并选择编辑

  4. 滚动到值映射部分并展开它。

  5. 点击添加值映射

  6. 点击添加新映射,然后选择以下选项之一

    • - 输入要匹配的单个值。
    • 范围 - 输入要匹配范围的起始值和结束值。
    • 正则表达 - 输入要匹配的正则表达式模式。
    • 特殊值 - 选择要匹配的特殊值。
  7. (可选) 输入显示文本。

  8. (可选) 设置颜色。

  9. (可选) 设置图标(仅适用于 Canvas 可视化)。

  10. 点击更新以保存值映射。

添加映射后,添加值映射按钮会被编辑值映射按钮替换。点击编辑按钮可以添加或更新映射。

  1. 点击保存仪表盘
  2. 点击返回仪表盘,然后点击退出编辑