--- title: "全链路追踪流程 - OceanBase 数据库 V4.1.0 | OceanBase 文档中心" description: 全链路追踪流程 在全链路中，不同的请求有对应的请求链路。一条完整的请求链路则是若干个请求流程构成，在 OceanBase 数据库将内部处理的每一个流程定义为一个 Span。请求链路可以理解为树状图，包含父节点 span 以及相应的子节点 span，此部分信息会被打印到 trace 日志中，并通过 parent_id … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.1.0 # 全链路追踪流程 更新时间：2023-07-28 10:45:58 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.1.0/zh-CN/700.reference/200.administrator-guide/700.management/300.daily-inspection/900.full-link-detection/200.full-link-tracking-process.md) 在全链路中，不同的请求有对应的请求链路。一条完整的请求链路则是若干个请求流程构成，在 OceanBase 数据库将内部处理的每一个流程定义为一个 Span。请求链路可以理解为树状图，包含父节点 span 以及相应的子节点 span，此部分信息会被打印到 trace 日志中，并通过 `parent_id` 与 `id` 来关联父子节点。同时，在 trace 日志中对于每个请求流程会包含实际执行 SQL 信息，这部分被命名为 tag，以不同的 tag 来记录当前操作的详细信息。span 和 tag 被记录在 trace 日志中，来帮助运维人员理解数据库内部的处理逻辑以及定位问题所在。 根据整条访问链路，将其分为 3 个部分来介绍。 ## 客户端 应用通过 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 的 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.0.0/user-guide/%E4%B8%8D%E5%90%8C%E8%AF%B7%E6%B1%82%E7%B1%BB%E5%9E%8B%E7%9A%84%E8%AE%BF%E9%97%AE%E9%93%BE%E8%B7%AF.png) 相关 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) 咨询热线