探索热图

本页介绍了如何分析 Key Visualizer 扫描中的热图,以便您可以确定 Firestore 性能问题的来源。

在阅读本页内容之前,您应该先熟悉 Key Visualizer 概览。 您可能还需要执行以下操作:

调整亮度

Key Visualizer 热图使用深色指示正常或低值,使用亮色指示高值。您可以调整颜色比例以帮助查看热图中的模式。

请记住,对于大多数指标,Key Visualizer 完全根据数据库的使用情况确定值的“高”和“低”。例如,如果在特定键范围内每秒执行 20 次读取,在其他键范围内每秒执行 1 次读取,则 Key Visualizer 为该特定键范围使用亮色。请注意,亮色不一定表示存在问题。

要调整用于不同值的颜色,请使用调整亮度 图标两侧的 + / - 按钮。增加亮度时,您可以降低每种颜色代表的值的范围;降低亮度时,您可以增加值的范围。

如要将亮度重置为默认设置,请点击调整亮度 图标。

扩大时间段和键范围

打开热图后,它会显示扫描中包含的时间段的值以及数据库中的有效键范围。如果您在特定时间段或特定键范围内发现问题,则可以放大以更仔细地检查问题。

您可以使用多种放大或缩小的方法:

  • 在热图中向上或向下滚动。
  • 点击矩形缩放 按钮,然后点击并拖动以选择要放大的区域。
  • 按住 Shift 键,然后点击并拖动以选择要放大的区域。
  • BackspaceDelete 键返回热图的上一个区域。
  • 通过点击重置缩放级别 按钮或按 R 键缩小以查看整个表。

按键前缀展开细目

以下部分以文档按键扫描为例进行了深入分析。对于索引键,前缀会更改为一组索引键。

Key Visualizer 会在热图的左侧按数据库的层次结构来组织键。您可以使用此参数深入了解特定键范围的数据。

要深入了解拥有公共前缀的一组键的热图数据,请执行以下操作:

  1. 将光标移动到热图左侧显示的键层次结构中的任一级别上。

    Key Visualizer 将突出显示热图中代表此级别层次结构的区域。它还将显示此级别的所有键的键前缀。

    热图中一组键的突出显示区域示例

  2. 点击要检查的键层次结构的级别。

    Key Visualizer 将放大此级别的层次结构。

    放大键某一级别层次结构的示例

  3. 点击键层次结构的其他级别以进一步放大,或按 BackspaceDelete 键返回上一个区域。

固定关于指标的详细信息

当您将光标移到热图上时,Key Visualizer 会显示一个提示,其中包含光标下指标的相关详细信息。您可以通过点击热图固定此提示的位置。固定提示会显示关于指标的更多详细信息。固定提示还便于您更轻松地截取提示的屏幕截图,或从提示中复制信息。

切换指标

默认情况下,当您打开 Key Visualizer 扫描时,它会显示文档键的操作数/秒指标,让您大致了解您的使用模式。如要切换到其他指标,请点击热图上方的指标下拉列表,然后点击要查看的指标。

如果是索引键,则会显示“每秒索引写入操作次数”指标,以大致了解索引键的使用情况。

有关每个指标的说明,请参阅 Key Visualizer 指标

查找文档键的不同指标之间的关联

要比较指标或查找指标之间的相关性时,您可以在 Key Visualizer 中同时查看多个指标。例如,您可能想要查看操作/秒热图上的热点是否与平均写入延迟时间热图中的高延迟相关联。

如需同时查看多个指标及其值,请点击右上角附近的显示信息面板。指标列表将显示在扫描右侧的窗格中。

显示 for_a_scan 的多指标窗格的示例

要一次检查多个指标,请在多指标窗格中使用以下工具:

  • 要显示或隐藏所有指标的微型热图,请点击右上角的 Expand AllCollapse All

  • 要显示单个指标的热图,请点击该指标的名称。

  • 要隐藏单个指标的热图,请再次点击该指标的名称。

  • 要在主窗口中显示指标的热图,请点击指标标题栏左侧边缘的实心箭头。

    左箭头显示主窗口中的指标

  • 将鼠标悬停在微型热图上,您可以在主视图中查看相应的活动。

要在同一时间点比较键桶的不同指标,您可以在扫描中固定一个值,然后在同一时间点切换到不同的指标:

  1. 在主窗口中指向大型热图的相关位置。
  2. 点击以固定提示。侧窗格中的值保持固定在相应键桶和您固定的时间点。
  3. 要在大型热图中显示指标,请点击左侧的实心箭头以获取该指标。主窗口中的提示显示该指标的完整详细信息。

后续步骤