perfetto-cli

Perfetto 性能追踪分析命令行工具 — ANR 检测、帧卡顿分析、CPU 利用率、内存泄漏检测、Binder 事务分析，以及任意 PerfettoSQL 查询，全部在终端完成。

功能特性

• ANR 检测 — 检测 ANR 事件并进行严重程度分级和多信号根因分析
• 帧卡顿分析 — 识别卡顿帧（SMOOTH/JANK/BIG_JANK/HUGE_JANK），提供性能评分
• CPU 分析 — 线程级利用率、热点切片、竞争分析、DVFS 频率信息
• 内存分析 — 基于 RSS 的泄漏检测及增长趋势分析、堆支配树
• Binder 事务 — IPC 性能分析，支持按 AIDL 接口和服务进程分组
• SQL 查询 — 直接执行 PerfettoSQL，按模式搜索切片
• Trace 抓取 — 通过 adb 从设备抓取 trace，支持自定义配置
• 多种输出格式 — Text（Rich 彩色）、Table（ASCII 表格）、JSON（机器可读）

快速链接

• 快速开始 — 安装并运行第一次分析
• 使用指南 — 各分析类型的详细指南
• CLI 参考 — 完整的命令和选项参考
• 贡献指南 — 帮助改进 perfetto-cli

为什么选择 perfetto-cli？

Perfetto trace 包含丰富的性能数据，但提取洞察通常需要 Perfetto UI 或编写自定义 SQL。perfetto-cli 通过提供专门的命令，直接在终端中呈现可执行的性能洞察 — 无需打开浏览器。

# 一条命令定位 ANR 根因
perfetto-cli -t trace.perfetto-trace -p com.example.app anr root-cause --anr-timestamp 5000

# 管道友好的 JSON 输出
perfetto-cli -t trace.perfetto-trace -p com.example.app frame jank -f json | jq '.[] | select(.severity == "HUGE_JANK")'