SuperAPI AI 工具集

doris-profile-reader

数据与分析

查看项目

更新于 10-15 16:51

技能介绍

用途:在 Apache Doris 查询运行时 profile 中定位真实瓶颈。核心原则是先区分主动计算与依赖、队列、反压等待,再判断某算子是否昂贵;出现连接时,还需区分即时运行时瓶颈与计划形态原因(如连接顺序、运行时过滤器方向)。

主要能力:按阅读顺序组织分析,包括 reading-workflow、counter-semantics、operator-guide、failure-patterns、join-order-diagnosis、runtime-filters、source-profile-inventory、solution-playbook、known-issues-solutions 等参考文档;给出标准回答结构:结论、证据、推理、后续检查、以及在请求时给出的解决方案或缓解措施。

使用方式:先读 references/reading-workflow.md 了解分析与输出约定,再按需查阅对应参考文档;可用 scripts/extract_source_profile_inventory.py 扫描 Doris 源码中工厂创建的算子与计数器注册,脚本仅作证据生成辅助。

限制:不得把 WaitForDependencyTime 等等待计数器当作算子直接计算成本;需保留 proven、likely、not proven 的不确定性表述;异步 CPU 火焰图、FE 加载镜像/鉴权 profile、日志等不是 BE 查询运行时 profile,文件类型不符时应报告不匹配并索取正确 profile;若缺少 schema、统计信息、版本、配置、日志或快慢对比,只能说明 profile 能证明什么并列出缺失检查,不可过度断言。