OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

A unified distributed database ready for your transactional, analytical, and AI workloads.

DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Diagnostic Tool

V3.3.0

  • Overview
  • Install obdiag
  • Configure obdiag
  • One-click Cluster Inspection
    • Use obdiag to inspect an OceanBase cluster
    • Inspection metrics
  • One-click Information Collection
    • One-click General Information Collection
      • obdiag gather log
      • obdiag gather sysstat
      • obdiag gather plan_monitor
      • obdiag gather stack
      • obdiag gather perf
      • obdiag gather ash
      • obdiag gather tabledump
      • obdiag gather parameter
      • obdiag gather variable
      • obdiag gather clog/obdiag gather slog
      • obdiag gather obproxy_log
      • obdiag gather all
    • One-click Scenario-based Information Collection
      • Overview
      • observer.base
      • observer.backup
      • observer.backup_clean
      • observer.clog_disk_full
      • observer.cluster_down
      • observer.compaction
      • observer.cpu_high
      • observer.delay_of_primary_and_backup
      • observer.io
      • observer.log_archive
      • observer.long_transaction
      • observer.memory
      • observer.perf_sql
      • observer.px_collect_log
      • observer.recovery
      • observer.restart
      • observer.rootservice_switch
      • observer.suspend_transaction
      • observer.unit_data_imbalance
      • observer.perf_sql
      • observer.topsql
      • other.application_error
      • obproxy.restart
      • observer.unknown
  • One-click Diagnostic Analysis
    • obdiag analyze log
    • obdiag analyze flt_trace
    • obdiag analyze parameter default
    • obdiag analyze parameter diff
    • obdiag analyze variable diff
    • obdiag analyze index_space
    • obdiag analyze memory
    • obdiag analyze queue
  • One-click Root Cause Analysis
    • Use obdiag for root cause analysis
    • disconnection
    • major_hold
    • lock_conflict
    • ddl_disk_full
    • clog_disk_full
    • log_error
    • ddl_failure
    • index_ddl_error
    • transaction_disconnection
    • transaction_execute_timeout
    • transaction_not_ending
    • transaction_other_error
    • transaction_rollback
    • transaction_wait_timeout
    • oms_full_trans
    • oms_obcdc
    • suspend_transaction
  • One-click Cluster Display
    • Overview
    • Basic information of a cluster
    • Information about nodes in a cluster
    • Information about units in a cluster
    • Information about zones in a cluster
    • RootService information of a cluster
    • Information about tenants in a cluster
    • Information about events in a cluster
    • Information about locks in a cluster
    • Information about top SQL statements in a cluster
    • Information about slow SQL statements in a cluster
    • Information about tables in a cluster
    • Information about the process list in a tenant
    • Information about the execution plan of an SQL statement
    • Disk usage of a database
    • Disk usage of the specified table in a database
    • Information about all tenants in a cluster
    • Information about CPU utilization of nodes in a cluster
    • Internal table names fuzzy matched with the specified keyword
    • Information about leaders in a cluster
    • Information about locks on a table
    • Information about long-running transactions in a cluster
    • Information about operators in the actually executed plan
    • Information about the memory of all tenants
    • Information about statistics on real-time sessions of the process list
    • Information about the storage method of tables and indexes
    • Information about column NDVs of a table
    • Information about table indexes
  • Upgrade obdiag by using add-on files
  • Upgrade and uninstall obdiag
  • Telemetry Mode
  • FAQ
  • Release Notes
    • obdiag V3.3.0
    • obdiag V3.2.0
    • obdiag V3.1.0
    • obdiag V3.0.0
    • obdiag V2.6.0
    • obdiag V2.5.0
    • obdiag V2.4.0
    • obdiag V2.3.0
    • obdiag V2.2.0
    • obdiag V2.1.0
    • obdiag V2.0.0
    • obdiag V1.6.2
    • obdiag V1.6.1
    • obdiag V1.6.0
    • obdiag V1.5.2
    • obdiag V1.5.1
    • obdiag V1.5.0
    • obdiag V1.4.0
    • obdiag V1.3.0

Download PDF

Overview Install obdiag Configure obdiag Use obdiag to inspect an OceanBase cluster Inspection metrics obdiag gather log obdiag gather sysstat obdiag gather plan_monitor obdiag gather stack obdiag gather perf obdiag gather ash obdiag gather tabledump obdiag gather parameter obdiag gather variable obdiag gather clog/obdiag gather slog obdiag gather obproxy_log obdiag gather all Overview observer.base observer.backup observer.backup_clean observer.clog_disk_full observer.cluster_down observer.compaction observer.cpu_high observer.delay_of_primary_and_backup observer.io observer.log_archive observer.long_transaction observer.memory observer.perf_sql observer.px_collect_log observer.recovery observer.restart observer.rootservice_switch observer.suspend_transaction observer.unit_data_imbalance observer.perf_sql observer.topsql other.application_error obproxy.restart observer.unknown obdiag analyze log obdiag analyze flt_trace obdiag analyze parameter default obdiag analyze parameter diff obdiag analyze variable diff obdiag analyze index_space obdiag analyze memory obdiag analyze queue Use obdiag for root cause analysis disconnection major_hold lock_conflict ddl_disk_full clog_disk_full log_error ddl_failure index_ddl_error transaction_disconnection transaction_execute_timeout transaction_not_ending transaction_other_error transaction_rollback transaction_wait_timeout oms_full_trans oms_obcdc suspend_transaction Overview Basic information of a cluster Information about nodes in a cluster Information about units in a cluster Information about zones in a cluster RootService information of a cluster Information about tenants in a cluster Information about events in a cluster Information about locks in a cluster Information about top SQL statements in a cluster Information about slow SQL statements in a cluster Information about tables in a cluster Information about the process list in a tenant Information about the execution plan of an SQL statement Disk usage of a database Disk usage of the specified table in a database Information about all tenants in a cluster Information about CPU utilization of nodes in a cluster Internal table names fuzzy matched with the specified keyword Information about leaders in a cluster Information about locks on a table Information about long-running transactions in a cluster Information about operators in the actually executed plan Information about the memory of all tenants Information about statistics on real-time sessions of the process list Information about the storage method of tables and indexes Information about column NDVs of a table Information about table indexes Upgrade obdiag by using add-on files Upgrade and uninstall obdiag Telemetry Mode FAQ
OceanBase logo

The Unified Distributed Database for the AI Era.

Follow Us
Products
OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
Resources
DocsBlogLive DemosTraining & Certification
Company
About OceanBaseTrust CenterLegalPartnerContact Us
Follow Us

© OceanBase 2026. All rights reserved

Cloud Service AgreementPrivacy PolicySecurity
Contact Us
Document Feedback
  1. Documentation Center
  2. OceanBase Diagnostic Tool
  3. V3.3.0
iconOceanBase Diagnostic Tool
V 3.3.0
  • V 3.3.0
  • V 3.2.0
  • V 3.1.0
  • V 3.0.0
  • V 2.6.0
  • V 2.5.0
  • V 2.4.0
  • V 2.3.0
  • V 1.5.0
  • V 1.4.0

Inspection metrics

Last Updated:2026-04-13 09:12:30  Updated
share
What is on this page
OceanBase Database
ODP

folded

share

This topic describes the inspection metrics of OceanBase Diagnostic Tool (obdiag).

OceanBase Database

Note

The issue numbers issue #xx mentioned in this topic are those in obdiag.

Type Task Inspection purpose
disk xfs_repair Checks whether the output of dmesg contains xfs_repair logs. For more information, see issue #451 in GitHub.
disk disk_full Checks whether the disk usage reaches the threshold.
disk clog_abnormal_file Checks whether the clog folder contains files that do not belong to the OceanBase cluster.
disk sstable_abnormal_file Checks whether the sstable folder contains files that do not belong to the OceanBase cluster.
disk disk_iops Checks the disk IOPS.
disk disk_hole Checks for disk holes.
system instruction_set_avx Checks for CPU flags.
system instruction_set_avx2 Checks for CPU flags.
system core_pattern_ctl Checks kernel.core_pattern.
system core_pattern Checks kernel.core_pattern.
system dependent_software Checks dependent software. For more information, see Host standardization check items.
system dependent_software_swapon Checks dependent software. For more information, see Host standardization check items.
system clock_source Checks whether the type of the clock source is tsc.
system ulimit_parameter Checks ulimit-related parameters. For more information, see Host standardization check items.
system parameter Checks kernel parameters. For more information, see Host standardization check items.
system parameter_ip_local_port_range Checks kernel parameters. For more information, see Host standardization check items.
system parameter_tcp_wmem Checks kernel parameters. For more information, see Host standardization check items.
system getenforce Checks SELinux by using the getenforce command. For more information, see Host standardization check items.
system parameter_tcp_rmem Checks kernel parameters. For more information, see Host standardization check items.
system aio Checks the asynchronous I/O (AIO). For more information, see Host standardization check items.
err_code find_err_4000 Checks whether the error code 4000 is returned when enable_sql_audit is set to True.
err_code find_err_4016 Checks whether the error code 4016 is returned when enable_sql_audit is set to True.
err_code find_err_4377 Checks whether the error code 4377 is returned when enable_sql_audit is set to True.
err_code find_err_4108 Checks whether the error code 4108 is returned when enable_sql_audit is set to True.
err_code find_err_4013 Checks whether the error code 4013 is returned when enable_sql_audit is set to True.
err_code find_err_4105 Checks whether the error code 4105 is returned when enable_sql_audit is set to True.
err_code find_err_4012 Checks whether the error code 4012 is returned when enable_sql_audit is set to True.
err_code find_err_4103 Checks whether the error code 4103 is returned when enable_sql_audit is set to True.
err_code find_err_4001 Checks whether the error code 4001 is returned when enable_sql_audit is set to True.
err_code find_err_4015 Checks whether the error code 4015 is returned when enable_sql_audit is set to True.
cpu oversold Checks whether CPU overprovisioning occurs on any OBServer nodes.
bugs bug_182 After OceanBase Database is upgraded to V4.2.1, the error code 4109 indicating that the server status or role is not as expected is returned when a DDL statement is executed on some partitioned tables. This inspection metric is used to check for such scenarios. For more information, see issue #182 in GitHub.
bugs bug_385 Checks for scenarios where a tenant has multiple root users when the version of OceanBase Database ranges from V4.2.1.0 to V4.2.1.3. In such scenarios, upgrade OceanBase Database to a later version or delete redundant users. For more information, see issue #385 in GitHub.
bugs bug_469 Checks whether the ldd version is earlier than 2.34. For more information, see issue #469 in GitHub.
column_storage tenant_parameters Checks the tenant parameters that need to be optimized in the proof of concept (POC) scenario for columnar storage.
cluster ls_nu Checks whether the number of log stream replicas in the cluster is normal.
cluster optimizer_better_inlist_costing_parmmeter Checks whether the tag parameter of a specific version is enabled.
cluster no_leader Checks for leaderless log streams of any tenants in the cluster.
cluster resource_limit_max_session_num Check whether the resourcelimit_max_sessionnum parameter has been modified. If so, the error Too many connections may be returned.
cluster deadlocks Checks for deadlocks.
cluster task_opt_stat Checks the optimizer statistics collection history.
cluster core_file_find Checks for core dump files.
cluster data_path_settings Checks whether the data directory (specified by data_dir) and log directory (specified by log_dir) are on the same disk.
cluster task_opt_stat_gather_fail Checks for failed historical collection tasks.
cluster part_trans_action_max Checks whether the number of transaction participants exceeds 200.
cluster zone_not_active Checks whether the log stream (LS) ID is not_enough_replica.
cluster table_history_too_many Checks for tables that have excessive historical records. If tables of a tenant in the cluster have excessive historical records, error code 4013 is returned during architecture refresh when the server restarts. As a result, the corresponding tenant architecture cannot be refreshed on the server.
cluster datafile_next Checks the node parameter datafile_maxsize. If the datafile_maxsize parameter is set to a value greater than that of datafile_size, check whether the value of datafile_next is 0. If so, the size of the data file will not grow. For more information, see issue #573 in GitHub.
cluster major Checks for suspended major compaction processes.
cluster mod_too_large Checks for modules that have used more than 10 GB of memory.
cluster tenant_number Checks the number of tenants.
cluster global_indexes_too_much Checks for tables that have more than 20 global indexes.
cluster sys_log_level Checks sys_log_level.
cluster observer_not_active Checks for OBServer nodes that are not in the ACTIVE state.
cluster ob_enable_plan_cache_bad_version Checks whether ob_enable_plan_cache is set to 0 to disable the plan cache in OceanBase Database V4.1.0.0 and V4.1.0.1 as recommended.
clog clog_disk_full Checks whether the clog disk is full.
sysbench sysbench_test_tenant_log_disk_size Checks the log_disk_size parameter of tenants.
sysbench sysbench_run_test_tenant_cpu_used Checks the CPU utilization of the cluster during a sysbench benchmark.
sysbench sysbench_test_cluster_datafile_size Checks the datafile_size and log_disk_size parameters of the cluster before a sysbench benchmark starts.
sysbench sysbench_test_tenant_cpu_parameters Checks the CPU parameters of tenants.
sysbench sysbench_test_cluster_log_disk_size Checks the log_disk_size parameter of the cluster.
sysbench sysbench_run_test_tenant_memory_used Checks the memory usage of tenants before a sysbench benchmark starts.
sysbench sysbench_test_tenant_primary_zone Checks the primary zone of the tenant during a sysbench benchmark.
sysbench sysbench_test_sql_net_thread_count Checks the sql_net_thread_count parameter of the cluster during a sysbench benchmark.
sysbench sysbench_free_test_memory_limit Checks the memory_limit parameter of the cluster before a sysbench benchmark starts.
sysbench sysbench_free_test_network_speed Checks the network speed of the cluster before a sysbench benchmark starts.
sysbench sysbench_free_test_cpu_count Checks the cpu_count parameter of the cluster before a sysbench benchmark starts.
sysbench sysbench_test_log_level Checks the syslog_level parameter of the cluster during a sysbench benchmark.
sysbench sysbench_test_cluster_parameters Checks the cluster parameters during a sysbench benchmark.
sysbench sysbench_test_cpu_quota_concurrency Checks the cpu_quota_concurrency parameter of the cluster during a sysbench benchmark.
network network_drop Checks the network packet loss information of the cluster.
network TCP-retransmission Checks the TCP retransmission information. For more information, see issue #348 in GitHub.
network network_offset Checks the network clock offset of the cluster.
network network_speed Checks the network speed of the cluster.
version old_version Checks the OceanBase Database version. Some OceanBase Database versions are not recommended.
version bad_version Checks the OceanBase Database version. Some OceanBase Database versions are not recommended.

ODP

Type Task Inspection purpose
version bad_version Checks whether an unrecommended OceanBase Database Proxy (ODP) version is used.
version old_version Checks whether an unrecommended ODP version is used.
parameter request_buffer_length Checks whether the default value of request_buffer_length is used.

Previous topic

Use obdiag to inspect an OceanBase cluster
Last

Next topic

obdiag gather log
Next
What is on this page
OceanBase Database
ODP