obdiag V4.0.0

Version information

• Published: January 7, 2026
• Version number: V4.0.0

New version changes function points

Add new command

• [New] Added obdiag tool ai_assistant command, which is used to start the AI intelligent diagnosis assistant and supports diagnostic interaction through natural language. For detailed introduction, please refer to AI Intelligent Diagnosis Assistant.

  Attention

  The AI intelligent diagnostic assistant function is a BETA version, and the use of the command requires configuring an OpenAI API Key or a compatible interface.

• [New] Added obdiag tool io_performance command, which is used to detect disk IO performance and supports detecting the IO performance of clog disk and data disk. For detailed introduction, please refer to Disk IO Performance Test.

• [New] Added obdiag tool config_check command, which is used to verify the connection status of the cluster configured in the configuration file. It supports checking the DB connection and SSH connection status, and can locate specific failed nodes. For detailed introduction, please refer to Configuration Verification Tool.

• [New] obdiag display scene run command adds a new merge status display scene, which supports display of merge status, progress, diagnostic information and suggestions. For detailed introduction, please see Merge Status Display.

  Description

  This scenario only supports OceanBase database V4.0.0.0 and above.

Added RCA scene

• [New] The obdiag rca run command adds a root cause analysis scenario for GC problems. For detailed introduction, please refer to Root cause analysis scenario: GC problem troubleshooting gc_troubleshooting.

  Description

  This scenario currently only supports OceanBase database V4.0.0.0 and above.

• [New] The obdiag rca run command adds a root cause analysis scenario for Schema leak problems. For detailed introduction, see Root cause analysis scenario: Schema leak schema_leak.

  Description

  This scenario currently only supports OceanBase database V4.0.0.0 and above.

• [New] The obdiag rca run command adds a new root cause analysis scenario for partition split scheduling errors. For detailed introduction, see Root cause analysis scenario: partition split scheduling error split_schedule_error.

• [New] The obdiag rca run command adds a root cause analysis scenario for weak read problems. For detailed introduction, please refer to Root cause analysis scenario: weak_read_troubleshooting.

  Description

  This scenario currently only supports OceanBase database V4.0.0.0 and above.

Function enhancement

• [New] The --recent_count option is added to the obdiag gather log and obdiag gather obproxy_log commands to support collecting only the most recently specified number of log files.

• [New] obdiag gather ash command adds --svr_ip, --svr_port, --tenant_id options to support filtering sampling data according to specified conditions. For detailed introduction, please refer to ASH report collection.

  Description

  The new options currently only support OceanBase database V4.3.5.0 and above.

• [New] The obdiag gather dbms_xplan command adds the --env option. For details, see DBMS_XPLAN Information Collection.

• [New] The obdiag analyze index_space command adds the --database option to support specifying a database for index space analysis.

• [New] obdiag check run command adds deep inspection package for in-depth inspection.

  Attention

  The deep inspection package contains inspection tasks that may affect system performance and should be used with caution in production environments.

• [New] obdiag check run command adds archive.archive_continuous_error inspection item to check for archive continuous errors.

• [Optimization] The suspended transaction (obdiag rca run --scene=suspend_transaction) scenario supports analyzing specific transactions by tenant name (tenant_name) and transaction ID (tx_id).

• [Optimization] Added log analysis capability in lock conflict (obdiag rca run --scene=lock_conflict) scenario.

• [Optimization] Add duplicate index name detection and DDL task status check in card merging (obdiag rca run --scene=major_hold) scenario.

• [Optimization] The diagnostic capabilities of transaction-related RCA scenarios (transaction_not_ending, transaction_disconnection, transaction_execute_timeout, transaction_wait_timeout, transaction_rollback, transaction_other_error) are enhanced.

• [Change] The --env option of the obdiag gather plan_monitor and obdiag gather scene run commands is changed to support specifying the key=value format multiple times, for example: --env host=127.0.0.1 --env port=2881 --env user=test@test --env password=****** --env database=test.

• [Change] The underlying log search algorithm of the obdiag gather log command is upgraded to version v2.

Dependency changes

• [Change] New dependencies: openai>=1.0.0, rich>=13.0.0.

• [Change] Remove dependencies: bcrypt, constant, protobuf, pick, subprocess32, netifaces, zstandard, pycryptodome.