• OceanBase 全组件日志参数标准化配置 SOP
• 变更目标：
• 一、变更概述
• 二、OCP 平台自身日志参数配置
  • 2.1 配置路径
  • 2.2 参数配置清单
  • 2.3 配置步骤
• 三、OCP Agent 日志清理策略配置
  • 3.1 配置路径
  • 3.2 配置说明
  • 3.3 配置步骤
  • 3.4 清理逻辑说明
• 四、OBServer内核日志参数配置
  • 4.1 配置路径
  • 4.2 参数配置清单
  • 4.3 配置步骤
• 五、OBProxy（ODP）日志参数配置
  • 5.1 配置路径
  • 5.2 参数配置清单
  • 5.3 配置步骤
• 六、变更验证步骤
  • 6.1 验证 OCP 日志配置
  • 6.2 验证 OCP Agent 日志清理
  • 6.3 验证 OBServer 内核日志
  • 6.4 验证 OBProxy 日志
• 七、回滚方案
• 八、变更注意事项

OceanBase 全组件日志参数标准化配置 SOP

在 OceanBase 集群日常运维中，日志无限膨胀、磁盘占用过高、冗余日志过多、IO 压力大等问题，常常影响集群稳定运行。为统一生产环境运维标准，规范OCP、OCP Agent、OBServer、OBProxy四大组件日志策略，现发布《OceanBase 全组件日志参数标准化配置 SOP V1.0》，一键优化日志滚动、清理、级别规则，筑牢集群运维根基。

文档版本：V1.0

生效日期：2026-05-08

适用范围：OceanBase 集群OCP、OCP Agent、OBServer、OBProxy 日志参数优化

变更目标：

1. 优化 OCP 自身日志滚动与清理策略，防止日志文件无限制增长；

2. 配置 OCP Agent 日志清理规则，自动清理 OBServer 日志，防止磁盘占用过高；

3. 调整 OBServer（metadb）内核日志级别与数量，减少冗余日志；

4. 优化 OBProxy 日志级别与清理策略，控制代理层日志量。

一、变更概述

本次变更为生产环境日志策略标准化配置，通过对 OCP、OCP Agent、OBServer、OBProxy 四个组件的日志参数进行统一优化，实现以下目标：

• 避免日志文件无限制增长，导致磁盘空间耗尽；
• 降低非关键日志级别，减少磁盘 IO 与空间占用；
• 建立双重日志清理机制（内核参数 + OCP Agent），形成冗余保障；
• 统一生产环境日志保留策略，便于问题排查与运维管理。

二、OCP 平台自身日志参数配置

2.1 配置路径

OCP 控制台 → 系统管理 → 系统参数

2.2 参数配置清单

2.3 配置步骤

1.登录 OCP 控制台，进入【系统管理】→【系统参数】；

2.在搜索框输入 logging.，筛选出所有日志相关参数；

3.点击对应参数右侧的【编辑】，修改为推荐值；

4.点击【提交】保存修改；

5.执行重启 OCP 命令生效：

bash
docker restart ocp

三、OCP Agent 日志清理策略配置

3.1 配置路径

OCP 控制台 → 系统管理 → 系统参数 →ocp.agent.ob.log-cleaner.config

3.2 配置说明

OCP Agent 会按磁盘使用率、保留天数、文件数量，自动清理 OBServer /home/admin/oceanbase/log 目录下的日志，防止磁盘占满。

3.3 配置步骤

1.在系统参数列表中找到ocp.agent.ob.log-cleaner.config，点击【编辑】；

2.将原有 JSON 配置替换为以下标准内容：

json
{
  "disk_threshold": 80,
  "file_reg": ".*",
  "retention_days": 1,
  "keep_percentage": 50
}

3.点击【提交】保存修改；

4.登录每台 OBServer 主机，重启 OCP Agent 服务：

bash
# 重启 Agent 服务
systemctl restart ocp_agent
# 确认服务状态
systemctl status ocp_agent

3.4 清理逻辑说明

1.当 OBServer 日志目录磁盘使用率超过 80% 时，触发清理；

2.优先删除 1 天前的所有日志文件；

3.若清理后磁盘使用率仍高于 80%，则保留最近 50% 数量的日志文件，其余删除。

四、OBServer内核日志参数配置

4.1 配置路径

OCP 控制台 → 集群管理 → 目标集群 → 参数管理 → 搜索 syslog

4.2 参数配置清单

4.3 配置步骤

1.登录 OCP 控制台，进入目标集群的【参数管理】；

2.搜索框输入 syslog，筛选出所有内核日志参数；

3.点击对应参数右侧的【修改值】，调整为推荐值；

4.点击【提交】保存修改，参数在线立即生效，无需重启 OBServer。

五、OBProxy（ODP）日志参数配置

5.1 配置路径

OCP 控制台 → 目标集群 → OBProxy → 参数管理 → 搜索 log

5.2 参数配置清单

5.3 配置步骤

1.进入目标集群的 OBProxy【参数管理】，搜索框输入 log；

2.点击对应参数右侧的【修改值】，调整为推荐值；

3.点击【提交】保存修改，参数在线立即生效。

六、变更验证步骤

6.1 验证 OCP 日志配置

1.登录 OCP 服务器，查看 OCP 日志目录（默认：/home/admin/ocp-server/log）；

2.检查日志文件滚动情况，确认单个文件大小、保留天数符合配置；

3.执行 docker logs ocp，无报错输出。

6.2 验证 OCP Agent 日志清理

1.登录任意一台 OBServer 主机，查看 Agent 配置文件：

bash
cat /home/admin/ocp_agent/conf/module_config/ob_logcleaner_module.yaml

确认ob.logcleaner.ob_log.disk.threshold=80、ob.logcleaner.ob_log.rule0.keep.percentage=50已更新；

2.观察 OBServer 日志目录（/home/admin/oceanbase/log）磁盘使用率，确认无持续增长。

6.3 验证 OBServer 内核日志

1.登录 sys 租户，执行 SQL 命令确认参数已生效：

sql
SHOW PARAMETERS LIKE 'syslog%';
SHOW PARAMETERS LIKE 'enable_syslog_recycle';
SHOW PARAMETERS LIKE 'max_syslog_file_count';

2.查看日志目录文件数量，确认未超过max_syslog_file_count设置值。

6.4 验证 OBProxy 日志

1.登录 OBProxy 服务器，查看日志目录文件大小与数量，符合配置；

2.检查代理日志无大量冗余日志输出。

七、回滚方案

若变更后出现异常，按以下步骤回滚：

1. OCP 日志参数：在系统参数中恢复原值，执行 docker restart ocp；

2. OCP Agent 配置：恢复 ocp.agent.ob.log-cleaner.config 为原始 JSON，重启 Agent；

3. OBServer 内核参数：通过 SQL 命令恢复为原参数值，在线生效；

4. OBProxy 参数：在参数管理中恢复原值，在线生效。

八、变更注意事项

1. OCP 日志参数修改后需要重启生效，必须执行 docker restart ocp 才能生效；

2. OCP Agent 配置修改后，需重启所有 OBServer 节点上的 Agent 服务；

3. OBServer 和 OBProxy 日志参数修改为在线生效，无需重启服务；

4. 建议变更完成后持续观察 24 小时，确认磁盘使用率无异常增长。