--- title: "全链路追踪概述 - OceanBase 数据库 V4.3.2 | OceanBase 文档中心" description: 全链路追踪概述 什么是全链路追踪？ OceanBase 数据库作为一个分布式系统，拥有复杂的调用链路。当出现超时问题的时，往往无法快速定位是 OceanBase 内部组件或是网络的问题，运维人员只能根据经验和 observer 日志进行分析。为了提高诊断效率，本次更新引入了一种全新的全链路追踪机制，能够追踪用户 SQ… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.2 # 全链路追踪概述 更新时间：2024-12-18 17:36:52 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.2/zh-CN/600.manage/900.daily-inspection/900.full-link-detection/100.full-link-diagnosis-overview.md) ## 什么是全链路追踪？ OceanBase 数据库作为一个分布式系统，拥有复杂的调用链路。当出现超时问题的时，往往无法快速定位是 OceanBase 内部组件或是网络的问题，运维人员只能根据经验和 observer 日志进行分析。为了提高诊断效率，本次更新引入了一种全新的全链路追踪机制，能够追踪用户 SQL 请求在数据库全链路过程中，在不同组件、不同阶段执行的相关信息，并以可视化方式展现给用户，从而帮助用户快速定位问题所在位置，旨在助力用户快速精准地发现组件内部问题。 ### 全链路追踪路径 全链路追踪覆盖了两条主要的数据流路径。 - 第一条是请求从应用出发，通过客户端（比如 JDBC 或 OCI）传递至 ODP（代理服务器），然后由 ODP 转发至 OBServer，最终结果返回给应用程序。 - 第二条则是请求直接从应用程序通过客户端发送至 OBServer，然后结果直接返回。 全链路追踪的目的是对这两条路径上的所有组件进行问题定位。 用户可以通过客户端连接到 OceanBase 数据库，在客户端发送请求时，请求或者由 OBProxy 中转至 OBServer，或者直接到达 OBServer。通过全链路追踪功能，运维人员可以使用 PL/SQL 的 [DBMS_MONITOR](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001054053) 包中的方法，根据需要控制和监控应用程序是否开启全链路跟踪（trace），以及跟踪信息的打印细节。 ### 全链路追踪的日志 全链路追踪的日志，即跟踪日志（trace logs），它会根据数据访问路径来决定其记录细节。如果是通过 ODP 访问数据库，跟踪信息会同时记录在 OBProxy 和 OBServer 的日志文件中；若是直接访问 OBServer，则只在 OBServer 的日志文件中记录。具体而言，OBProxy 的跟踪日志文件命名为 `obproxy_trace.log`，而 OBServer 的命名为 `trace.log`。每个日志文件的大小限制为 256MB，当日志达到这一大小限制时，系统将创建新的日志文件，并将旧文件归档。归档文件的数量由配置项 [max_syslog_file_count](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001052420) 控制，超出的文件将被自动删除。 运维人员可通过搜集和分析所有跟踪日志，来追踪每个事务或 SQL 查询在整个调用链路上的执行时间和其他相关信息。这不仅为问题的准确定位提供了重要线索，还大大提升了运维效率。 上一篇 下一篇 ![有帮助](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) 咨询热线