查询链路

本节为您介绍如何使用 OCP 查询业务端执行超过特定时间的 Trace。当您在 SQL 诊断中获取到异常 SQL 的 SQL ID，或在日志查询页面中获取到异常 log 的 SQL Trace ID 时，可通过使用所获取的信息作为查询条件来查看详细链路信息。

背景信息

OceanBase 是一个分布式数据库。一次数据库请求或事务处理可能会跨多个 OceanBase 实例。同时，在典型的部署架构中，还会涉及 OBProxy 和数据库驱动（JDBC 或 libobclient 等）。一次数据库请求会从数据库驱动到 OBProxy、再由一个或多个 OceanBase 实例来执行，同时还会涉及中间的网络链路。调用链路的复杂，导致定位异常情况或性能问题时变得很困难。

全链路诊断功能就是为了解决上述问题。OceanBase 和 OBProxy 通过 Trace 日志，记录了链路之间的上下游关系，以及关键执行步骤的上下文信息和耗时。OCP 收集这些日志加以处理和存储后，向用户提供了链路的搜索及展示能力。您可以根据设定的条件搜索链路，并直观地查看整个链路的详细信息，方便您快速定位问题所在。更多内容参见 体验全链路诊断。

前提条件

• 当前登录 OCP 的用户具有您的链路查询对象的 只读 权限。
• 已部署 OpenSearch 集群，详情可参考 OpenSearch 相关说明。
• 已配置好链路查询相关参数，详情可参考 配置链路查询参数。
• 仅支持对 OceanBase V4.0 及以上版本的租户进行链路查询。

操作步骤

1. 登录 OCP。

2. 在左侧导航栏中选择 系统管理 > 日志服务 。

3. 单击 链路查询 页签，进入 链路查询 界面。

4. 可通过在 链路查询 界面中设置查询条件，辅助定位目标 Trace。

   

   查询条件说明如下。

   条件类别	设置说明
   时间范围	默认为近一个小时。 您可通过左边框快速定义范围为近 5/10/15/30 分钟或近 1/3/6/12/24 小时，也可通过右边时间起始框自定义时间范围。
   目标租户	必填项，选择要查询的具体租户。
   搜索内容	输入 SQL ID 或 SQL Trace ID，链路查询时会筛选出该 ID 下的所有 Trace。
   执行时间	默认为 0 ms。您可对时间进行设定，执行时长超过该设定值的 Trace 将被展示。

5. 单击 查询 按钮。

   界面下方展示符合查询条件的链路。

   

   • 若搜索内容中填入 SQL ID 作为查询条件进行查询，可查看相同 SQL ID 下的 SQL 执行时间分布图及所有链路信息。

     

   • 若搜索内容中填入 SQL Trace ID 作为查询条件进行查询，可查看此次执行的链路信息。

     

6. 单击链路 TraceId，进入链路详情页面查看链路数据及 span 详情。

   • 将光标悬停至 span 节点的时间轴上，在弹窗中将展示 span 的详细信息。

   • 将光标悬停至 sql_compile 节点的时间轴上时，弹窗中将额外展示该 sql 的 SQL ID。

     单击 SQL ID ，可跳转至 SQL 详情页查看该 SQL 的运行情况、执行计划、绑定的索引以及是否限流。详情可参考 查看 SQL 详情。