查询洞察仪表板
您可以通过 OpenSearch Dashboards 与查询洞察功能进行交互。这为您提供查询性能的实时和历史洞察，提供分析和监控以改进集群中查询的运行方式。
导航
登录 OpenSearch Dashboards 后，您可以通过导航到 OpenSearch Plugins > Query insights 找到查询洞察页面。
如果启用了多个数据源，则可以通过导航到 Data administration > Performance > Query insights 找到查询洞察页面。
查询洞察仪表板包含以下页面
Top N 查询
Top N 查询页面提供了对系统资源或性能影响最大的查询的详细概述。在此页面上，您可以分析查询指标，例如延迟、CPU 时间和内存使用情况。
以下是带有每个组件字母标签的Top N 查询页面图像。
每个标签对应以下组件
A. 导航选项卡
导航选项卡允许您在配置和Top N 查询页面之间切换。
B. 搜索查询栏
搜索查询栏根据查询类型或索引等特定属性过滤查询。您可以使用过滤器部分中显示的其他过滤器。
C. 过滤器
过滤器下拉菜单允许您选择以下查询过滤器。
| 过滤器 | 描述 | 示例 |
|---|---|---|
| 类型 | 按查询类型过滤。 | query, group |
| 索引 | 根据特定的 OpenSearch 索引过滤查询。 | index1, index2 |
| 搜索类型 | 按搜索执行方法过滤。 | query then fetch |
| 协调节点 ID | 聚焦于特定协调节点执行的查询。 | node-1, node-2 |
| 时间范围 | 调整显示查询的时间范围。 | 过去 1 天 |
D. 日期范围选择器
数据范围选择器分析在设定的时间范围内发送的查询。您还可以选择显示日期以提供每个查询的详细时间戳。
E. 刷新按钮
刷新按钮根据选定的过滤器和时间范围重新加载查询数据。
F. 指标表
指标表会根据您的类型过滤器选择（查询、组或两者）动态调整。动态列通过仅显示每个查询类型相关的数据来提高清晰度。
当您仅选择查询时，表格会显示单个指标，包括延迟、CPU 时间和内存使用情况。不显示查询计数列，因为每行代表一个单一查询，如下图所示。
当您仅选择组时，表格会显示聚合指标，包括平均延迟、平均 CPU 时间和平均内存使用情况。查询计数列显示每个组中有多少查询，如下图所示。
当您同时选择组和查询时，表格会显示组合指标，包括平均值和原始值，如下图所示。
下表提供了每个指标以及选择查询和组时与该指标相关的查询和组的描述。
| 列名 | 描述 | 查询已选 | 组已选 | 查询 + 组已选 |
|---|---|---|---|---|
| ID | 查询或组的唯一标识符。 | ID | ID | ID |
| 类型 | 指示条目是查询还是组。 | 类型 | 类型 | 类型 |
| 查询计数 | 组中聚合的查询数量。 | 不显示 | 查询计数 | 查询计数 |
| 时间戳 | 记录查询或组的时间（组可能为空）。 | 时间戳 | 不显示 | 时间戳 |
| 延迟 | 单个查询执行所需的时间。 | 延迟 | 平均延迟 | 平均延迟/延迟 |
| CPU 时间 | 消耗的 CPU 资源数量。 | CPU 时间 | 平均 CPU 时间 | 平均 CPU 时间/CPU 时间 |
| 内存使用情况 | 执行期间使用的内存量。 | 内存使用情况 | 平均内存使用情况 | 平均内存使用情况/内存使用情况 |
| 索引 | 查询或组中涉及的索引列表。 | 索引 | 不显示 | 索引 |
| 搜索类型 | 使用的搜索执行方法（例如query或fetch）。 | 搜索类型 | 不显示 | 搜索类型 |
| 协调节点 ID | 协调查询的节点。 | 协调节点 ID | 不显示 | 协调节点 ID |
| 总分片 | 查询处理中涉及的分片数量。 | 总分片 | 不显示 | 总分片 |
当您选择查询 + 组
- 如果所有显示行都是查询，则表格遵循查询已选行为。
- 如果所有显示行都是组，则表格遵循组已选行为。
查询详情
查询详情页面提供查询行为、性能和结构的洞察。您可以通过选择查询 ID 来访问查询详情页面，如下图所示
查看单个查询详情
您可以通过选择查询 ID（例如51c68a1a-7507-4b3e-aea1-32ddd74dbac4）来访问单个查询的详细信息。查询详情页面将出现，如下图所示。
在查询详情视图中，您可以查看诸如时间戳、CPU 时间、内存使用情况、索引、搜索类型、协调节点 ID 和总分片等信息。
查看查询组详情
查询组详情视图提供了一组相似查询的聚合指标洞察。
要查看查询组详情，请在Top N 查询列表中选择标记为“组”的查询 ID。查询组详情视图提供以下信息
- 查询聚合摘要部分提供了整个组的关键查询指标视图，包括平均延迟、平均 CPU 时间、平均内存使用情况和分组依据标准。
- 示例查询详情部分提供了单个代表性查询的信息，包括其时间戳、索引、搜索类型、协调节点 ID 和总分片。
- 查询部分显示查询的 JSON 结构。
- 延迟部分以图形方式表示查询的运行阶段。
配置
查询洞察 - 配置页面旨在让您控制查询洞察功能如何收集、监控、分组和保留数据。下图显示了配置页面。
在配置页面上，您可以配置以下部分所述的设置。
Top N 查询监控
Top N 查询监控配置设置允许您跟踪查询性能指标，例如延迟、CPU 使用率和内存，以分析和优化查询性能。配置界面通过结构化的菜单驱动设置，您可以定义要监控的特定指标、设置分析阈值以及自定义监控持续时间。
执行以下操作以配置 Top N 查询设置
- 从查询洞察页面，导航到配置选项卡。
- 选择指标类型：延迟、CPU 使用率或内存。
- 切换启用设置以开启或关闭所选指标的 Top N 查询功能。
- 指定监控窗口大小，它决定了为分析收集查询的时间长度。
- 输入 N 的值，它定义了每个窗口中要跟踪的 Top 查询数量。
- 选择保存。
- 检查配置指标状态面板以查看启用的指标。
Top N 查询分组
Top N 查询组配置设置用于设置查询的分组设置。
使用以下步骤设置特定的分组属性
- 在分组依据下选择一个分组选项，例如相似性。
- 选择保存。
- 检查分组依据状态面板以验证分组依据标准是否已启用。
数据导出和保留
要配置数据导出和保留，请使用查询洞察导出和数据保留设置面板。您可以在其中设置以下设置
- 在导出器下，选择数据的目标，例如本地索引。
- 在删除后（天）字段中设置数据保留期限。
- 选择保存。
- 在数据保留状态面板中，确保导出器设置已启用。
配置最佳实践
配置查询洞察功能时，请记住以下最佳实践
- 从较小的 N 值（计数）开始，并根据系统负载增加它。
- 仔细选择您的窗口大小。较长的窗口大小可以节省计算资源，因为找到的洞察粒度较低。相反，较短的窗口大小可以输出更全面的查询洞察，但会使用更多资源。
- 设置数据保留期限时，考虑较短的保留期限，这可以节省存储空间但会减少长期洞察的数量。
- 根据您的监控需求启用指标。监控较少的指标可以防止系统过载。