--- title: "查询链路 | OceanBase 文档中心" description: 查询链路 本节为您介绍如何使用 OCP 查询业务端执行超过特定时间的 Trace。当您在 SQL 诊断中获取到异常 SQL 的 SQL ID，或在日志查询页面中获取到异常 log 的 SQL Trace ID 时，可通过使用所获取的信息作为查询条件来查看详细链路信息。 背景信息 OceanBase 是一个分布式数据库… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.0.0 企业版 # 查询链路 更新时间：2026-04-14 16:45:43 本节为您介绍如何使用 OCP 查询业务端执行超过特定时间的 Trace。当您在 SQL 诊断中获取到异常 SQL 的 SQL ID，或在日志查询页面中获取到异常 log 的 SQL Trace ID 时，可通过使用所获取的信息作为查询条件来查看详细链路信息。 ## 背景信息 OceanBase 是一个分布式数据库。一次数据库请求或事务处理可能会跨多个 OceanBase 实例。同时，在典型的部署架构中，还会涉及 OBProxy 和数据库驱动（JDBC 或 libobclient 等）。一次数据库请求会从数据库驱动到 OBProxy、再由一个或多个 OceanBase 实例来执行，同时还会涉及中间的网络链路。调用链路的复杂，导致定位异常情况或性能问题时变得很困难。 全链路诊断功能就是为了解决上述问题。OceanBase 和 OBProxy 通过 Trace 日志，记录了链路之间的上下游关系，以及关键执行步骤的上下文信息和耗时。OCP 收集这些日志加以处理和存储后，向用户提供了链路的搜索及展示能力。您可以根据设定的条件搜索链路，并直观地查看整个链路的详细信息，方便您快速定位问题所在。更多内容参见 [体验全链路诊断](https://www.oceanbase.com/docs/enterprise-oceanbase-database-cn-10000000000886284)。 ## 前提条件 - 当前登录 OCP 的用户具有您的链路查询对象的 **只读** 权限。 - 已部署 OpenSearch 集群，详情可参考 [OpenSearch 相关说明](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000000775940)。 - 已配置好链路查询相关参数，详情可参考 [配置链路查询参数](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000000775813)。 - 仅支持对 OceanBase V4.0 及以上版本的租户进行链路查询。 ## 操作步骤 1. 登录 OCP。 2. 在左侧导航栏中选择 **系统管理 > 日志服务** 。 3. 单击 **链路查询** 页签，进入 **链路查询** 界面。 4. 可通过在 **链路查询** 界面中设置查询条件，辅助定位目标 Trace。 ![1216](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E9%93%BE%E8%B7%AF%E6%9F%A5%E8%AF%A22.png) 查询条件说明如下。 | 条件类别 | 设置说明 | | --- | --- | | 时间范围 | 默认为近一个小时。 您可通过左边框快速定义范围为近 5/10/15/30 分钟或近 1/3/6/12/24 小时，也可通过右边时间起始框自定义时间范围。 | | 目标租户 | 必填项，选择要查询的具体租户。 | | 搜索内容 | 输入 SQL ID 或 SQL Trace ID，链路查询时会筛选出该 ID 下的所有 Trace。 | | 执行时间 | 默认为 0 ms。您可对时间进行设定，执行时长超过该设定值的 Trace 将被展示。 | 5. 单击 **查询** 按钮。 界面下方展示符合查询条件的链路。 ![18](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E9%93%BE%E8%B7%AF%E6%9F%A5%E8%AF%A2.png) - 若搜索内容中填入 SQL ID 作为查询条件进行查询，可查看相同 SQL ID 下的 SQL 执行时间分布图及所有链路信息。 ![18](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E9%93%BE%E8%B7%AF%E6%9F%A5%E8%AF%A2-sqlid.png) - 若搜索内容中填入 SQL Trace ID 作为查询条件进行查询，可查看此次执行的链路信息。 ![18](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E9%93%BE%E8%B7%AF%E6%9F%A5%E8%AF%A2-traceid.png) 6. 单击链路 TraceId，进入链路详情页面查看链路数据及 span 详情。 - 将光标悬停至 span 节点的时间轴上，在弹窗中将展示 span 的详细信息。 ![18](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E9%93%BE%E8%B7%AF%E8%AF%A6%E6%83%851.png) - 将光标悬停至 sql_compile 节点的时间轴上时，弹窗中将额外展示该 sql 的 SQL ID。 单击 SQL ID ，可跳转至 SQL 详情页查看该 SQL 的运行情况、执行计划、绑定的索引以及是否限流。详情可参考 [查看 SQL 详情](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-10000000000777055)。 ![18](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/%E9%93%BE%E8%B7%AF%E8%AF%A6%E6%83%852.png) 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线