SuperAPI AI 工具集

rspack-sftrace

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:通过 sftrace(LLVM XRay)追踪 Rspack 的 Rust 函数调用,并将结果转换为 Perfetto protobuf 格式,用于性能分析与故障排查。

主要能力:构建 sftrace 工具;编译启用 profiling 的 binding;按函数符号生成正则或列表过滤器;录制完整或过滤后的调用轨迹;将日志转为 Polars 数据(sf.pola 与 sf.pola.symtab)做分析,或转为 Perfetto protobuf 配合 viztracer 可视化。

必要用法:先克隆并构建 sftrace,安装 libsftrace.so;执行 SFTRACE=1 pnpm build:binding:profiling;在目标示例目录(如 examples/react)内用 sftrace filter 生成 sftrace.filter,再执行 sftrace record -o sf.log -- pnpm build(或用 -f 做过滤录制);可选 sftrace convert --type pola 生成 Polars 数据,或 sftrace convert 生成 sf.pb.gz 后用 vizviewer --use_external_processor 可视化。

限制:sftrace filter 按函数符号正则/列表匹配,并非 crate/模块路径级过滤;过滤不会自动保留全部子调用,未匹配的子函数可能从轨迹中消失;跨线程关系(如 rayon)不会重建为单一连续调用链。需要完整调用栈时应不加过滤或使用宽泛过滤,再在分析阶段缩小范围。