--- title: "全链路追踪流程 - OceanBase 数据库 V4.3.1 | OceanBase 文档中心" description: 全链路追踪流程 在全链路中，不同的请求有对应的请求链路。一条完整的请求链路（Trace）则是若干个请求流程（Span）构成，在 OceanBase 数据库将内部处理的每一个流程定义为一个 Span。请求链路可以理解为树状图，包含父节点 Span 以及相应的子节点 Span，此部分信息会被打印到跟踪日志（trace l… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.1 # 全链路追踪流程 更新时间：2026-04-10 11:58:01 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.1/zh-CN/600.manage/900.daily-inspection/900.full-link-detection/200.full-link-tracking-process.md) 在全链路中，不同的请求有对应的请求链路。一条完整的请求链路（Trace）则是若干个请求流程（Span）构成，在 OceanBase 数据库将内部处理的每一个流程定义为一个 Span。请求链路可以理解为树状图，包含父节点 Span 以及相应的子节点 Span，此部分信息会被打印到跟踪日志（trace logs）中，并通过 `parent_id` 与 `id` 来关联父子节点。同时，在 trace logs 中对于每个请求流程会包含实际执行 SQL 信息，这部分被命名为 tag，以不同的 tag 来记录当前操作的详细信息。Span 和 tag 被记录在 trace logs 中，来帮助运维人员理解数据库内部的处理逻辑以及定位问题所在。 根据整条访问链路，将其分为 3 个部分来介绍。 ## 关键概念 - **Trace**：在全链路追踪流程中，Trace 可以理解为 OceanBase 的一个事务。 - **Span**：属于具体某个 Trace，一个 Trace 可以有多个 Span，Span 可以是语句、函数、匿名块等。 - **tag**：KV，属于具体某个 Span，一个 Span 可以有多个 tag。 - **log**：KV with timestamp，属于具体某个 Span，一个 Span 可以有多个 log。 ## 客户端 应用通过 OBClient 客户端或 JDBC 驱动连接 OceanBase 数据库。 与客户端相关的 Span，有 `obclient` 和 `JDBC` 两种。 - `obclient`：通过 OBClient 客户端进行访问。 - `JDBC`：通过 JDBC 驱动进行连接。 与客户端相关的 tag，有 `command_name` 和 `client_ip` 两种。OBClient 和 JDBC 的 tag 信息是一致的。 - `command_name` 用于标记不同类型的请求，比如文本、prepare、execute 等。 - `client_ip` 用于标记发送请求的 obclient 的 ip 和 port。 ## OBProxy 在此阶段，分为 3 种级别的 Span。此处级别与 [DBMS_MONITOR](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000822515) 的 Trace 相关函数中的变量 level 相对应。 ### 级别 1 这里定义 2 种 Span，`ob_proxy` 和 `ob_proxy_server_process_req`。 - `ob_proxy` 为 OBProxy 对一条 SQL 处理的全部耗时，即 OceanBase 数据库除前端驱动层以外的从数据库请求开始到数据处理完成，结果反馈的整条链路耗时。 - `ob_proxy_server_process_req` 为 OBProxy 对一条 SQL 请求的处理耗时和访问来回的网络开销。 ### 级别 2 这里定义 2 种 Span，`ob_proxy_server_response_read` 和 `ob_proxy_cluster_resource_create`。 - `ob_proxy_server_response_read` 为整体读取 response 结果的耗时。 - `ob_proxy_cluster_resource_create` 为 OBProxy 在请求转发阶段，准备集群资源的耗时。 ### 级别 3 这里定义 4 种 Span，`ob_proxy_partition_location_lookup`、`ob_proxy_do_OBServer_open`、`ob_proxy_client_response_write`、`ob_proxy_server_request_write`。 - `ob_proxy_partition_location_lookup` 为 OBProxy 在请求转发阶段，获取 partition location 准备进行路由的耗时。 - `ob_proxy_do_observer_open` 为 OBProxy 在请求转发阶段，选择 OBServer，connect 等流程的耗时。 - `ob_proxy_client_response_write` 为 OBProxy 在收完 OBServer 的 response 之后，将 response 转发给客户端的耗时。 - `ob_proxy_server_request_write` 为 OBProxy 将客户端请求，转发给 OBServer 的耗时。 ## OBServer ### Span OBServer 内部的处理机制是将分发过来的请求根据请求类型分为文本 SQL、preprocess statement 和存储过程三类，同时在这三类中又包含事务、内部 SQL 以及存储在数据库内部的访问。 下图为不同请求类型的访问链路，可以看出 Span 之间的父子关系。示例：Span `mpquery_single_stmt` 的父 Span 为 `com_query_entry`；Span `com_query_entry` 的子 Span 为 `mpquery_single_stmt`。 ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/observer-enterprise/V4.2.1/600.manage/900.daily-inspection/900.full-link-detection/span.png#id=imj6A&originHeight=934&originWidth=1600&originalType=binary&ratio=1&rotation=0&showTitle=false&status=done&style=none&title=) 相关 span 介绍如下： - com_query_entry：查询过程。 - mpquery_single_stmt：单个语句的访问路径。 - sql_compile：编译 SQL。 - pc_get_plan：获取执行计划。 - hard_parse：硬解析。 - parse：软解析。 - resolve：解析语法树的语义并生成语句。 - rewrite：重写 SQL。 - optimize：进行基于成本的优化并生成执行计划日志。 - code_generate：根据执行计划日志生成物理执行计划。 - pc_add_plan：将生成的执行计划加入 plan cache。 - sql_execute：执行物理执行计划。 - open：打开执行计划。 - response_result：执行计划过程和结果。 - px_schedule：按照 px 划分任务。 - px_task：执行 px 子任务。 - close：关闭执行计划。 - cmd_execute：执行命令。 - cmd_open：开启 cmd 计划。 - ps_prepare：preprocess statement 的预处理。 - ps_execute：preprocess statement 的执行。 - ps_close：关闭 preprocess statement。 - pl_entry：存储过程处理。 - pl_compile：编译存储过程对象。 - pc_get_pl_object：从 plan cache 获取存储过程对象。 - pc_add_pl_object：把存储过程对象存储在 plan cache。 - pl_execute：执行存储过程。 - pl_spi_query：执行存储过程中的 spi 语句。 - pl_spi_prepare：存储过程预处理阶段。 - pl_spi_execute：执行存储过程中的 spi 语句。 - inner_prepare：内部 SQL 的预处理阶段。 - inner_execute：内部 SQL 的执行阶段。 - inner_execute_read：读内部 SQL。 - inner_execute_write：写内部 SQL。 - inner_commit：提交内部 SQL 事务。 - inner_rollback：回滚内部 SQL 事务。 ### 相关 tag 介绍 为丰富部分 Span 的信息，定义了 tag，具体如下所示。 - com_query_entry - log_trace_id：当前请求在 log 中的 trace ID。 - err_code：当前请求的错误代码。 - sql_compile。 - sess_id：session ID。 - sql_text：SQL 文本。 - sql_id：SQL ID。 - hit_plan：执行计划命中执行计划缓存。 - px_task - task_id：并行任务的逻辑 ID。 - dfo_id：数据流操作 ID。 - sqc_id：子查询协调器 ID。 - qc_id：查询协调器 ID。 - group_id：资源组 ID。 - px_schedule - dfo_id：数据流操作 ID。 - used_worker_cnt：正在使用的 px 工作线程的个数。 - qc_id：查询协调器 ID。 - ps_close - ps_id：preprocess statement ID。 上一篇 下一篇 ![有帮助](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) 咨询热线