使用 perfetto
工具,您可以通过 Android 调试桥 (ADB) 在 Android 设备上收集性能信息。perfetto
从您的设备上收集性能跟踪数据时会使用多种来源,例如:
- 使用
ftrace
收集内核信息 - 使用
atrace
收集服务和应用中的用户空间注释 - 使用
heapprofd
收集服务和应用的本地内存使用情况信息
本页介绍了如何调用 perfetto
并对其进行配置,以生成所需的输出。
语法
本部分介绍了如何使用 ADB 调用 perfetto
并生成跟踪数据。
数据源选择
perfetto
包含以下两种模式,可确定用于记录跟踪数据的数据源:
- 轻量模式:只能选择一部分数据源,具体来说就是 atrace 和 ftrace。但此模式可提供类似于
systrace
的接口。 - 普通模式:从协议缓冲区获取其配置,并且可以让您使用 atrace 和 ftrace 之外的数据源,从而更加充分地利用
perfetto
的功能。
本部分介绍了使用上述各种模式生成跟踪数据所需的 perfetto
语法。
常规选项
下表列出了在 perfetto
的两种模式下都可使用的选项。
选项 | 说明 |
---|---|
--background | -d
|
Perfetto 立即退出命令行界面,并继续在后台记录您的跟踪数据。 |
--out OUT_FILE | -o OUT_FILE
|
为输出跟踪文件或 stdout 指定所需的路径。perfetto 将输出内容写入上述标记所述的文件。输出格式将用 AOSP trace.proto 中定义的格式编译。
|
--dropbox TAG
|
使用您指定的标签通过 DropBoxManager API 来上传您的跟踪数据。 |
--no-guardrails
|
在测试中启用 --dropbox 标记时,停用防止资源过多使用的保护措施。 |
--reset-guardrails
|
重置 guardrails 的持久状态并退出(用于测试)。 |
--query
|
查询服务状态,并将其输出为用户可读的文本。 |
--query-raw
|
与“--query”类似,但会输出 tracing_service_state.proto. 的原始 proto 编码字节。 |
--help | -h
|
输出 perfetto 工具的帮助文本。
|
轻量模式
在轻量模式下使用 perfetto
的一般语法如下:
adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ] [ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
下表列出了在轻量模式下使用 perfetto
的可用选项:
选项 | 说明 |
---|---|
--time TIME[s|m|h] | -t TIME[s|m|h]
|
指定跟踪记录的持续时间(以秒、分钟或小时为单位)。例如,--time 1m 指定持续 1 分钟的跟踪记录。默认持续时间为 10 秒。
|
--buffer SIZE[mb|gb] | -b SIZE[mb|gb]
|
指定环形缓冲区空间大小,以兆字节 (mb) 或千兆字节 (gb) 为单位。默认参数为 --buffer 32mb 。
|
--size SIZE[mb|gb] | -s SIZE[mb|gb]
|
指定文件大小上限,以兆字节 (mb) 或千兆字节 (gb) 为单位。默认情况下,perfetto 仅使用内存中的环形缓冲区。
|
接下来介绍事件说明符列表
事件 | 说明 |
---|---|
ATRACE_CAT |
指定您想为其记录跟踪数据的 atrace 类别。例如,以下命令会使用 atrace 跟踪窗口管理器:
adb shell perfetto --out FILE wm 如需记录其他类别,请参阅 atrace 类别列表。 |
FTRACE_GROUP/FTRACE_NAME |
指定您想为其记录跟踪数据的 ftrace 事件。例如,以下命令用于跟踪 sched/sched_switch 事件:
adb shell perfetto --out FILE sched/sched_switch |
普通模式
在普通模式下使用 perfetto
的一般语法如下:
adb shell perfetto [ --txt ] --config CONFIG_FILE
下表列出了在普通模式下使用 perfetto
的可用选项:
选项 | 说明 |
---|---|
--config CONFIG_FILE | -c CONFIG_FILE
|
指定配置文件的路径。在普通模式下,某些配置可能会在配置协议缓冲区中进行编码。此文件必须符合 AOSP trace_config.proto 中定义的协议缓冲区架构。
根据 AOSP |
--txt
|
指示 perfetto 将配置文件解析为 pbtxt。此标记为实验性标记,不建议您在正式版中启用此标记。 |
支持的数据源
本部分介绍了 perfetto
生成跟踪数据时使用的不同来源。
FTrace
ftrace 数据源允许 perfetto
从内核获取事件。
您可以通过在 DataSourceConfig 中设置 ftrace_config 来启用此来源。
可以启用的事件包括:
调度活动:
- sched/sched_switch
- sched/sched_wakeup
- sched/sched_wakeup_new
- sched/sched_process_exec
- sched/sched_process_exit
- sched/sched_process_fork
- sched/sched_process_free
- sched/sched_process_hang
- sched/sched_process_wait
文件系统事件:
可能会有更多可用事件,具体取决于您的设备、操作系统版本以及内核。如需了解详情,请参阅配置 proto。
进程统计信息
通过进程统计信息数据源,您可以获取有关系统和各个进程的轮询计数器。
您可以通过在 DataSourceConfig 中设置 process_stats_config 和 sys_stats_config 来启用此数据源。
profetto
生成的数据包括:
可能会有更多可用事件,具体取决于您的设备、操作系统版本以及内核。如需了解详情,请参阅 sys_stats 和 process_stats 的配置 proto。
Heapprofd
借助 Heappofdd,您可以对使用本地内存的原因进行采样。
您可以通过在 DataSourceConfig 中设置 heapprofd_config 来启用此来源。
这会生成 ProfilePackets。 其中包括调用堆栈的 Java 框架。
如需详细了解如何使用 heapprofd
,请访问 perfetto.dev。
其他来源
可能会有更多可用数据源,具体取决于您的设备、操作系统版本以及内核。如需了解详情,请参阅数据源配置 proto。
如需详细了解 perfetto
,请访问 perfetto.dev。