---
title: "概述 - 云平台 OCP V4.3.5 | OceanBase 文档中心"
description: 概述 当诊断采集数据量过大时，会导致 Agent 内存超限并不断重启，此时只能通过黑屏修改配置文件参数并重新推送的方式进行解决。但这种非标准的操作方式可能会引来一些问题，比如配置不兼容导致 Agent 升级失败，或者配置被重置等。 因此，OCP 提供了白屏的参数配置管理方式，您可参考本节内容，在 运维配置 页面查看 …
---
切换语言

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

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

# 概述

更新时间：2026-04-14 15:11:03

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.5/zh-CN/600.cluster-functions/300.manage-a-cluster/1200.manage-om-configuration/100.om-configuration-overview.md)  

当诊断采集数据量过大时，会导致 Agent 内存超限并不断重启，此时只能通过黑屏修改配置文件参数并重新推送的方式进行解决。但这种非标准的操作方式可能会引来一些问题，比如配置不兼容导致 Agent 升级失败，或者配置被重置等。

因此，OCP 提供了白屏的参数配置管理方式，您可参考本节内容，在 **运维配置** 页面查看 OCP 相关的采集和运维参数，并对其进行统一管理。

## 参数列表说明

OCP 支持的采集和运维参数共分为四类，包括：**SQL 诊断采集**、**事务诊断采集**、**活跃会话历史采集** 和 **性能监控参数**，分别对应 OCP 的 SQL 诊断功能、事务诊断功能、活跃会话历史功能和性能监控功能。

### SQL 诊断采集

**SQL 诊断采集** 主要为租户和自治服务内的 SQL 诊断模块提供基础数据。

| 参数名 | 参数类型 | 默认值 | 取值范围 | 参数说明 |
| --- | --- | --- | --- | --- |
| monagent.pipeline.sql.audit.status | String | active | - | sql_audit 诊断采集开关，可选值为 active/inactive。 |
| monagent.limit.memory.fuse.percent | Double | 0.8 | [0.1, 1.0] | 诊断采集内存熔断的阈值，计算方法是为 ocp_monagent 进程当前内存 / ocp_monagent 进程内存限额。超过阈值将不再采集诊断数据，当采集压力大时可适当提高阈值。 |
| monagent.ob.sql.audit.collect.batch.size | Int | 4000 | [500, 20000] | sql_audit 单次查询内部视图的数量，采集压力大时提高该值可提升效率。 |
| monagent.ob.slow.sql.threshold | String | 100ms | - | 慢 SQL 的上报阈值，超过该阈值的 SQL 会被当做慢 SQL 上报 MonitorDB，慢 SQL 过多时可调整阈值减少上报数量。 |
| monagent.ob.sql.transaction.timeus.threshold | Int | 500000 | [10000, 300000000] | 大事务的时间阈值，单位为 us，低于该阈值的事务 SQL 不会上报。大事务过多时可调整阈值减少上报数量。 |
| monagent.ob.sql.transaction.log.size.byte | Int | 524288 | [1024, 1073741824] | 大事务的日志大小阈值，单位为 Byte，低于该阈值的事务 SQL 不会上报。大事务过多时可调整阈值减少上报数量。 |
| monagent.pipeline.plan.monitor.status | String | active | - | 并行 SQL 采集开关，可选值为 active/inactive。 |
| monagent.pipeline.slow.sql.status | String | active | - | 慢 SQL 采集开关，可选值为 active/inactive。 |
| monagent.ob.sql.diagnose.collect.query.timeout | String | 10s | - | 诊断采集查询 SQL 的超时时间，包括 sql_audit、sql_plan、sql_plan_monitor 的查询 SQL。 |
| monagent.pipeline.sql.plan.status | String | active | - | 执行计划采集开关，可选值为 active/inactive。 |
| monagent.ob.sql.plan.collect.batch.size | Int | 4000 | [500, 20000] | 执行计划采集单次查询内部视图的数量，采集压力大时提高该值可提升效率。 |
| monagent.ob.sql.plan.monitor.collect.batch.size | Int | 4000 | [500, 20000] | 并行 SQL 采集单次查询内部视图的数量，采集压力大时提高该值可提升效率。 |
| monagent.pipeline.monitor.user.collect | Bool | false | - | 是否采集 agent 自身用户查询 sys 租户的 SQL 信息。默认关闭，可在排查问题时打开。 |
| monagent.pipeline.empty.query.sql.collect | Bool | false | - | 是否采集 query_sql 为空的 sql_audit 记录。默认关闭，可在排查问题时打开。 |

### 事务诊断采集

**事务诊断采集** 主要为租户和自治服务内的事务诊断模块提供基础数据。

| 参数名 | 参数类型 | 默认值 | 取值范围 | 参数说明 |
| --- | --- | --- | --- | --- |
| monagent.pipeline.transaction.status | String | active | - | 事务采集开关，可选值为 active/inactive。 |
| monagent.ob.sql.transaction.collect.batch.size | Int | 4000 | [500, 20000] | 事务采集单次查询内部视图的数量。采集压力大时提高该值可提升效率。 |
| monagent.ob.sql.transaction.collect.join.global.transaction | Bool | true | - | 事务信息采集时，是否 JOIN 全局事务表，可用于采集 XA 事务等信息。 |
| monagent.ob.sql.transaction.collect.query.timeout | String | 5s | - | 事务采集查询 SQL 超时时间。 |

### 活跃会话历史采集

**活跃会话历史采集** 主要为租户和自治服务内的会话管理模块提供基础数据。

| 参数名 | 参数类型 | 默认值 | 取值范围 | 参数说明 |
| --- | --- | --- | --- | --- |
| monagent.pipeline.session.status | String | active | - | 活跃会话采集开关，可选值为 active/inactive。 |
| monagent.ob.session.event.collect.batch.size | Int | 4000 | [500, 20000] | 活跃会话采集单次查询内部视图的数量，采集压力大时提高该值可提升效率。 |
| monagent.ob.session.event.collect.query.timeout | String | 10s | - | 活跃会话采集查询 SQL 超时时间。 |

### 性能监控

| 参数名 | 参数类型 | 默认值 | 取值范围 | 参数说明 |
| --- | --- | --- | --- | --- |
| monagent.pipeline.ob.status | String | active | - | 性能监控采集开关，可选值为 active/inactive。 |
| monagent.pipeline.tenant.disk.collect.disabled | Bool | false | - | 是否采集租户及以下维度磁盘数据，出现 SQL 性能问题时建议关闭。 |
| monagent.collector.ob.extra.interval | String | 60s | - | 性能监控分钟级监控采集频率。 |
| monagent.second.metric.cache.update.interval | String | 5s | - | 性能监控秒级监控采集频率。 |

## 参数管理操作

您在 **运维配置** 页面可对集群进行如下基础管理操作：

- [管理参数](https://www.oceanbase.com/docs/common-ocp-1000000002381299)：支持对运维配置参数进行开启/关闭、修改参数值、搜索、查看已修改参数。
 - [查看参数修改历史](https://www.oceanbase.com/docs/common-ocp-1000000002381298)：查看当前集群发起的所有运维配置参数的历史修改记录。
 - [配置 OCP Agent 资源](https://www.oceanbase.com/docs/common-ocp-1000000002381296)：为集群下的所有 OCP Agent 统一进行资源配置。

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