SuperAPI AI 工具集

doris-debug

测试与质量

查看项目

更新于 10-15 17:12

技能介绍

用途:面向 Apache Doris 生产环境的诊断路由技能,帮助按症状快速定位到对应的排查子技能与参考资料。

主要能力:提供症状到子技能的路由表,覆盖慢查询/超时/挂起与 Profile 分析、Stream/Broker/Routine Load 失败与 Group Commit WAL 堆积、-235 与 compaction 版本过多、BE/FE OOM 与崩溃、同步与异步物化视图问题、Tablet 副本缺失与克隆积压、FE/BE 启动失败与端口冲突、Hive/Iceberg/Paimon/Glue 等数据湖查询失败、Workload Group 队列饥饿与资源隔离、存算分离与 meta-service 延迟等。

使用方式:先按症状表确定领域,阅读 shared/references/01-common-commands.md 获取诊断 SQL 与 API 命令,阅读 02-source-map.md 将症状映射到 Doris 源码位置,再打开对应领域目录下的 SKILL.md 按其原因表与决策树执行,并查阅 03-case-index.md 匹配生产案例。

配套资料:01-common-commands.md(诊断 SQL、HTTP API、CLI)、02-source-map.md(症状到源码映射,含版本标注)、03-case-index.md(8 个领域 45 个生产案例)、04-metrics-guide.md(各领域关键指标与阈值)、05-config-quick-ref.md(关键配置与调优)、shared/guides/(跨模块级联排查)。

配套技能:doris-profile-reader 用于深度 Profile 分析,doris-best-practices 提供预防性表设计与配置建议,doris-architecture-advisor 提供负载感知架构决策。

方法论:按 Client → FE → BE → 磁盘/网络自顶向下排查;以日志、指标、Profile、SHOW PROC 证据为先;先止血(限流、kill、reset_rpc_channel)再找根因;用源码验证假设;匹配已知案例模式避免重复发现。

限制:资料未提供具体命令内容、阈值数值、版本兼容范围与安装方式,需查阅上述参考文件;本技能为诊断路由,不直接执行修复。