--- title: "一键根因分析 - 敏捷诊断工具 V2.5.0 | OceanBase 文档中心" description: 一键根因分析 本文适用于独立部署 obdiag 的场景，使用 obdiag rca 命令可帮助 OceanBase 数据库相关的诊断信息分析，目前支持对 OceanBase 的异常场景进行分析，找出可能导致问题的原因。 如果是 obd 部署的集群，可直接通过 obd 侧诊断命令组对所选集群进行信息收集，详细命令可参考… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*5ZXST55u540AAAAAAAAAAAAADiGDAQ/original) 敏捷诊断工具V 2.5.0 # 一键根因分析 更新时间：2026-04-13 17:11:17 [编辑](https://github.com/oceanbase/odt-doc/edit/V2.5.0/zh-CN/460.rca/461.obdiag-root-cause-analysis.md) 本文适用于独立部署 obdiag 的场景，使用 `obdiag rca` 命令可帮助 OceanBase 数据库相关的诊断信息分析，目前支持对 OceanBase 的异常场景进行分析，找出可能导致问题的原因。 如果是 obd 部署的集群，可直接通过 obd 侧诊断命令组对所选集群进行信息收集，详细命令可参考 [诊断工具命令组](https://www.oceanbase.com/docs/community-obd-cn-10000000002049483)。 注：由于根因分析需要大量的内部表数据来进行分析，因此obdiag配置文件中的tenant_sys用户需要有oceanbase库下的表及视图的读权限 ## rca 命令组总览 ```shell # 查看已经支持的所有根因分析场景 obdiag rca list # 按场景执行根因分分析 obdiag rca run --scene= ``` `scene_name` 包含如下： - disconnection：一键断连诊断，基于obproxy的诊断日志。 - major_hold: 一键卡合并诊断。 - lock_conflict: 一键锁冲突诊断。 - ddl_disk_full: DDL 过程中报磁盘空间不足的问题诊断。 - transaction_disconnection: 针对事务断连场景的根因分析 - log_error: 日志相关问题排查。目前支持：无主场景。 - transaction_not_ending: 事务不结束场景（测试板），目前使用较为复杂。 - transaction_rollback: 事务回滚报错 - transaction_execute_timeout: 事务执行超时报错 - clog_disk_full: clog日志磁盘空间满的问题 - transaction_wait_timeout: 事务等待超时报错 - transaction_other_error: 事务其他错误，除了目前已经列出的错误，比如错误码为：-4030，-4121，-4122，-4124，-4019 ## obdiag rca list 使用该命令可以获取根因分析目前支持的场景 ## obdiag rca run 使用该命令可执行指定场景的根因分析 ```shell obdiag rca run --scene= ``` 选项说明如下： | 选项名 | 是否必选 | 数据类型 | 默认值 | 说明 | | --- | --- | --- | --- | --- | | --scene | 否 | string | 默认为空 | 需要进行的根因分析场景，可通过 `obdiag rca list` 查看支持的场景列表 | | --store_dir | 否 | string | 默认为 `./rca` | 根因分析结果保存路径 | | --input_parameters | 否 | string | 默认为空 | 传递的环境变量，可通过 `obdiag rca list` 查看帮助 | 以分析断连的场景为例，命令如下： ```shell obdiag rca run --scene=disconnection ``` 输出如下： ```shell +-----------------------------------------------------------------------------------------------------------+ | record | +------+----------------------------------------------------------------------------------------------------+ | step | info | +------+----------------------------------------------------------------------------------------------------+ | 1 | node:xxx.xxx.xxx obproxy_diagnosis_log:[2024-01-18 17:48:37.667014] [23173][Y0-00007FAA5183E710] | | | [CONNECTION](trace_type="CLIENT_VC_TRACE", connection_diagnosis={cs_id:1065, ss_id:4559, | | | proxy_session_id:837192278409543969, server_session_id:3221810838, | | | client_addr:"xxx.xxx.xxx.xxx:xxxx", server_addr:"xxx.xxx.xxx.xxx:2883", cluster_name:"obcluster", | | | tenant_name:"sys", user_name:"root", error_code:-10010, error_msg:"An unexpected connection event | | | received from client while obproxy reading request", request_cmd:"COM_SLEEP", sql_cmd:"COM_END", | | | req_total_time(us):5315316}{vc_event:"VC_EVENT_EOS", user_sql:""}) | | 2 | cs_id:1065, server_session_id:3221810838 | | 3 | trace_type:CLIENT_VC_TRACE | | 4 | error_code:-10010 | +------+----------------------------------------------------------------------------------------------------+ The suggest: Need client cooperation for diagnosis ``` 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线