English | 中文版
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).
You can install obdiag by using these methods:
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
To install obdiag on Python >= 3.8, run these commands:
pip3 install -r requirements3.txt
./dev_init.sh
source ~/.bashrc
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]
For more details, please refer to Official docs
obdiag envisions an open community. We welcome your contributions in any form:
Version | Iteration Period | Release Date | Function |
---|---|---|---|
1.6.0 | 2024.01 | 2024.01.31 |
|
2.0.0 | 2024.03 | 2024.04.11 |
|
2.1.0 | 2024.04 | 2024.05.13 |
|
2.2.0 | 2024.05 | 2024.06.14 |
|
2.3.0 | 2024.06 | 2024.07.24 |
|
2.4.0 | 2024.07 | - |
|
2.5.0 | 2024.08 | - |
|
3.0.0 | 2024.09 | - |
|
3.1.0 | 2024.10 | - |
|
3.2.0 | 2024.11 | - |
|
3.3.0 | 2024.12 | - |
|
In case you have any problems when using obdiag, welcome reach out for help:
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!
Hey there, fellow developer! Want to be a part of our exciting project and streamline the code? Here's your step-by-step guide to making an impact:
git clone https://github.com/your_username/your_repo_here.git
Make Your Magic Happen: Navigate to the cloned directory and start hacking away! Whether you're fixing bugs or adding innovative features, your contributions are invaluable.
Format your code with black tool 🎨
black -S -l 256 {source_file_or_directory}
Commit Your Changes: Once you've made your enhancements, commit them using Git.
Push to Your Fork: Push your changes back to your GitHub fork.
Open a Pull Request (PR): Head back to your fork on GitHub and click the 'New pull request' button. Compare your branch against the original repository's master/main branch, write a clear description of your changes, and submit that PR!
🚀 Where Automation Kicks In 🤖
From here on, sit back as our GitHub Actions workflow takes over:
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.