---
title: 如何配置 OBServer 捕获慢查询-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于 如何配置 OBServer 捕获慢查询相关的常见问题和使用技巧，帮助您快速解决 如何配置 OBServer 捕获慢查询的难题。
---
切换语言

- 简体中文
- English

划线反馈

# 如何配置 OBServer 捕获慢查询

更新时间：2026-05-14 09:21

适用版本： V2.1.x、V2.2.x、V3.1.x、V3.2.x 内容类型：How-to  

集群参数 `trace_log_slow_query_watermark` 来控制慢 SQL 的阀值，执行时间超过该阀值的 SQL 被认为是慢查询，慢查询的追踪日志会被打印到 OBServer 日志中。我们可以调整 `trace_log_slow_query_watermark` 的阀值，来捕捉需要跟踪的 SQL 执行。

## 适用版本

OceanBase 数据库 V4.0 以前的所有版本。

## 操作步骤

`trace_log_slow_query_watermark` 参数的默认值为 100 ms，表示执行时间超过 100 ms 的查询会被认为是慢 SQL，并记录在 `observer.log` 日志中。该参数值需要根据业务 SQL 的性能指标来设置，参数设置过大会丢失对慢查询的追踪日志，参数设置过小可能会产生过多的日志量，对整个集群性能带来一定的影响。

1. 使用 ALTER SYSTEM 命令设置慢查询日志参数。

   ```
   obclient> ALTER SYSTEM SET trace_log_slow_query_watermark='1s';

   ```
 2. 在 `observer.log` 日志中查看慢查询日志，搜索关键字 `[slow query]`。

   ```
   [root@hostname /]# cd /home/admin/oceanbase/log
   [root@hostname log]# fgrep "slow query" observer.log| sed "s/|\[/\n\]/g"

   ```

   慢查询日志示例：

   ![slow query](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/sql/imgAX99P6E3Ia%20%281%29.png)

      - `[optimize_end]`：每个方框号（[]）中的文字表示 SQL 执行经过的每一个内部模块。
      - `trace_id`：语句的 `trace_id`，您可以通过该 ID 从日志中搜索语句的执行信息。与 `gv$sql_audit` 里的 `trace_id` 字段对应。
      - `stmt`：执行的 SQL 语句。
      - `u`：代表每一步消耗的时间，单位是微秒。
      - `total_timeu`：是指整个过程消耗的总时间，这里是 31ms。

Previous

[OBProxy 查询二级分区路由不准确](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000043626)

Next

[SPF 算子 Batch Rescan 没有 reset 内存导致的 core](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000002396553) ![有帮助](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) 咨询热线