Skip to content

[FEATURE] 保留原始有序调用栈帧并支持事件时刻内存树与火焰图 #206

Closed

Description

@codeasier

功能描述

解析 snapshot 时保存原始结构化 frame,并让事件经 callstackId 关联一组有序帧;在指定事件之后,将存活内存按分配调用路径逐层拆解,提供文本、JSON 和交互式 HTML 火焰图。

使用场景

目前数据库仅保存整条调用栈的格式化文本,无法无损恢复原始文件名、行号、函数名与帧顺序。按整条栈归因也无法回答“哪个上层调用路径占用了多少内存”,或逐层下钻到分配点。

期望的实现方式

  • 新增共享 frame 表和 callstack_frame 关联表,保存 filename、line、name 和零起始 position;事件继续使用 callstackId,保留原有调用栈展示文本。
  • 栈身份由有序结构化帧决定,保留递归重复帧,避免格式化字符串相同造成不同原始帧数组合并。
  • event_frames 返回原始顺序;显式 root_first 只反向展示,不改写 position。
  • active_memory_frame_tree_at_event 按“外层调用者 → 内层分配点”构建路径树;同一帧位于不同调用路径时分别归因。
  • 分析 event_id 之后的 active block 占用,free_completed 时剔除,pending-free 仍计入;静态、采集前已有和缺失/损坏调用栈独立分类。
  • 输出 inclusive size_bytes 与 self_bytes,以及块数、requested bytes 和整体占比,满足每层“总占用=自身+直接子节点”,禁止跨层累加 inclusive bytes。
  • report memory-tree 复用共享查询契约,提供文本、--json 和可缩放、搜索、悬浮查看详情的自包含 HTML。
  • import_format_version 升至 3,使旧缓存重建;旧数据库继续支持原有文本查询,新帧查询须从原始 snapshot 重新导入,不猜测恢复帧字段。

示例

pt-snap query snapshot.db --template-use event_frames --params '{"event_id":100}' --json
pt-snap report memory-tree snapshot.db --event-id 100 --json
pt-snap report memory-tree snapshot.db --event-id 100 --format html > memory-tree.html

验收标准

  • 原始帧字段、顺序、递归重复及结构化身份在落盘后保持一致。
  • 同帧不同路径分别归因,每个节点的字节数、requested bytes 与块数守恒。
  • 释放完成边界、pending-free、静态/预存、空栈、损坏关联和多设备有回归覆盖。
  • CLI、ReportService 与 SnapshotAnalyzer 经共享查询返回一致的帧树;截断结果显式标记并拒绝渲染成完整树。
  • HTML 支持缩放、重置、搜索和详情,安全处理特殊帧文本。
  • 旧库错误提示可操作,导入缓存版本更新,英文/中文文档同步。
  • 完整测试、静态检查、打包与 snapshot provenance 检查通过。

参考资源

关联 #62 的峰值内存拆解能力,以及 #197、#198、#203 的分片互操作 roadmap。本 issue 实现单库有序帧与路径树基础能力;跨片来源解析及 msinsight 互操作仍由对应 roadmap 任务负责。

涉及 snapshot/tools/adaptors/database/、core/report_service.py、query/templates/ 与 CLI report 入口。

Activity

  1. codeasier commented on Oct 11, 2026

    @codeasier
    OwnerAuthor

    验收完成,按原定单库范围关闭为 completed。

    实现已随 #232 合入 main(merge commit cd1aac689f653e2701334d26ae1f25489f7f5af9):standalone format v3 保留原始有序帧、递归与结构化身份;事件时刻路径树逐层守恒,CLI/API/ReportService 共用查询语义;report memory-tree 支持文本、JSON 和自包含 HTML。全树搜索、子节点列表、父级导航与稳定键盘焦点使微小/零字节节点可达,旧库提示、缓存版本、损坏/截断检查及中英文文档均已覆盖。

    验收证据见 #232:5 份真实 pickle 独立核对 51,936 事件、325,233 帧出现、19,308 生命周期及 81 棵完整树;6 份真实 HTML 输出完成云 Chrome 交互验收;独立 Chromium CI 的 12 项交互测试全部通过、0 skip。合并后的 main CI 38102500076 已 7/7 jobs 成功,覆盖 Python 3.10–3.13、Chromium、Lint/格式/类型、provenance,以及 Python 3.13 wheel 构建/审计和 clean-wheel 验收。

    本 issue 的范围仍为单库原始帧与路径树基础能力;跨片树和 msinsight 互操作由对应 roadmap 继续跟踪,不计入本次完成范围。

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