首批通过分布式安全可靠测评,为关键业务系统打造
租户全链路追踪配置
更新时间:2026-02-28 20:04:58
本文介绍租户的全链路追踪配置的开关方法及使用说明。
背景信息
在开启全链路追踪后,您可以:
- 在 日志服务 > 链路查询 中查询异常 SQL 的链路诊断结果,详细说明,请参见 查询链路。
- 在 SQL 诊断 > SlowSQL > SQL 采样 中,选择查看调用链路,详细说明,请参见 诊断 SlowSQL。
OCP V4.2.1 版本新增支持租户级和会话级的全链路追踪配置,可根据需求开启或关闭指定对象。
注意
全链路追踪在默认配置下对于 OceanBase 数据库服务存在 2% 上下的性能影响,建议在性能敏感场景关闭本功能。
前提条件
请确保当前登录 OCP 的用户具备如下权限:
- 集群维护 或 租户维护 资源权限。
- 租户 概览 菜单权限。
已开启全链路追踪相关配置,详细说明,请参见 配置链路查询相关参数。
租户全链路追踪配置
通过租户概览页的全链路追踪配置启用或关闭全链路追踪功能。
说明
- 业务租户处于锁定状态不支持开启全链路追踪(sys 租户除外)。
- 已开启全链路追踪(租户或者 Session)不影响业务租户被锁定,全链路追踪功能默认被关闭。
- 已开启全链路追踪(租户或者Session) 不影响业务租户被删除。
- 关闭租户级别全链路追踪则关闭租户下所有会话的全链路追踪。
- 租户级别全链路追踪的变更 应用至本租户下的全部会话。
登录 OCP。
在左侧导航栏选择 租户 ,系统默认进入 租户列表 页签。
在 租户列表 中选择待操作的租户并单击其租户名,进入租户 概览 页面。
单击右上角 ... 图标,选择 全链路追踪配置 。

配置参数。

参数 说明 跟踪级别 可选范围为级别 1、级别 2、级别 3,其中 Level1 为模块级别的粗粒度,Level3 的粒度最精细。 采样比例 默认 10%,可选范围 0~100%。 采样内容 - ALL: 所有命中采样的打印日志。
- ONLY_SLOW_QUERY:所有命中采样并且是属于 slow query 的会打印到日志文件中, 其余均丢弃, 对于该打印策略,这个 slow 是 query 的 slow 阈值 sever 反馈(默认值)。
- SAMPLE_AND_SLOW_QUERY:所有命中采样的打印 slow_query(ONLY_SLOW_QUERY),并且万分之一的概率打印采样日志(ALL ,这种需要设置为 force flush)。
是否启用 默认开启,关闭后禁用全链路追踪功能。
会话级全链路追踪配置
通过会话管理页的全链路追踪配置启用或关闭全链路追踪功能。
- 已开启租户级别全链路追踪时,可以单独关闭单个会话级别的开关。
- 会话级别全链路追踪的变更仅作用于本会话。
操作步骤:
登录 OCP。
在左侧导航栏选择 租户 ,系统默认进入 租户列表 页签。
在 租户列表 中选择待操作的租户并单击其租户名,进入租户 概览 页面。
在租户页面左侧导航栏,选择 会话管理 。
在租户会话列表中,选择需要操作的会话,在 更多 中选择 全链路追踪配置 。

配置参数。

参数 说明 跟踪级别 可选范围为级别 1、级别 2、级别 3,其中 Level1 为模块级别的粗粒度,Level3 的粒度最精细。 采样比例 默认 10%,可选范围 0~100%。 采样内容 - ALL: 所有命中采样的打印日志。
- ONLY_SLOW_QUERY:所有命中采样并且是属于 slow query 的会打印到日志文件中, 其余均丢弃, 对于该打印策略,这个 slow 是 query 的 slow 阈值 sever 反馈(默认值)。
- SAMPLE_AND_SLOW_QUERY:所有命中采样的打印 slow_query(ONLY_SLOW_QUERY),并且万分之一的概率打印采样日志(ALL ,这种需要设置为 force flush)。
是否启用 默认开启,关闭后禁用全链路追踪功能。