本页面介绍了如何使用查询数据分析信息中心检测和分析查询性能。
Query Insights 概览
使用“查询数据分析”信息中心监控与指标相关的查询。 根据这些指标，您可以确定最常用的查询以及延迟时间较长可能需要优化的查询。您可以使用“查询数据分析”信息中心来帮助您：
- 查询性能优化：识别延迟时间较长且可能需要优化的查询。
- 查询费用管理：发现高费用查询并对其进行优化，以降低费用。
- 查询统计信息监控：跟踪一段时间内的查询统计信息。
Query Insights 数据
查询数据分析包含以下 API 方法中的数据：
您可以查看在指定项目、数据库和时间段（10 分钟到 30 天）内使用这些方法的查询的相关数据。具有等效结构的查询的数据会捕获在单个标准化查询下。
Query Insights 会返回有关查询的以下信息：
| 规范化查询文本 | 以文本形式表示的查询结构。 |
| 执行次数 | 所选时间范围内的执行次数。 |
| 错误数 | 所选时间范围内的错误数。 |
| 平均执行时长（毫秒） | 数据库处理查询所用的平均时间（以毫秒为单位）。 |
| 返回的平均结果数 | 查询返回的结果数。结果包括实体、种类 ID、投影和汇总的存储分区。 |
| 扫描的实体平均数量 | 查询中扫描的实体数量。 |
| 扫描的索引条目的平均数量 | 为执行查询而检查的索引条目数。 |
| 负载（按平均时长） | 有助于根据平均延迟时间过滤热门查询的数据。 |
| 负载（按总 [可结算] 读取操作次数） | 有助于根据总可结算读取操作次数过滤出热门查询的数据。 |
数据粒度和保留
数据粒度取决于指定的时长：
- 对于最长 4 天前的时间段，以 10 分钟为粒度
- 最长可追溯至 30 天前，时间段粒度为 1 小时
Query Insights 的最长数据保留期限为 30 天。10 分钟数据的存储期限为 4 天，每小时数据的存储期限为 30 天。
限制
- Query Insights 数据会延迟一到两个小时。
价格
查询数据分析不会产生额外费用。
所需的角色
如需获得查看“查询洞见”信息中心所需的权限，请让您的管理员为您授予项目的 Datastore Viewer (roles/datastore.viewer) IAM 角色。
如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含查看 Query Insights 信息中心所需的 datastore.insights.get 权限。
查看 Query Insights
如需查看 Datastore 模式 Firestore 数据库的查询分析，请在 Google Cloud 控制台中打开数据库的查询分析窗格。
在 Google Cloud 控制台中，前往数据库页面。
从数据库列表中选择一个数据库。
在导航菜单中，点击查询数据分析。
使用加载类型下拉菜单，按延迟时间或读取操作次数查找热门查询。