Key Visualizer 使用入门。

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

准备工作

如需使用适用于 Datastore 模式的 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 会在 Ops/s 指标中打开；对于索引键，Key Visualizer 会在索引写入操作次数/秒指标中打开。

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

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

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

Key Visualizer 扫描示例

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

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

给定单元上的索引写入操作次数/秒指标用于测量相应的 10 秒时间间隔和键范围内每秒平均索引写入次数。