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