mcpField
D
doris-debug

doris-debug

github.com/apache数据与数据库4772 次安装4 周前更新
代码仓库

关于 doris-debug

doris-debug 是面向 Apache Doris 运维人员的故障排查技能，可按症状路由到专项指南，并结合诊断命令、源码映射、指标、配置参考和生产案例展开分析。

主要功能

  1. 01按 Doris 症状路由到专项技能
  2. 02提供诊断 SQL、API 和 CLI 参考
  3. 03将症状映射到 Doris 源码
  4. 04汇总生产案例、指标和配置
  5. 05采用自上而下的证据调查

适用场景

  1. 01调查查询缓慢或挂起
  2. 02诊断导入、压缩或 Tablet 问题
  3. 03追查 FE/BE 崩溃和启动失败
  4. 04排查目录与资源隔离问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/apache/doris-skills --skill doris-debug

安装后在 Claude Code 中输入/doris-debug确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

cloud/references/
case-001-warmup-empty-batch.md
compaction/references/
case-001-too-many-versions.md
case-002-schema-change-base-score.md
data-lake/references/
case-001-glue-pagination.md
import/references/
case-001-group-commit-wal-pileup.md
case-002-rpc-timeout-heavy-work-pool.md
case-003-insert-job-fe-oom.md
materialized-view/references/
case-001-mtmv-rewrite-miss.md
node/references/
case-001-be-oom-memtracker.md
case-002-filecache-lru-leak.md
case-003-be-scanner-pileup-memory.md
case-004-fe-bdbje-corruption.md
query/references/
case-001-exchange-waitfordata.md
case-002-plan-time-iceberg-rpc.md
case-003-exchange-e11-fanout.md
resource-isolation/references/
case-001-workload-policy-cme.md
shared/guides/
cascade-import-wal-versions.md
cascade-query-timeout-exchange.md
shared/references/
01-common-commands.md
02-source-map.md
03-cir-case-index.md
04-metrics-guide.md
05-config-quick-ref.md

详细介绍

Doris 故障排查路由器

使用方法

  1. 根据下表确定症状所属的领域。
  2. 阅读 shared/references/01-common-commands.md，查看诊断 SQL 和 API 命令。
  3. 阅读 shared/references/02-source-map.md，将症状映射到 Apache Doris 源代码位置。
  4. 打开目标技能（<domain>/SKILL.md），按照其中的原因表和决策树进行排查。
  5. 查看 shared/references/03-case-index.md，寻找匹配的生产案例模式。

技能路由

症状技能
查询缓慢、超时或卡住，Profile 分析，Exchange WaitForDataquery/SKILL.md
Stream Load、Broker Load、Routine Load 失败，Group Commit WAL 堆积import/SKILL.md
-235、版本过多，compaction 分数过高，compaction 延迟compaction/SKILL.md
BE/FE 内存溢出、崩溃、误报 Alive、内存泄漏node/SKILL.md
同步 MV 未命中，异步 MTMV 刷新或重写问题materialized-view/SKILL.md
Tablet 副本缺失、克隆积压、磁盘倾斜、Tablet 修复tablet/SKILL.md
FE/BE 启动失败、端口冲突、priority_networks 配置错误deployment/SKILL.md
Hive/Iceberg/Paimon/Glue 目录查询失败、元数据刷新、S3/HDFS 连接问题data-lake/SKILL.md
Workload Group 队列饥饿、CPU/内存隔离泄漏、溢写问题resource-isolation/SKILL.md
存算分离、meta-service 延迟、文件缓存、预热cloud/SKILL.md

共享参考资料

文档内容
shared/references/01-common-commands.md诊断 SQL、HTTP API 和 CLI 命令
shared/references/02-source-map.md症状 → Doris 源代码映射（含版本注释）
shared/references/03-case-index.md涵盖 8 个领域的 45 个生产案例摘要
shared/references/04-metrics-guide.md各领域的关键指标及其阈值
shared/references/05-config-quick-ref.md各领域的关键配置参数及调优指南
shared/guides/跨模块级联故障排查

配套技能

  • doris-profile-reader：深入分析 Profile，排查查询瓶颈（由 query/SKILL.md 中的原因 C——BE 计算瓶颈引用）。
  • doris-best-practices：预防性表设计和配置指南。
  • doris-architecture-advisor：结合工作负载的架构决策建议。

方法

  1. 自上而下排查 Client → FE → BE → Disk/Network
  2. 优先依据日志、指标、Profile 和 SHOW PROC 证据
  3. 在查找根因前先控制影响（限流、终止、reset_rpc_channel）
  4. 对照 Doris 源代码验证假设（02-source-map.md）
  5. 匹配已知案例模式（03-case-index.md），避免重复探索

评论

支持 Markdown