菜单
Grafana Cloud 企业版 开源

热力图

热力图允许您随时间查看直方图。直方图显示落在特定值范围的数据分布,而热力图可以帮助您随时间识别直方图数据分布中的模式。有关热力图的更多信息,请参阅直方图和热力图简介

例如,如果您想了解过去几年的温度变化,可以使用热力图可视化来识别数据中的趋势。

A heatmap visualization showing the random walk distribution over time
Give it a try using Grafana Play
在 Grafana Play 中试用

借助 Grafana Play,您可以探索并了解其工作原理,通过实际示例加速开发。可以在Grafana 热力图中查看此功能。

如果需要,可以使用热力图可视化来

  • 可视化大数据密度分布。
  • 通过各种更易于解释的颜色方案浓缩大量数据。
  • 识别数据分布中的任何离群值。
  • 提供统计分析,查看值或趋势随时间如何变化。

配置热力图可视化

创建仪表盘后,以下视频将向您展示如何配置热力图可视化

支持的数据格式

热力图支持时间序列数据。

示例

下表是随时间随机游走分布的简化输出

时间行走距离 (公里)
2023-06-25 21:13:0910
2023-08-25 21:13:108
2023-08-30 21:13:1010
2023-10-08 21:13:1112
2023-12-25 21:13:1114
2024-01-05 21:13:1213
2024-02-22 21:13:1310

数据转换如下

A heatmap visualization showing the random walk distribution over time

配置选项

以下部分描述了此可视化在面板编辑器窗格中可用的配置选项。这些选项尽可能按照它们在 Grafana 中出现的顺序排列。

面板选项

在面板编辑器窗格的**面板选项**部分,设置基本选项,例如面板标题和描述,以及面板链接。要了解更多信息,请参阅配置面板选项

热力图选项

以下选项控制热力图中数据如何计算和分组。

选项描述
从数据计算此设置决定数据是已经计算好的热力图(来自数据源/转换),还是应在面板中计算的热力图。
X 轴桶此设置决定如何将 X 轴分割成桶。您可以在**大小**输入中指定时间间隔。例如,时间范围为 `1h` 会使 X 轴上的单元格宽度为 1 小时。您也可以根据**数量**设置间隔。
Y 轴桶此设置决定如何将 Y 轴分割成桶。选择**大小**或**数量**。
Y 轴桶刻度选择以下 Y 轴值刻度之一
  • **线性** - 线性刻度。
  • **对数** - 选择对数底数**2**或**10**。
  • **Symlog** - Symlog 刻度。选择对数底数**2**或**10**,并输入**线性阈值**的值。

Y 轴选项

以下选项定义 Y 轴的显示方式。

选项描述
位置设置 Y 轴显示的位置。选择:**左侧**、**右侧**或**隐藏**。
单位单位配置。
小数位数此设置决定小数位数配置。
最小值/最大值这些设置配置轴范围。
轴宽度此设置配置轴的宽度。
轴标签此设置配置轴值。
刻度线对齐设置可视化中刻度线的对齐方式。选择:**自动**、**顶部 (LE)**、**中间**和**底部 (GE)**。仅当您的**从数据计算**设置为**否**时显示此选项。
反向选中后,轴以相反顺序显示。

多 Y 轴

在某些情况下,您可能需要显示多个 Y 轴。例如,如果您的数据集随时间显示温度和湿度,您可能需要为这两个时间序列显示两个具有不同单位的 Y 轴。

您可以通过添加字段覆盖来配置多个 Y 轴并控制它们在可视化中的显示位置。此包含温度和湿度数据集的示例描述了如何配置。对要显示的每个 Y 轴重复这些步骤。

颜色选项

颜色谱控制值计数(在每个桶中)与分配给每个桶的颜色之间的映射。颜色谱最左侧的颜色代表最小值,最右侧的颜色代表最大值。在使用浅色主题时,某些颜色方案会自动反转。

您也可以将颜色模式更改为不透明度。在这种情况下,颜色不会改变,但不透明度会随着桶计数而改变。

模式

使用以下选项定义热力图颜色。

  • **方案** - 由单元格颜色表示的桶值。
    • **方案** - 如果模式为**方案**,则选择颜色方案。
  • **不透明度** - 由单元格不透明度表示的桶值。不透明的单元格表示最大值。
    • **颜色** - 单元格基础颜色。
    • **刻度** - 用于将桶值映射到不透明度的刻度。
      • **指数** - 幂刻度。单元格不透明度计算为 `value ^ k`,其中 `k` 是配置的**指数**值。如果指数小于 `1`,您将获得对数刻度。如果指数大于 `1`,您将获得指数刻度。如果为 `1`,刻度将与线性相同。
        • **指数** - 指数的值,大于 `0`。
      • **线性** - 线性刻度。桶值与不透明度线性映射。

步数

设置一个介于 `1` 和 `128` 之间的值。

反向

切换开关反转颜色方案。此选项仅适用于**方案**颜色模式。

颜色刻度起始/结束值

默认情况下,Grafana 根据最小和最大桶值计算单元格颜色。使用最小和最大值可以覆盖这些值。可以将桶值视为 Z 轴,将 Min 和 Max 分别视为 Z-Min 和 Z-Max。

  • **开始** - 用于单元格颜色计算的最小值。如果桶值小于最小值,则映射到“最小值”颜色。时间序列最小值是默认值。
  • **结束** - 用于单元格颜色计算的最大值。如果桶值大于最大值,则映射到“最大值”颜色。时间序列最大值是默认值。

单元格显示选项

使用这些设置控制热力图单元格的显示。

选项描述
单位单位配置。
小数位数此设置决定小数位数配置。
单元格间距设置单元格之间的间距。
隐藏值小于等于的单元格输入一个值。
隐藏值大于等于的单元格输入一个值。

工具提示选项

工具提示选项控制在可视化中悬停数据点时显示的信息叠加层。

选项描述
工具提示模式将光标悬停在可视化上时,Grafana 可以显示工具提示。选择工具提示的行为方式。
显示直方图(Y 轴)当您将**工具提示模式**设置为**单个**时,将显示此选项。此选项控制工具提示是否包含表示 Y 轴的直方图。
显示颜色刻度此选项控制工具提示是否包含图例中也表示的颜色刻度。
最大宽度设置工具提示框的最大宽度。
最大高度设置工具提示框的最大高度。默认值为 600 像素。

工具提示模式

将光标悬停在可视化上时,Grafana 可以显示工具提示。选择工具提示的行为方式。

  • **单个 -** 悬停工具提示仅显示单个时间序列,即您在可视化中悬停的时间序列。
  • **全部 -** 悬停工具提示显示可视化中的所有时间序列。Grafana 会在工具提示中的时间序列列表中以粗体突出显示您正在悬停的时间序列。
  • **隐藏 -** 与可视化交互时,不显示工具提示。

使用覆盖隐藏工具提示中的单个时间序列。

显示颜色刻度

当您将**工具提示模式**设置为**单个**时,将显示此选项。此选项控制工具提示是否包含图例中也表示的颜色刻度。当颜色刻度包含在工具提示中时,它会显示悬停值在该刻度上的位置。

Heatmap with a tooltip displayed showing the hovered value reflected in the color scale

图例选项

通过切换**显示图例**开关选择是否要在可视化中显示热力图图例。

范例

设置用于显示范例数据的颜色。

数据链接允许您链接到其他面板、仪表盘和外部资源,同时保持源面板的上下文。您可以创建包含时间序列名称甚至光标下方值的链接。

注意

此可视化不支持操作。

对于每个数据链接,设置以下选项

  • 标题
  • URL
  • 在新标签页中打开

要了解更多信息,请参阅配置数据链接和操作

字段覆盖

覆盖允许您为特定字段或时间序列自定义可视化设置。添加覆盖规则时,它会针对一组特定的字段,并允许您定义该字段的多种显示选项。

选择以下覆盖选项

选项描述
按名称查找字段从所有可用字段列表中选择一个字段。
按匹配正则表达式查找字段使用正则表达式指定要覆盖的字段。
按类型查找字段按类型选择字段,例如字符串、数字或时间。
按查询查找字段选择特定查询返回的所有字段,例如 A、B 或 C。
按值查找字段选择由您定义的聚合条件(例如**最小值**、**最大值**、**计数**、**总计**)返回的所有字段。

要了解更多信息,请参阅配置字段覆盖