v4.0.0

obdiag V4.0.0

版本信息

• 发布时间：2025 年 12 月
• 版本号：V4.0.0

新版本变更功能点

新增命令

• 【新增】obdiag tool ai_assistant 命令，AI 智能诊断助手（BETA 版本），支持通过自然语言进行诊断交互。需要配置 OpenAI API Key 或兼容接口。

• 【新增】obdiag tool io_performance 命令，磁盘 IO 性能检测工具，支持检测 clog 盘和 data 盘的 IO 性能。

• 【新增】obdiag tool config_check 命令，配置校验工具，支持检查 DB 连接和 SSH 连接状态，可定位具体失败节点。

• 【新增】obdiag display scene run --scene=observer.compaction 命令，合并状态展示场景，支持展示合并状态、进度、诊断信息和建议。

新增 RCA 场景

• 【新增】obdiag rca run --scene=gc_troubleshooting 命令，GC 问题排查场景（仅支持 OceanBase 4.x）。

• 【新增】obdiag rca run --scene=schema_leak 命令，Schema 泄漏排查场景（仅支持 OceanBase 4.x）。

• 【新增】obdiag rca run --scene=split_schedule_error 命令，分区分裂调度错误排查场景。

• 【新增】obdiag rca run --scene=weak_read_troubleshooting 命令，弱读问题排查场景（仅支持 OceanBase 4.x）。

功能增强

• 【新增】obdiag gather log 和 obdiag gather obproxy_log 命令新增 --recent_count 参数，支持仅收集最近指定数量的日志文件。

• 【新增】obdiag gather ash 命令新增 --svr_ip、--svr_port、--tenant_id 参数，支持按指定条件过滤采样数据（仅支持 OceanBase 4.3.5.0 及以上版本）。

• 【新增】obdiag analyze index_space 命令新增 --database 参数，支持指定数据库进行索引空间分析。

• 【新增】obdiag check run 命令新增 deep 巡检包，用于深度巡检（可能影响系统性能，生产环境慎用）。

• 【新增】obdiag check run 命令新增 archive.archive_continuous_error 巡检项，检查归档连续错误。

• 【优化】obdiag rca run --scene=suspend_transaction 场景支持按 tx_id 分析特定事务。

• 【优化】obdiag rca run --scene=lock_conflict 场景新增日志分析能力。

• 【优化】obdiag rca run --scene=major_hold 场景增加重复索引名检测和 DDL 任务状态检查。

• 【优化】事务相关 RCA 场景（transaction_not_ending、transaction_disconnection、transaction_execute_timeout、transaction_wait_timeout、transaction_rollback、transaction_other_error）诊断能力增强。

• 【变更】obdiag gather plan_monitor、obdiag gather scene run、obdiag gather dbms_xplan 命令 --env 参数改为支持多次指定 key=value 格式，例如：--env host=127.0.0.1 --env port=2881 --env user=test@test --env password=****** --env database=test。

• 【变更】obdiag gather log 命令底层日志搜索算法升级至 v2 版本。

依赖变更

• 【变更】新增依赖：openai>=1.0.0、rich>=13.0.0。

• 【变更】移除依赖：bcrypt、constant、protobuf、pick、subprocess32、netifaces、zstandard、pycryptodome。

注意

1. AI 智能诊断助手功能为 BETA 版本，需要配置 OpenAI API Key 或兼容接口。

2. ASH 报告新参数（svr_ip、svr_port、tenant_id）仅支持 OceanBase 4.3.5.0 及以上版本。

3. 新增的 RCA 场景（gc_troubleshooting、schema_leak、weak_read_troubleshooting）仅支持 OceanBase 4.x。

4. deep 巡检包包含可能影响系统性能的检查任务，生产环境慎用。

注意

obd 适配 obdiag V3.7.2 版本需要 V3.5.0 及以上版本。

Full Changelog: v3.7.2...v4.0.0

v3.7.2

obdiag V3.7.2

版本信息

• 发布时间：2025 年 11 月 27 日
• 版本号：V3.7.2

新版本变更功能点

• 【新增】obdiag check run 命令新增 5 个巡检项。

注意

obd 适配 obdiag V3.7.2 版本需要 V3.5.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi 对本次迭代做出的贡献

v3.7.1

obdiag V3.7.1

版本信息

• 发布时间：2025 年 10 月 22 日
• 版本号：V3.7.1

新版本变更功能点

• 【新增】obdiag check run 命令新增 1 个巡检项。

• 【新增】obdiag check run --observer_tasks="xxx,xxxx" 支持更细粒度的巡检项组合。

• 【修复】obdiag gather plan_monitor 报告中 SQL 文本复制粘贴后格式错乱问题。

注意

obd 适配 obdiag V3.7.1 版本需要 V3.5.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi 对本次迭代做出的贡献

v3.7.0

obdiag V3.7.0

版本信息

• 发布时间：2025 年 09 月 09 日
• 版本号：V3.7.0

新版本变更功能点

• 【新增】obdiag-mcp server 发布 wheel 包（ 支持 pip install obdiag-mcp 直接安装），具体使用文档参见 obdiag_mcp_server。

• 【新增】obdiag check run 新增 2 个巡检项。

• 【新增】obdiag gather plan_minitor 支持收集 PS SQL 的 plan_minitor 报告。

• 【修复】obdiag analyze queue --config 参数缺失的问题。

• 【修复】修复若干根因分析场景的小问题。

注意

obd 适配 obdiag V3.7.0 版本需要 V3.5.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi @xiaodong-ji @suyestyle 对本次迭代做出的贡献

Full Changelog: v3.6.0...v3.7.0

v3.6.0

obdiag V3.6.0

版本信息

• 发布时间：2025 年 07 月 31 日
• 版本号：V3.6.0

新版本变更功能点

• 【新增】obdiag 的 MCP 服务可供大模型调用，具体使用文档参见 obdiag_mcp_server。

• 【新增】新增 obdiag gather core 命令支持 core 文件一键收集功能，具体介绍可参见 Core 文件收集。

• 【新增】obdiag gather scene run 命令新增 obproxy.obproxy_parameter 场景，用于一键收集 ODP 的参数。

• 【新增】obdiag 新增 Docker 镜像 quay.io/oceanbase/obdiag:latest。

• 【新增】obdiag 输出结果支持 markdown 样式。

• 【新增】新增 obdiag tool 一级命令用于集成其他工具，并新增 obdiag tool crypto_config 命令支持将 obdiag 配置文件加密，具体介绍可参见 配置文件加密。

• 【新增】obdiag rca run 命令新增 OceanBase 集群回放卡的根因分析场景。

• 【新增】obdiag rca run 命令新增 OceanBase 集群内存爆的根因分析场景。

• 【新增】obdiag rca run 命令新增 OBServer 节点删除异常的根因分析场景。

• 【新增】obdiag check run 新增 8 个巡检项。

注意

obd 适配 obdiag V3.6.0 版本需要 V3.2.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi @xiaodong-ji 对本次迭代做出的贡献

v3.5.0

obdiag V3.5.0

版本信息

• 发布时间：2025 年 06 月 20 日
• 版本号：V3.5.0

新版本变更功能点

• 【新增】新增 10 个巡检项：集群网卡速度不一致、Local IP 不正确、MemStore 使用率过高、集群无主、会话过多、租户存在锁冲突、数据盘满、租户存在空洞、日志流副本数不足、引用计数泄漏。

• 【新增】obdiag rca run 命令新增 Unit GC 异常的根因分析场景。

• 【新增】obdiag gather scene run --scene=observer.cpu_high 命令新增 processlist 的信息采集。

• 【修复】修复 obdiag gather dbms_xplan 命令中 DBMS_XPLAN.DISPLAY_CURSOR 不准确的问题。

• 【修复】日志收集获取文本时间异常的问题。

• 【修复】修复 obdiag gather plan_minitor 命令生成的报告文件过大问题，并为该命令增加统计信息过期校验逻辑。

• 【变更】（开发者侧）开发环境升级 python >= 3.11。

注意

obd 适配 obdiag V3.5.0 版本需要 V3.2.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi @duzp111 @CES-dengzeyuan 对本迭代所做出的贡献

v3.4.0

obdiag V3.4.0

版本信息

• 发布时间：2025 年 05 月 15 日
• 版本号：V3.4.0

新版本变更功能点

• 【新增】obdiag V3.4.0 新增 17 个巡检项。

• 【新增】obdiag V3.4.0 新增 obdiag gather dbms_xplan 支持使用 DBMS_XPLAN 系统包收集 SQL 的性能诊断信息。

• 【新增】（开发者侧）obdiag V3.4.0 新增 github workflow 用于支持 obdiag 功能的自动化回归。

注意

obd 适配 obdiag V3.4.0 版本需要 V3.2.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi @xiaodong-ji @jingyd66 @zhangry7777 对本迭代所做出的贡献

v3.3.0

obdiag V3.3.0

版本信息

• 发布时间：2025 年 04 月 18 日
• 版本号：V3.3.0

新版本变更功能点

• 【新增】巡检支持 python 脚本插件，用于支持复杂场景的巡检。

• 【新增】新增 24 个巡检项。

• 【新增】新增悬挂事物场景的故障根因分析 obdiag rca run --scene=suspend_transaction.

• 【修复】obdiag gather plan_minitor 增加统计信息结果分析能力。

• 【新增】obdiag rca run --scene=oms_obcdc --env component_id=xxxxxx，支持 OMS obcdc 组件分析场景(beta)。

注意

obd 适配 obdiag V3.3.0 版本需要 V3.2.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi @xiaodong-ji @jingyd66 对本迭代所做出的贡献

v3.2.0

obdiag V3.2.0

版本信息

• 发布时间：2025 年 03 月 14 日
• 版本号：V3.2.0

新版本变更功能点

• 【新增】obdiag 适配 ipv6。

• 【修复】obdiag 在 debian 11 及以上系统安装部署的兼容性问题。

• 【新增】obdiag gather stack 支持 arm 机器的收集。

• 【新增】obdiag check 新增 5 个巡检场景，包括日志流副本数检查、zone 状态检查、主机时钟检查、OB 日志保留个数检查、网络丢包检查

• 【新增】obdiag check 支持 obproxy 参数巡检

• 【修复】obdiag gather plan_minitor 在 SQL 语句跨库时获取不到表 schema 的 bug。

注意

obd 适配 obdiag V3.2.0 版本需要 V3.2.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi 对本迭代所做出的贡献

v3.1.0

obdiag V3.1.0

版本信息

• 发布时间：2025 年 01 月 22 日
• 版本号：V3.1.0

新版本变更功能点

• 【新增】新增 12 个 obdiag display (一键洞察) 场景。

• 【新增】新增 4 个 巡检项。

• 【优化】obdiag analyze log 补充 OB CRASH 日志的分析。

链接

官网文档
下载链接

注意

obd 适配 obdiag V3.1.0 版本需要 V3.1.0 及以上版本。

特别鸣谢：@wayyoungboy @Teingi @zhangry7777 @duzp111 对本迭代所做出的贡献