---
title: "OB_SESSION_TRACE_ENABLE - OceanBase 数据库 V4.5.0 | OceanBase 文档中心"
description: OB_SESSION_TRACE_ENABLE OB_SESSION_TRACE_ENABLE 用于开启 session 级别全链路追踪。 功能适用性 该内容仅适用于 OceanBase 数据库企业版。 语法 DBMS_MONITOR.OB_SESSION_TRACE_ENABLE( session_id IN BI…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.5.0

# OB_SESSION_TRACE_ENABLE

更新时间：2026-02-07 19:33:16

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.5.0/zh-CN/700.reference/600.pl-reference/300.pl-oracle/1400.pl-system-package-oracle/10000.dbms-monitor-oracle/200.ob-session-trace-enable-oracle.md)  

`OB_SESSION_TRACE_ENABLE` 用于开启 session 级别全链路追踪。

#### 功能适用性

该内容仅适用于 OceanBase 数据库企业版。

## 语法

```sql
DBMS_MONITOR.OB_SESSION_TRACE_ENABLE(
    session_id   IN  BINARY_INTEGER DEFAULT NULL,
    level        IN  INT,
    sample_pct   IN  NUMBER,
    record_policy IN VARCHAR2);

```

## 参数解释

| **参数** | **解释** |
| --- | --- |
| session_id | 启用全链路追踪的 `session_id`。如果为空，则表示当前 session 的 `session_id`。 |
| level | 控制 Span 内部数据的采集粒度，分为三个级别：Level 1、Level 2 和 Level 3。 |
| sample_pct | 采样率，取值范围为 [0,1]。 |
| record_policy | 打印的策略，包括以下选项：   - `ALL`：所有命中采样的 query 都打印 trace。    - `ONLY_SLOW_QUERY`：仅对 slow query 的查询进行打印。    - `SAMPLE_AND_SLOW_QUERY`：对 slow query 的查询进行打印，其他请求根据 `_print_sample_percentage` 的概率进行打印。 |

 上一篇 下一篇 ![有帮助](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) 咨询热线
