perfetto

使用 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 data_source_config.proto 中的定义，您可以使用 TraceConfig 的 DataSourceConfig 成员来选择和配置数据源。
--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

• 文件系统事件：

  • ext4
  • f2fs
  • block

• ATrace 事件

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

进程统计信息

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

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

profetto 生成的数据包括：

• 系统级

  • /proc/meminfo
  • /proc/vmstat
  • /proc/stat

• 每个进程

  • /proc/<pid>/status
  • /proc/<pid>/oom_score_adj

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

Heapprofd

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

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

这会生成 ProfilePackets。 其中包括调用堆栈的 Java 框架。

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

其他来源

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

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