perfetto
使用 perfetto
工具,您可以通过 Android 调试桥 (ADB) 在 Android 设备上收集性能信息。 perfetto
从您的设备上收集性能跟踪数据时会使用多种来源,例如:
- 使用
ftrace
收集内核信息 - 使用
atrace
收集服务和应用中的用户空间注释 - 使用
heapprofd
收集服务和应用的本地内存使用情况信息
本页介绍了如何调用 perfetto
并对其进行配置,以生成所需的输出。
语法
本部分介绍了如何使用 ADB 调用 perfetto
并生成跟踪数据。
数据源选择
perfetto
包含以下两种模式,可确定用于记录跟踪数据的数据源:
-
轻量模式 :只能选择一部分数据源,具体来说就是 atrace 和 ftrace。但此模式可提供类似于
systrace
的接口。 -
普通模式 :从协议缓冲区获取其配置,并且可以让您使用 atrace 和 ftrace 之外的数据源,从而更加充分地利用
perfetto
的功能。
本部分介绍了使用上述各种模式生成跟踪数据所需的 perfetto
语法。
常规选项
下表列出了在 perfetto
的两种模式下都可使用的选项。
选项 | 说明 |
---|---|
`–background | -d` |
`–out OUT_FILE | -o OUT_FILE` |
--dropbox TAG |
使用您指定的标签通过 DropBoxManager API 来上传您的跟踪数据。 |
--no-guardrails |
在测试中启用 --dropbox 标记时,停用防止资源过多使用的保护措施。 |
--reset-guardrails |
重置 guardrails 的持久状态并退出(用于测试)。 |
--query |
查询服务状态,并将其输出为用户可读的文本。 |
--query-raw |
与“–query”类似,但会输出 tracing_service_state.proto. 的原始 proto 编码字节。 |
`–help | -h` |
轻量模式
在轻量模式下使用 perfetto
的一般语法如下:
adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ]
[ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
下表列出了在轻量模式下使用 perfetto
的可用选项:
选项 | 说明 |
---|---|
`–time TIME[s | m |
`–buffer SIZE[mb | gb] |
`–size SIZE[mb | gb] |
接下来介绍事件说明符列表
事件 | 说明 |
---|---|
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 |
FTRACE_GROUP/* | 记录群组中的所有事件(例如 sched/)。指定您想为其记录跟踪数据的 ftrace 事件群组。 例如,以下命令会跟踪 sched/ 事件: adb shell perfetto --out FILE ‘sched/*’ |
普通模式
在普通模式下使用 perfetto
的一般语法如下:
adb shell perfetto [ --txt ] --config CONFIG_FILE
下表列出了在普通模式下使用 perfetto
的可用选项:
选项 | 说明 |
---|---|
`–config CONFIG_FILE | -c CONFIG_FILE` |
--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
- 文件系统事件:
- ATrace 事件
可能会有更多可用事件,具体取决于您的设备、操作系统版本以及内核。如需了解详情,请参阅配置 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。.
转载自:https://developer.android.com/studio/command-line/perfetto?hl=zh-cn