此页面由 Cloud Translation API 翻译。

Key Visualizer 使用入门。

本页介绍如何使用 Key Visualizer 检查与您的 Firestore 使用模式相关的性能问题。

准备工作

如需使用 Firestore 的 Key Visualizer，您必须启用 Firestore Key Visualizer API。

确保您的账号已被授予以下某个 IAM 角色：

这些角色包含访问 Key Visualizer 所需的以下 IAM 权限：

您还可以定义具有所需权限的自定义角色。

每个 Key Visualizer 扫描需要两个小时时长。给定时间段内的扫描适用于该时间段内任何给定分钟内流量超过 3000 次的文档操作的数据库。

如需启动 Key Visualizer，请执行以下操作：

在 Google Cloud 控制台中，转到数据库页面。

前往“数据库”
从数据库列表中选择所需的数据库。
在导航菜单中，点击 Key Visualizer。
从可用的 Key Visualizer 扫描中选择时间范围和指标：
1. 点击右上角的铅笔图标。选择日期和时间范围。
  
  根据扫描资格提供扫描。您无法选择不符合扫描资格或仍在处理的时间范围。当天的两次最新扫描需要一段时间才能处理完成，然后才可使用。
2. 选择所有文档数据或所有索引数据作为来源。
3. 点击更新。
选择要分析的指标：

点击左上角的指标下拉列表，然后选择要查看的指标。默认情况下，Key Visualizer 会在操作/秒指标（对于文档键）和索引写入操作/秒指标（对于索引键）中打开。

如需比较指标或找出数据关联性，您可以同时显示多个 Key Visualizer 指标。请参阅查找不同指标之间的关联。

如需大致了解所选两小时内的活动，请查看默认指标的热图。

以下为一个热图示例，其中不同键范围的使用模式存在重大差异：

Key Visualizer 扫描示例

Ops/s 指标用于衡量每个键范围的每秒请求数。此指标是写入、查找和查询请求的总和。默认情况下，当您打开热图时，Key Visualizer 会显示此指标。

在了解数据库中的整体活动后，您可以通过查看其他指标并关注可能导致问题的关键范围来继续调查。了解详情。

给定单元格的 Index Write Ops/s 指标用于衡量相应 10 秒时间间隔和键范围内的每秒平均索引写入次数。