Skip to content

[FEATURE] 整份分片数据集的峰值、生命周期与堆栈聚合语义 #204

Closed

Description

@codeasier

父 roadmap:#197
实施阶段:P3
依赖:#198、#200、#203

范围:按模板定义跨片聚合、去重、全局排序分页、结果覆盖范围与不支持能力。

功能描述

为内建查询和报告逐项支持数据集级分析,确保整份 focus 的全量结论来自所有相关分片,而不是将单片结果或逐片 top-N 拼接为全量结果。

使用场景

长寿命 block 重复出现在多片中。全量峰值、调用栈统计、泄漏与生命周期列表需要各自不同的聚合语义,简单相加会重复统计,单片执行则可能漏掉真正峰值。

期望的实现方式

  • memory_peak:各指标独立合并各片真实事件峰值;相同值选择最早真实事件,排除负 ID 边界。支持请求范围并保留 device。
  • 峰值归因:使用全局峰值事件路由到所属片,再复用跨片来源解析;allocator gap 必须比较同一事件的数值。
  • block/生命周期:使用已证明稳定的 device+生命周期身份去重或定义唯一归属片;不能只按地址。未解析历史不足的身份单独表达,不能猜测合并。
  • 泄漏候选:基于数据集末尾存活状态与既有生命周期规则,避免重复返回每片边界存活块。
  • 堆栈统计:明确按真实分配事件/生命周期/时刻活跃集合统计,再按堆栈合并;全局聚合之后排序、算占比和 top_n。
  • 全局分页与 total/count 必须定义精确或明确有界的合同;局部分片 cap 不得静默裁掉候选再宣称全量 top-N。
  • 结果包含 scope、请求/实际覆盖范围、涉及分片、完整性;has_more/truncated 继续表示结果截断,不代替范围完整性。
  • 制定模板支持矩阵。任意 SQL/自定义模板不能自动声称支持整份数据集;尚无聚合实现的查询应要求显式单片或明确报不支持。
  • CLI/API/报告共用服务语义;连接、超时、取消与结果预算有界。

验收标准

  • 单库与整份分片全量峰值/事件、活跃归因、生命周期及泄漏候选等价。
  • 覆盖跨片相同峰值、单片局部 top-N 与全局排序不同、长寿命 block 重复、多设备、限定事件范围。
  • 全局占比分母、total、分页和截断/范围元数据可复核。
  • 不支持全量的模板/SQL 不会隐式只查一片后返回完整结论。
  • report peak-memory 保留归因完整性与字节覆盖,复用 [BUG] peak-memory report 丢失归因完整性标志,截断百分比容易被误读 #179 的修复合同。
  • 中英文模板支持矩阵与典型命令完整。

参考资源

Activity

  1. codeasier commented on Oct 4, 2026

    @codeasier
    OwnerAuthor

    Issue review

    Reality: 能力缺口真实,但不是已证实的单库缺陷:当前 focus/查询只绑定一个 DB,结果没有数据集覆盖元数据;双语 split 文档仅说明逐片导入查询。

    Reasonableness: 目标合理,但不能拼接逐片排名或简单相加;还需定义跨库栈身份,局部 callstackId/stack_id 和缩略文本不能直接合并。全局排序不应静默改变 included_bytes 百分比分母。

    Boundary: 依赖 #198/#200/#203 的数据集与来源合同就绪后逐模板实现;未支持的全量查询显式拒绝,共享服务及全局预算。单库等价须先统一真实事件口径:现有 memory_peak 未排除负 ID。沿用 #179 的同事件覆盖与截断合同,不自动推广任意 SQL。

    Evidence:

    Limitations: 固定基线 0924415;已读正文及全部评论(0 条)。仅静态核对与无文件写入的 SQLite 内存模板断言,验证了边界峰值、局部 top-1 漏全局第一及局部泄漏/生命周期不等价;未跑 pytest、未执行真实分片导入,未验证依赖完成。

  2. codeasier commented on Oct 8, 2026

    @codeasier
    OwnerAuthor

    代码已由 #216 合入 origin/main(9 commits 链,tip 7c33464)。按维护决定先关闭本 issue;PR #216 中声明 deferred 的 GUI / C++ server / 安装 wheel 人工验收,以及 #217 系列默认规模不可用问题,另行跟踪。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions