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