Skip to content

Latest commit

 

History

History
105 lines (81 loc) · 5.39 KB

README.md

File metadata and controls

105 lines (81 loc) · 5.39 KB
Raw

English | 中文版

license license pyversions stars forks Chinese doc

OceanBase Diagnostic Tool (obdiag)

Overview

OceanBase Diagnostic Tool (obdiag) is a quick diagnostic tool for open-source OceanBase software. The features include gather\analyze\check OceanBase Diagnostic information. It can be executed with one click in different deployment modes of OceanBase clusters (OCP, OBD, or manually deployed by users according to documentation).

Project Value & Vision

Project Value

Install obdiag

You can install obdiag by using these methods:

Method 1: Install obdiag by using RPM packages

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo
sudo yum install -y oceanbase-diagnostic-tool
sh /usr/local/oceanbase-diagnostic-tool/init.sh

Method 2: Install obdiag by using the source code

To install obdiag on Python >= 3.8, run these commands:

pip3 install -r requirements3.txt
sh dev_init.sh
source ~/.bashrc

obdiag config

The path of the configuration file for the diagnosed cluster is stored in ~/.obdiag/config.yml .You can directly edit the configuration file or generate the configuration file through the obdiag config <option> command

obdiag config -h <db_host> -u <sys_user> [-p password] [-P port]

obdiag Fuctions

  • One-click cluster inspection
  • One-click diagnostic analyze
  • One-click root cause analysis
  • One-click information collection

For more details, please refer to Official docs

Join the Contributing Community

obdiag envisions an open community. We welcome your contributions in any form:

Roadmap Ahead

Version Iteration Period Release Date Function
1.6.0 2024.01 2024.01.31
  • Scenario based fault information collection
  • Scenario based root cause analysis
2.0.0 2024.03 2024.04.11
  • Context Transformation, Enhanced Scene Expansion Capabilities
  • Support online updating of inspection and gather tasks
  • Root Cause Analysis Phase II Transformation
2.1.0 2024.04 2024.05.13
  • Root Cause Analysis Scenario Expansion
  • Gather ash report
2.2.0 2024.05 2024.06.14
  • Root Cause Analysis Scenario Expansion
  • Check Scenario Expansion
2.3.0 2024.06 -
  • Root Cause Analysis Scenario Expansion
  • Support SQL Diagnosis
2.4.0 2024.07 -
  • Root Cause Analysis Scenario Expansion
  • Adapting Two Additional Kernel Diagnostic Tools
2.5.0 2024.08 -
  • Root Cause Analysis Scenario Expansion
  • Support OMS Diagnosis
3.0.0 2024.09 -
  • Root Cause Analysis Scenario Expansion
  • Service-ification Transformation
3.1.0 2024.10 -
  • Root Cause Analysis Scenario Expansion
  • Supporting Comparative Functionality for Patrol Inspection Reports
3.2.0 2024.11 -
  • Root Cause Analysis Scenario Expansion
  • SQL Diagnosis Phase II, Supporting Root Cause Analysis for SQL problems
3.3.0 2024.12 -
  • AI for obdiag

Licencing

OceanBase Database is under MulanPubL - 2.0 license. You can freely copy and use the source code. When you modify or distribute the source code, please obey the MulanPubL - 2.0 license.

Support

In case you have any problems when using obdiag, welcome reach out for help:

Join us

Please add the OB community assistant (WeChat ID: obce666) and note "obdiag SIG", and the staff will contact you and guide you on matters related to joining SIG. We look forward to your active participation and valuable contributions!