OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog Service
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

OceanBase Diagnostic Tool

V2.5.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
      • 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
  • 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
  • One-click Display information
    • 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 of a cluster
    • Information about execution plans of an SQL statement
  • Upgrade obdiag by using add-on files
  • Upgrade and uninstall obdiag
  • Telemetry Mode
  • FAQ
  • Release Notes
    • 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

Document Feedback
  1. Documentation Center
  2. OceanBase Diagnostic Tool
  3. V2.5.0

Basic information of a cluster

Last Updated:2026-09-04 08:22:11

Syntax
Examples
Method 1: Use obdiag out-of-the-box without a configuration file
Method 2: Use obdiag with a configuration file
Results

This topic describes how to use OceanBase Diagnostic Tool (obdiag) that is independently deployed to collect and display the basic information about a cluster in a terminal.

Syntax

obdiag display scene run --scene=observer.cluster_info [options]

The following table describes the options.

Option
Required?
Data type
Default value
Description
-c No string ~/.obdiag/config.yml The path of the configuration file.
--inner_config No string Empty The configurations of obdiag.
--config No string Empty The configurations of the cluster diagnosed by obdiag, in the format of --config key1=value1 --config key2=value2.

Examples

Method 1: Use obdiag out-of-the-box without a configuration file

Note

For more information about the parameters used in the command in this section, see Configure obdiag.

obdiag display scene run --scene=observer.cluster_info \
    --config db_host=xx.xx.xx.xx \
    --config db_port=xxxx \
    --config tenant_sys.user=root@sys \
    --config tenant_sys.password=***

Method 2: Use obdiag with a configuration file

Before you use obdiag, make sure that you have configured the login information of the target nodes in the config.yml configuration file of obdiag. For more information, see Configure obdiag.

obdiag display scene run --scene=observer.cluster_info

Results

After the command is executed, the execution result is displayed in the current terminal. Here is an example:

$ obdiag display scene run --scene=observer.cluster_info
...
+-----------------------+--------------------------+
|       stat_name       |          value           |
+-----------------------+--------------------------+
|      cluster_name     |        obcluster         |
|       cluster_id      |            1             |
|        version        |         4.2.2.0          |
|       observers       |            1             |
|         zones         |            1             |
|        tenants        |            3             |
|        rs_list        | xx.xx.xx.xx:2882:2881    |
|       config_url      |                          |
|      memory_limit     |          24.00G          |
|  data_disk_allocated  |          56.00G          |
|       cpu_total       |            16            |
|      cpu_assigned     |            12            |
|    cpu_assinged_per   |           75%            |
|      memory_total     |          20.00G          |
|    memory_assigned    |          19.00G          |
|  memory_assigned_per  |          95.00%          |
|     log_disk_total    |          84.00G          |
|   log_disk_assigned   |          8.00G           |
| log_disk_assigned_per |          10.00%          |
|    log_disk_in_use    |          6.50G           |
|  log_disk_in_use_per  |          81.00%          |
|    data_disk_total    |          56.00G          |
|    data_disk_in_use   |          23.69G          |
|  data_disk_in_use_per |          42.00%          |
+-----------------------+--------------------------+
Trace ID: f1b0206e-8878-11ef-a52e-00163e01c7ce

Previous topic

Overview
Last

Next topic

Information about nodes in a cluster
Next
on this page
Syntax
Examples
Method 1: Use obdiag out-of-the-box without a configuration file
Method 2: Use obdiag with a configuration file
Results