上一篇文章 Android Perfetto 系列 1:Perfetto 工具简介 介绍了 Perfetto 是什么,这篇简单介绍一下 Perfetto 的抓取。
Android 官方将 Systrace 列为 legacy 工具,并推荐在 Android 10 及以上使用 Perfetto。写下本文时,Perfetto 在我的日常工作中已基本取代 Systrace,我接触到的 OPPO、vivo 团队也在迁移,因此希望把原来的 Systrace 分析方法用 Perfetto 再讲一遍。
技术核查:2026-10-14。 本文以 Android 12+ 设备为主要示例,保留 2024 年截图;旧系统与新版 UI 的差异在对应段落说明。命令和配置按官方文档、脚本核对,本文未新增真机采集结果。
本文目录
Paul Graham 说:要么给大部分人提供有点想要的东西,要么给小部分人提供非常想要的东西。Perfetto 属于小部分人非常想要的东西,那就开始写吧,欢迎大家多多交流和沟通,发现错误和描述不准确的地方请及时告知我,我会及时修改,以免误人子弟。
我想借这个系列,和大家一起对照 Perfetto 看 App、Framework、Linux 是怎么配合起来运行的。如果读过不少源码和性能文章,还是记不住流程,不妨把代码放回 Trace 的时间线上看看。
Perfetto 系列目录
- Android Perfetto 系列目录
- Android Perfetto 系列 1:Perfetto 工具简介
- Android Perfetto 系列 2:Perfetto Trace 抓取
- Android Perfetto 系列 3:熟悉 Perfetto View
- Android Perfetto 系列 4:使用命令行在本地打开超大 Trace
- Android Perfetto 系列 5:Android App 基于 Choreographer 的渲染流程
- Android Perfetto 系列 6:为什么是 120Hz?高刷新率的优势与挑战
- Android Perfetto 系列 7:MainThread 和 RenderThread 解读
- Android Perfetto 系列 8:深入理解 Vsync 机制与性能分析
- Android Perfetto 系列 9:CPU 信息解读
- Android Perfetto 系列 10:Binder 调度与锁竞争
- Android Perfetto 系列 11:PerfettoSQL、Trace Processor 与回归检测
- Android Perfetto 系列 12:Trace 数据流与丢失排查
- Android Perfetto 系列 13:Perfetto SDK、Track Event 与 App 现场 Trace
- Android Perfetto 系列 14:heapprofd 与内存 Profiling
- Android Perfetto 系列 15:Boot Trace、长时间现场 Trace 与偶发问题抓取
- Android Perfetto 系列 16:GPU、Power Counters 与硬件瓶颈分析
- Android Perfetto 系列 17:专项场景自动化、问题清单与平台体系
- Android Perfetto 系列 18:响应速度实战,从输入事件到首帧反馈
- 视频(B站) - Android Perfetto 基础和案例分享
- 视频(B站) - Android Perfetto 分享 - 出图类型分享:AOSP、WebView、Flutter + OEM 系统优化分享
如果大家还没看过 Systrace 系列,下面是传送门:
- Systrace 系列目录 : 系统介绍了 Perfetto 的前身 Systrace 的使用,并通过 Systrace 来学习和了解 Android 性能优化和 Android 系统运行的基本规则。
- 个人博客 :个人博客,主要是 Android 相关的内容,也放了一些生活和工作相关的内容。
欢迎大家在 关于我 页面了解微信群入口,讨论你的问题、你最想看到的关于 Perfetto 的部分,以及跟各位群友讨论所有 Android 开发相关的内容
正文
使用 Perfetto 分析问题跟使用 Systrace 分析问题的步骤是一样的:
- 先抓取 Perfetto 文件
- 在ui.perfetto.dev 中打开 Trace 文件进行分析或者使用命令行来进行分析
这篇文章就简单介绍一下使用 Perfetto 抓取 Trace 文件的方法,个人比较推荐使用命令行来抓取,不管是自己配置的命令行还是官方的命令行抓取工具,都非常实用。
1. 使用命令行来抓取 Perfetto(推荐)
基本命令 - adb shell perfetto
连接已授权 USB 调试的 Android 设备后,可以用设备上的 /system/bin/perfetto 抓取。下面是轻量模式示例;运行后立即操作手机,在这 20 秒内复现场景,命令返回后再执行 adb pull。
1 | # 1. 启动后立即在手机上复现场景;终端会等待录制结束 |
这个示例录制 20 秒,使用 64 MB 环形缓冲区;写满会覆盖旧事件,因此不保证保留完整的 20 秒。后面的参数是 atrace 类别,支持情况随系统变化,可用 adb shell atrace --list_categories 查看。轻量模式主要覆盖 ftrace/atrace,不会因为写了 memory 就得到完整堆快照,也不会自动启用 FrameTimeline 或调用栈采样。
若要录入自己 App 的 android.os.Trace / ATrace 埋点,在类别列表之前增加 --app com.example.app,并替换为目标包名;gfx、view 等系统类别不能替代 App 选择。采集完成后检查命令是否成功、文件是否包含目标时段与事件,再在 Perfetto UI 打开。输出路径是设备路径,adb pull 后的文件才在电脑上。
进阶命令 adb shell perfetto with config file
这里就是 Perfetto 与 Systrace 不同的地方,Perfetto 可以抓取的信息非常多,其数据来源也非常多,每次都用命令行加一大堆配置的话会很不方便。这时候我们就可以使用一个单独的 配置文件(Config),来存储这些信息,每次抓取的时候,指定这个配置文件即可。
下面以 Android 12+ 设备说明配置文件的传递。config.pbtx 是 UTF-8 文本格式的 TraceConfig,需带 --txt;扩展名不是判断文本或二进制的依据。
在 Android 12 及之后的设备上
从 Android 12 开始,可以直接使用/data/misc/perfetto-configs目录来存储配置文件,这样就不需要通过 stdin 来传递配置文件了。具体命令如下:
1 | adb push config.pbtx /data/misc/perfetto-configs/config.pbtx |
先把后文给出的纯配置内容保存为 config.pbtx,再执行上面的命令。录制期间复现场景,结束后还需要导出:
1 | adb pull /data/misc/perfetto-traces/trace.perfetto-trace |
Android 10/11(使用兼容的数据源配置,例如去掉仅 Android 12+ 支持的 FrameTimeline)或希望避免设备配置路径差异时,可在 macOS/Linux 的 shell 中通过标准输入传递:
1 | adb shell perfetto --txt -c - -o /data/misc/perfetto-traces/trace.perfetto-trace < config.pbtx |
这是电脑端的输入重定向,-c - 让 Perfetto 从 stdin 读取。Android 9 自带的 Perfetto 不支持 --txt,需要二进制配置;Android 9/10 部分设备还需启用 tracing 服务,见官方版本和服务说明。不要直接套用本篇 Android 12+ 的命令。
Config 的来源
Config 我建议使用 ui.perfetto.dev 的 Record new trace 这里进行选择定制,然后再保存到本地的文件里面,不同的场景就加载不同的 Config 即可,后文有详细讲到这部分,感兴趣的可以看一下。
配置可以导出后共享;先从官方示例或本文后面的基础配置开始,再按场景保存不同版本。
官方代码库也提供了配置示例。这些不是所有设备都适用的预设,应核对数据源、权限、时长和缓冲区大小。
注意事项
- 连接与版本:
adb devices应显示目标为device,不是unauthorized或offline。多设备时给原始 adb 命令加-s 设备序列号;给官方脚本加--serial 设备序列号。记录系统版本、设备端 Perfetto 版本及最终配置。 - 提前停止:直接运行
adb shell perfetto时,Ctrl+C 的传递不可靠,不能把电脑端退出当作设备端已正常收尾。可使用官方脚本处理停止,或先进入交互式adb shell,再在设备 shell 中运行 Perfetto。按设定时长正常完成的例子不需要额外中断。 - SELinux 限制: Android 12 及以上设备可把配置文件放在
/data/misc/perfetto-configs,不要假设perfetto能直接读取/data/local/tmp里的配置文件。
2. 使用 Perfetto 提供的官方脚本抓取(强烈推荐)
官方 tools/record_android_trace 需要电脑安装 Python 3,并让 adb 位于 PATH。它负责调用设备端工具、等待、拉取文件,默认再通过本地 HTTP 服务交给浏览器打开;不想自动打开或运行在无图形环境时,加 --no-open。下面按 2026-10-14 的官方 main 脚本核对,批量实验应保存使用的脚本版本。Android 10+ 默认使用系统工具;更旧系统可能下载并推送 tracebox,不是所有版本都只执行同一条系统命令。
Linux / macOS:
1 | curl -fLO https://raw.githubusercontent.com/google/perfetto/main/tools/record_android_trace |
Windows PowerShell(已安装 Python 3 和 py 启动器):
1 | curl.exe -fLO https://raw.githubusercontent.com/google/perfetto/main/tools/record_android_trace |
下载脚本后,Linux/macOS 可以用 -c 指定配置文件:
1 | ./record_android_trace -c config.pbtx -o trace_file.perfetto-trace |
Windows 对应使用 py -3 record_android_trace -c config.pbtx -o trace_file.perfetto-trace。
使用 -c 后,时长、buffer 和数据源都在配置中填写,不要再期待短参数 -t、-b 覆盖它。下面的基础配置已有 duration_ms;没有时长或其他停止条件的配置可能一直录制。
在脚本提示开始录制后复现场景。脚本支持 Ctrl+C 请求停止;等待拉取结束,再检查文件。下图是 2024 年旧版脚本输出,其 30 秒命令与本文 10 秒示例不同。
脚本内容可以直接访问:https://raw.githubusercontent.com/google/perfetto/main/tools/record_android_trace 来查看,
3. 使用手机上的开发者工具来抓取
无法连接电脑,或测试场景不适合插 USB 时,可以使用系统跟踪应用。该入口从 Android 9(API 28)提供;Android 10+ 默认保存 Perfetto 格式,Android 9 保存 Systrace 格式。OEM 可能调整或隐藏入口,不能保证所有手机具有相同选项。
启动系统跟踪应用
启用开发者选项:先确保你的设备已经启用了开发者选项。如果你的设置里面没有开发者选项,你需要在关于手机那里,找到编译编号,然后连续点击 7 次,就可以打开开发者选项。
打开开发者选项:在设置菜单中找到并打开开发者选项。
启动系统跟踪:在开发者选项中向下滚动直到找到”系统跟踪(System Trace)”或类似的选项。点击它,将打开系统跟踪应用。
下面是原文设备的系统跟踪界面,供辨认入口;具体设置以当前设备为准。
常见设置包括要采集的类别、每 CPU 缓冲区大小、可调试应用和快捷设置磁贴。支持“长时间跟踪”的设备还可设置最大文件大小与最大时长;普通模式是滚动缓冲区,不是任意固定秒数的完整录制。应用管理输出文件,再通过保存通知、文件应用或分享入口导出,通常没有自选输出路径的选项。
启动和停止跟踪
配置好所有需要的参数后,你可以通过点击”录制跟踪记录”按钮来启动跟踪。再次点击”录制跟踪记录”按钮就可以结束抓取,完成抓取后,通常会有一个提示告诉你抓取已经完成,并提供查看或分享跟踪文件的选项。就可以将跟踪文件导出到电脑上,使用 Perfetto 网页 UI 进行更深入的分析。
4. 使用网页端来抓取
2024 年写初稿时,我觉得网页抓取有点迷:有时连不上,有时又提示 ADB 被占用。所以我更习惯用命令行采集,网页则用来配 Config。下面保留旧截图,并补充当前连接方式。
版本更新:v49.0(2025-01-06)的官方变更记录确认重写了录制页面。本次只读查看的 stable UI 为 v58.3-11fbaed83,已提供多种连接方式;这不代表每台设备的连接稳定性都经过验证。
在 Record new trace 选择 Android 平台和连接方式。当前 UI 的 WebUsb 需要浏览器支持并独占设备 USB 接口,可能与本地 adb server 冲突;ADB + WebSocket 使用本地桥接程序,可以与其他 adb 工具共存。按页面提示连接并在手机确认授权,再配置和开始录制。不要因为旧截图提到 kill 就无条件结束所有 ADB 会话;也可以只在网页生成配置,用命令行采集。

旧版入口叫 Recording command;本次查看的 v58.3 UI 中叫 Cmdline instructions,分别列出 Shell 命令和 textproto 配置。可复制或下载配置,供后续命令行重复使用。

按问题选择数据源,不建议照旧图的“可以都选上”批量全开。UI 卡顿通常需要 CPU 调度、相关 atrace 类别与目标 App;FrameTimeline 另需 Android 12+ 的 android.surfaceflinger.frametimeline 数据源。Logcat 是可选日志源,并非每个问题都需要。采得越多,开销、数据量和丢失风险也越高。

需要调用栈时,再启用 Stack sampling。它依赖 traced_perf、设备支持和目标进程权限;user 系统通常只允许 profileable 或 debuggable 目标,不能照图就采到任意系统进程。当前官方 CPU profiling 教程按 Android 15+ 给出新配置流程,旧设备需匹配其采集组件版本。采样是离散观测,不是记录每次函数调用;频率、栈展开和符号缺失都会影响结果。


至于其他的有啥用,可以自己探索,后续的 Perfetto 也会介绍到每个部分和他在 Trace 上的呈现,帮助大家更快入手 Perfetto。
从网页端提取参数
当前 Cmdline instructions 可以直接下载 textproto。若使用旧版页面的整段 Shell 命令,只保存配置正文:去掉开头的 adb shell ...、<<EOF 与末尾独占一行的 EOF,不要删配置自身的花括号。下面保留旧截图,随后给一个可复制的基础配置。

下面内容保存为 config.pbtx,用于 Android 12+ 的短时 UI 场景;把 com.example.app 换成实际包名。32 MB 环形缓冲区只是示例,满后覆盖旧事件,不保证在所有负载下保存完整 10 秒。
1 | buffers { |
它包含调度事件、App/系统埋点、初始进程信息和 FrameTimeline;不包含 logcat、堆分析或完整调用栈。采集后先确认场景落在保留窗口内、目标数据源有输出,再检查 Trace 的丢失统计;文件能打开不等于数据完整。长时间抓取需要另外配置持续写盘与容量限制,见TraceConfig。
参考文档
- https://perfetto.dev/docs/getting-started/system-tracing
- https://perfetto.dev/docs/concepts/config
- https://developer.android.com/tools/releases/platform-tools?hl=zh-cn
- https://mp.weixin.qq.com/s/nsqc51L5T4mrTUVsPgkj6A
- https://juejin.cn/post/7344983784549400613
- https://cs.android.com/android/platform/superproject/main/+/main:external/perfetto/test/configs/
关于我 && 博客
下面是个人的介绍和相关的链接,期望与同行的各位多多交流,三人行,则必有我师!
- 博主个人介绍 :里面有个人的微信和微信群链接。
- 本博客内容导航 :个人博客内容的一个导航。
- 个人整理和搜集的优秀博客文章 - Android 性能优化必知必会 :欢迎大家自荐和推荐 (微信私聊即可)
- Android性能优化知识星球 :2026 年已关闭,保留历史介绍。
一个人可以走的更快 , 一群人可以走的更远






