创建 IBM Cloud Logs 热图

您可以创建热图,并将其包含在自定义 IBM® Cloud Logs 仪表板中。

使用热图部件可视化两个维度的分布或数据强度,并快速识别高活跃度区域或趋势,快速捕捉随时间变化或按类别划分的热点、趋势和异常,或从事件直接钻取日志或指标进行更深入的分析。

准备工作

热图使用颜色显示数据值的强度。 每个单元格代表两个维度(如时间-服务、端点-延迟或区域-状态代码)交叉处的数据汇总值。 这样就能轻松识别线形图或柱形图中难以发现的峰值和模式。

配置热图时请考虑以下信息:

  • 将查询返回的 X×Y 组合总数控制在 2000 个数据行以内。

  • 如果查询返回的记录超过 2000 条,请增加时间范围或减少“分组依据”字段的数量。

  • 每个 widget 最多使用 5 个分组字段。 附加字段可能会影响可读性和性能。

  • 避免按 user_id 等高心数标签分组。

  • 限制分组字段,避免可视化结果过于拥挤。

第 1 步:输入名称和说明

完成以下步骤:

  1. 自定义仪表板 中,单击添加部件 添加部件图标,然后从侧栏拖放热图部件。

  2. 用 Widget 的名称替换“新热图”。

  3. 输入描述。

    单击操作图标 操作 图标。 然后,选择添加说明

第 2 步:配置查询以定义数据集

完成以下步骤:

  1. 单击操作图标 操作 图标。 然后,选择编辑模式

  2. Query 1,请完成以下步骤:

    选择数据类型。 有效值为 Logs, Metrics,和 DataPrime

    选择信号源。 有效选项为:Priority InsightsAnalyze and Alert

    您可以重新命名查询。 选择操作图标,然后单击重命名查询

  3. 输入查询。

    当数据类型为 DataPrime 时,在查询字段中输入 Dataprime 查询。

    当数据类型为 Logs 时,在查询字段中输入 Lucene 查询。 您可以应用筛选器和汇总。

    当数据类型为 Metrics 时,在查询字段中指定度量或所需的 PromQL。 您可以应用筛选器和汇总。

  4. [可选]为 widget 添加一个或多个特定筛选器,以缩小仪表中显示数据的范围。

    选择一个标签及其相应的值。

    过滤器应用于部件级别,与仪表盘过滤器一起工作。 如果发生冲突,仪表盘筛选器优先于部件筛选器。

  5. 为热图添加一个分组和汇总数据的函数。

    选择聚合函数,如 CountSumAverage,计算颜色强度所代表的值。

    选择按字段分组。 这些字段用于热图坐标轴。 这些字段必须是字符串、时间戳或严重性类型。 如果字段是数字(如 status_code),可以在分组前在 DataPrime 查询中将其转换为字符串。 例如,您可以在查询中使用 status_code:string

第 3 步:配置小工具

完成以下步骤:

  1. 单击操作图标 操作 图标。 然后,选择编辑模式

  2. 在“可视化管理”部分,最多可选择 5 个希望显示在 X 轴和 Y 轴上的类别或字段。

    要控制哪个字段显示在 X 轴上,哪个显示在 Y 轴上,请在 Y-axisX-axis 之间拖放字段。

    当 X 轴上出现时间戳字段时,选择时间标签的显示方式。 默认值为 Auto,根据所选时间范围调整格式。 提供以下格式:

    时间戳字段的格式
    格式 示例
    自动 自动调整
    DD/MM 25/04
    mm/dd 04/25
    hh:mm 14:30
    日/月 HH:mm 25/04 14:30
    HH:mm DD/MM 14:30 25/04
    MM/DD HH:mm 04/25 14:30
    HH:mm MM/DD 14:30 04/25
  3. 显示单元格值 切换以在每个单元格内叠加数值。 这在单元格较大且可读的情况下非常有用。

  4. 选择预定义的调色板来表示数据强度。 您可以颠倒颜色顺序(亮→暗或暗→亮)。

    使用图例配置选择配色方案。 默认情况下,它将数值映射为亮→暗。 使用最小和最大阈值控制色标范围,提高分布较宽或不均匀数据的可读性。

  5. 选择刻度类型。 有效值为 Linear (默认值),颜色在不同值之间均匀变化;或 Logarithmic,颜色全局适用于 Z 通道(颜色强度条),适用于值范围较宽的数据集。

  6. 在“工具提示管理”部分,自定义将鼠标悬停在地图上的点或群集上时显示的信息。 添加信息并选择要包含在工具提示中的标签或属性。

    添加悬停在点或群集上时显示的信息或值。 您可以使用 {{ }} 语法引用动态字段,如汇总值。

    当引用字段在一个群集中解析出多个不同值时,工具提示会显示一个通用标签,如“多个”,而不是一个特定值。 这表明该群组包含混合值,有助于深入了解更多细节。

    选择要包含在工具提示中的标签或属性,如服务、应用程序或国家。

第 5 步:保存小部件

完成以下步骤:

  1. [可选]如果想使用与仪表盘所选时间范围不同的时间,请设置 widget 的仪表盘时间。

  2. 单击“**保存 **”保存您的 widget。

  3. [可选]添加自定义操作。 有关更多信息,请参阅 使用操作与第三方服务集成

地图上的行动

使用快速操作直接从 hetamap 调查数据。

选择点或群集时,上下文菜单会提供以下操作:

  • Open Explore:在“探索”视图中打开日志,使用所选位置和群集上下文进行预过滤。

  • Filter in:将所选位置和值上下文添加到仪表盘查询中。

  • Filter out:从仪表盘查询中排除所选位置和值上下文。

  • Copy name:复制与所选点或群相关的位置标签或键=值对。