/ /

使用查询形状见解监控查询形状统计信息

您可以使用查询形状监控运行缓慢的查询结构的操作级查询执行指标。Query Shape Insights 页面显示图表和表格，描述项目中总执行时间最长的查询结构的性能指标。您可以按托管、分片和时间范围过滤显示的查询结构数据，并选择最多五个查询结构在相应的指标图表中进行可视化。

Atlas仅在运行MongoDB 8.0 及更高版本的专用集群（M10 及更高版本）上支持查询形状见解。

注意

为了确保具有高查询量的集群的性能和可扩展性，查询形状见解可能会显示集群上运行的示例查询样本设立的数据。

必需的访问权限

要使用查询形状见解查看指标，您必须拥有项目的 Project Observability Viewer、Project Data Access Read Only、Project Data Access Read/Write、Project Data Access Admin 或 Project Owner访问权限。

重要

查询形状会公开字段名称，但编辑后的值可能包含用户 PII。要在查询形状见解中查看截断或完整查询形状，您必须具有上面列出的项目角色之一，每个角色都具有查看PII的访问访问权限。对于没有这些权限的用户，查询形状见解会通过其查询结构哈希来识别查询形状。

访问查询结构见解

要访问权限查询结构见解，请执行以下操作：

AtlasGoClusters在Atlas中，Go项目的页面。

如果尚未显示，请从导航栏上的 Organizations 菜单中选择包含所需项目的组织。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
在侧边栏中，单击 Database 标题下的 Clusters。

会显示集群页面。

GoQuery Shape Insights 。

在项目面板中单击该实例的 View Monitoring。
单击 Query Insights 标签页。
默认显示 Query Shapes标签页。

筛选查询见解

您可以按节点、节点状态（主节点 (primary node in the replica set)或从节点(secondary node from replica set)）和分片过滤Query Insights 页面。您还可以按过去 7 天内的自定义日期范围进行过滤，或选择以下预设时间范围之一：

7 天
5 天
2 天
24 小时（默认）
12 小时
8 小时
1 小时

当您应用过滤时， Atlas会重新获取当前屏幕上的图表和表格的数据。

注意

按从从节点(secondary node from replica set)状态过滤时，分析节点包括在内。

查看Charts和表格中的指标

查询形状见解显示图表和表格，描述项目中查询运行缓慢的查询形状的指标。

查询结构见解表对于项目中的每个热门查询结构都包含一行，其中热门查询结构由最高总执行时间确定。每行包含查询结构或其查询结构哈希、查询结构的命名空间、查询命令以及您选择显示的任何指标。您可以使用 Edit Columns 按钮选择将以下哪些指标作为表列包含在内：

衡量标准	说明
总执行时间	运行具有给定查询结构的查询所花费的总时间（以微秒为单位）。如果查询生成 `getMore` 命令，则该指标包括处理 `getMore` 请求所花费的时间。该指标不包括等待客户端所花费的时间。
平均执行时间	运行具有给定查询结构的查询所花费的平均时间（以微秒为单位）。如果查询生成 `getMore` 命令，则该指标包括处理 `getMore` 请求所花费的时间。该指标不包括等待客户端所花费的时间。
执行计数	执行具有给定查询结构的查询的总次数。
检查的键	具有给定查询结构的查询检查的界内和界外索引键总数。
检查的键：已返回	检查的界内和界外索引键与包含给定查询结构的查询返回的文档的索引的比率。
检查的Docs	具有给定查询结构的查询检查的文档总数。
返回的Docs	具有给定查询结构的查询返回的文档总数。
检查的Docs：已返回	具有给定查询结构的查询检查的文档与返回的文档的比率。
总响应时间	从查询处理开始到服务器第一次响应所花费的时间（以微秒为单位）。
上次执行时间	具有给定查询结构的最近查询的执行时间（以微秒为单位）。
P50 执行时间	执行时间直方图中的第 50 个百分位数。
P90 执行时间	执行时间直方图中的第 90 个百分位数。
P99 执行时间	执行时间直方图中的第 99 个百分位数。

您还可以从 Query Shape Statistics 组件标题的下拉菜单中选择要图表图表的 ecah 指标，以显示上述一个或多个指标的图表。

Atlas一次可以为最多五个查询形状的每个指标图表。默认下， Atlas Charts具有最高 Total Execution Time 的五个查询形状的每个指标绘制图表。您可以通过选中或取消选中所需查询形状行中的复选框来选择以图表图表不同的查询形状。您可以通过选择或取消选择所需查询形状行中的复选框，从表中管理要图表图表的查询形状。

要查看有关查询结构的更多详细信息，请单击查询结构对应的行以打开 Query Shape Details 视图。此视图包含完整的查询结构和查询结构哈希、上面列出的每个表指标以及以下附加指标：

上次查看时间戳
首次出现时间戳
上次查看的应用程序
上次看到的驱动程序名称和版本
首次出现的应用程序
首次出现的驱动程序名称和版本

选择要绘制图表的查询形状

默认下，Query Shape Insights 显示 Total Execution Time 最高的前五个查询结构的指标图表。您最多可以选择五个查询形状，在 Query Shape Insights（图表）表中图表。

要在 Query Shape Insights 表中搜索并选择查询形状，请执行以下操作：

（可选）筛选表条目。

您可以按以下类别过滤Query Shape Insights 表：

查询结构：在 Search by Query Shape搜索框中，输入查询结构或其关联的查询哈希。
命名空间：在 Select Namespaces 下拉菜单中，选择一个或多个命名空间作为过滤依据。
命令：在 Select Commands 下拉菜单中，选择一个或多个命令作为过滤依据。

（可选）更改排序顺序。

您可以按一个或多个指标列对 Query Shape Insights 表进行排序，以帮助确定要图表的查询形状。

要按指标降序或升序排序，请分别单击关联列名称旁边的 sort 图标一次或两次。要按多列排序，请按 Shift，然后按照要对表格进行多重排序的顺序单击 sort 图标。

选择查询形状。

单击所需查询结构行中的复选框。

您一次最多可以选择五个查询形状。

后退

使用 MCP 服务器访问

来年

查询延迟

注意

必需的访问权限

重要

访问查询结构见解

AtlasGoClusters在Atlas中，Go项目的 页面。

GoQuery Shape Insights 。

筛选查询见解

注意

查看Charts和表格中的指标

选择要绘制图表的查询形状

（可选）筛选表条目。

（可选）更改排序顺序。

选择查询形状。

AtlasGoClusters在Atlas中，Go项目的页面。