---
title: "租户全链路追踪配置 - 云平台 OCP V4.4.1 | OceanBase 文档中心"
description: 租户全链路追踪配置 本文介绍租户的全链路追踪配置的开关方法及使用说明。 背景信息 在开启全链路追踪后，您可以： 在 日志服务 > 链路查询 中查询异常 SQL 的链路诊断结果，详细说明，请参见 查询链路 。 在 SQL 诊断 > SlowSQL > SQL 采样 中，选择查看调用链路，详细说明，请参见 诊断 Slow…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.4.1

# 租户全链路追踪配置

更新时间：2026-02-28 20:04:58

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.4.1/zh-CN/700.tenant-functions/600.manage-a-tenant/600.full-link-diagnostic-configuration-of-tenant.md)  

本文介绍租户的全链路追踪配置的开关方法及使用说明。

## 背景信息

在开启全链路追踪后，您可以：

- 在 **日志服务** > **链路查询** 中查询异常 SQL 的链路诊断结果，详细说明，请参见 [查询链路](https://www.oceanbase.com/docs/common-ocp-1000000005295458)。
 - 在 **SQL 诊断** > **SlowSQL** > **SQL 采样** 中，选择查看调用链路，详细说明，请参见 [诊断 SlowSQL](https://www.oceanbase.com/docs/common-ocp-1000000005295695)。

OCP V4.2.1 版本新增支持租户级和会话级的全链路追踪配置，可根据需求开启或关闭指定对象。

#### 注意

全链路追踪在默认配置下对于 OceanBase 数据库服务存在 2% 上下的性能影响，建议在性能敏感场景关闭本功能。

## 前提条件

- 请确保当前登录 OCP 的用户具备如下权限：

     - **集群维护** 或 **租户维护** 资源权限。
     - 租户 **概览** 菜单权限。
 - 已开启全链路追踪相关配置，详细说明，请参见 [配置链路查询相关参数](https://www.oceanbase.com/docs/common-ocp-1000000005295462)。

## 租户全链路追踪配置

通过租户概览页的全链路追踪配置启用或关闭全链路追踪功能。

#### 说明

- 业务租户处于锁定状态不支持开启全链路追踪（sys 租户除外）。
 - 已开启全链路追踪（租户或者 Session）不影响业务租户被锁定，全链路追踪功能默认被关闭。
 - 已开启全链路追踪(租户或者Session) 不影响业务租户被删除。
 - 关闭租户级别全链路追踪则关闭租户下所有会话的全链路追踪。
 - 租户级别全链路追踪的变更 应用至本租户下的全部会话。

1. 登录 OCP。
 2. 在左侧导航栏选择 **租户** ，系统默认进入 **租户列表** 页签。
 3. 在 **租户列表** 中选择待操作的租户并单击其租户名，进入租户 **概览** 页面。
 4. 单击右上角 **...** 图标，选择 **全链路追踪配置** 。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/OAS/%E5%85%A8%E9%93%BE%E8%B7%AF%E8%BF%BD%E8%B8%AA-2.png)
 5. 配置参数。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/OAS/%E5%85%A8%E9%93%BE%E8%B7%AF%E8%BF%BD%E8%B8%AA-1.png)

   | 参数 | 说明 |
   | --- | --- |
   | 跟踪级别 | 可选范围为级别 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)。 |
   | 是否启用 | 默认开启，关闭后禁用全链路追踪功能。 |

## 会话级全链路追踪配置

通过会话管理页的全链路追踪配置启用或关闭全链路追踪功能。

- 已开启租户级别全链路追踪时，可以单独关闭单个会话级别的开关。
 - 会话级别全链路追踪的变更仅作用于本会话。

操作步骤：

1. 登录 OCP。
 2. 在左侧导航栏选择 **租户** ，系统默认进入 **租户列表** 页签。
 3. 在 **租户列表** 中选择待操作的租户并单击其租户名，进入租户 **概览** 页面。
 4. 在租户页面左侧导航栏，选择 **会话管理** 。
 5. 在租户会话列表中，选择需要操作的会话，在 **更多** 中选择 **全链路追踪配置** 。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/OAS/%E5%85%A8%E9%93%BE%E8%B7%AF%E8%BF%BD%E8%B8%AA-3.png)
 6. 配置参数。

   ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/422/OAS/%E5%85%A8%E9%93%BE%E8%B7%AF%E8%BF%BD%E8%B8%AA-1.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) 咨询热线