对于 perfetto 工具，您可以通过 Android 调试桥 (adb) 在 Android 设备上收集性能信息。使用 adb shell perfetto ... 命令调用 perfetto 工具。 perfetto 从您的设备上收集性能跟踪数据时会使用多种来源，例如：

• 使用 ftrace 收集内核信息
• 使用 atrace 收集服务和应用中的用户空间注释
• 使用 heapprofd 收集服务和应用的本地内存使用情况信息

本页介绍了如何调用 perfetto 并对其进行配置，以生成所需的输出。如需了解详情，请参阅 perfetto 文档。

语法

本部分介绍如何使用 adb 针对不同模式调用 perfetto 并生成跟踪记录。

数据源选择

perfetto 包含以下两种模式，可确定用于记录跟踪数据的数据源：

• 轻量模式：只能选择一部分数据源，具体来说就是 atrace 和 ftrace。但此模式可提供类似于 systrace 的接口。
• 普通模式：从协议缓冲区获取其配置，并允许您更充分地利用 perfetto 功能，方法是使用 atrace 和 ftrace 之外的数据源。

常规选项

下表列出了在 perfetto 的两种模式下都可使用的选项：

表 1. 可用的常规 perfetto 工具选项列表。

轻量模式

在轻量模式下使用 perfetto 的一般语法如下：

 adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ]
             [ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
             --out FILE

下表列出了在轻量模式下使用 perfetto 的可用选项：

表 2. 使用轻量模式时可用的 perfetto 工具选项列表。

这些选项之后是事件说明符列表：

表 3. 轻量模式的事件说明符列表。

    adb shell perfetto --out FILE wm    

      adb shell perfetto --out FILE sched/sched_switch      

普通模式

在普通模式下使用 perfetto 的一般语法如下：

 adb shell perfetto [ --txt ] --config CONFIG_FILE --out FILE

下表列出了在普通模式下使用 perfetto 的可用选项：

表 4. 使用普通模式时可用的 perfetto 工具选项列表。

支持的数据源

本部分介绍了 perfetto 生成跟踪数据时使用的不同来源。

ftrace

ftrace 数据源允许 perfetto 从内核获取事件。

可以通过在 DataSourceConfig 中设置 ftrace_config 来启用此来源。

可以启用的事件包括：

• 调度 activity：
• 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
• 文件系统事件：
• ext4
• f2fs
• block
• atrace 事件

可能会有更多可用事件，具体取决于您的设备、操作系统版本或内核。如需了解详情，请参阅配置 proto。

进程统计信息

通过进程统计信息数据源，您可以获取有关系统和各个进程的轮询计数器。

可以通过在 DataSourceConfig 中设置 process_stats_config 和 sys_stats_config 来启用此来源。

perfetto 生成的数据包括：

• 系统级
• /proc/meminfo
• /proc/vmstat
• /proc/stat
• 每个进程
• /proc/\<pid\>/status
• /proc/\<pid\>/oom_score_adj

可能会有更多可用事件，具体取决于您的设备、操作系统版本以及内核。如需了解详情，请参阅 sys_stats 和 process_stats 的配置 proto。

heapprofd

借助 heapprofd，您可以对使用本地内存的原因进行采样。

可以通过在 DataSourceConfig 中设置 heapprofd_config 来启用此来源。此设置会生成 ProfilePackets，包括调用堆栈的 Java 框架。

如需详细了解如何使用 heapprofd，请参阅 perfetto.dev。

其他来源

可能会有更多可用数据源，具体取决于您的设备、操作系统版本以及内核。如需了解详情，请参阅数据源配置 proto。

如需详细了解 perfetto，请访问 perfetto.dev。