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

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

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

# 租户全链路诊断配置

更新时间：2023-11-21 09:58:00

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

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

## 前提条件

已开启全链路诊断相关配置，详细说明，请参见 [配置链路查询相关参数](https://www.oceanbase.com/docs/common-ocp-1000000000348097)。

## 背景信息

在开启全链路诊断后，您可以：

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

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

#### 注意

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

## 租户全链路诊断配置

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

#### 说明

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

1. 登录 OCP。
 2. 单击左侧导航栏 **租户** ，进入租户页面。
 3. 在 **租户列表** 区域选择需要操作的租户，进入租户详情页面。
 4. 在右上角菜单中单击 **全链路诊断配置**。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421/OAS/%E5%85%A8%E9%93%BE%E8%B7%AF%E8%AF%8A%E6%96%AD%E9%85%8D%E7%BD%AE-1.png)
 5. 配置参数。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421/OAS/%E5%85%A8%E9%93%BE%E8%B7%AF%E8%AF%8A%E6%96%AD%E9%85%8D%E7%BD%AE-2.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/421/OAS/%E5%85%A8%E9%93%BE%E8%B7%AF%E8%AF%8A%E6%96%AD%E9%85%8D%E7%BD%AE-3.png)
 6. 配置参数。

   ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/ocp/421/OAS/%E5%85%A8%E9%93%BE%E8%B7%AF%E8%AF%8A%E6%96%AD%E9%85%8D%E7%BD%AE-2.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) 咨询热线