perfetto

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

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

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

语法

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

数据源选择

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

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

常规选项

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

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

选项 说明
--background |
-d
perfetto 立即退出命令行界面,并继续在后台记录您的跟踪数据。
--background-wait | -D --background 类似,但会在退出前等待(最多 30 秒)所有数据源启动。如果收到成功的确认,则退出代码为零,否则为非零(错误或超时)。
--alert-id 触发此跟踪记录的警报的 ID。
--config-id 触发配置的 ID。
--config-uid 已注册配置的应用的 UID。
--subscription-id 触发此跟踪记录的订阅的 ID。
--out OUT_FILE |
-o OUT_FILE

为输出跟踪文件或 stdout- 指定所需的路径。 perfetto 将输出写入上述标志中所述的文件。输出格式将用 AOSP trace.proto 中定义的格式编译。

注意:您必须指定输出文件的完整路径名。通常应将这些文件写入 /data/misc/perfetto-traces 文件夹。

--upload 完成后,将轨迹传递给 proto 轨迹配置中的 IncidentReportConfig 消息指定的软件包。
--no-guardrails 在测试中启用 --upload 标志时,停用防止过多使用资源的保护措施。
--reset-guardrails 重置 guardrails 的持久状态并退出(用于测试)。
--rsave-for-bugreport 如果正在运行 bugreport_score 大于 0 的跟踪记录,则系统会将跟踪记录保存到文件中。完成后输出路径。
--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/* ]...
             --out FILE

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

表 2. 使用轻量模式时可用的 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 仅使用内存中的环形缓冲区。
--app | -a Android (atrace) 应用名称

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

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

事件 说明
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 --out FILE

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

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

选项 说明
--config CONFIG_FILE | -c CONFIG_FILE 指定配置文件的路径。在普通模式下,某些配置可能会在配置协议缓冲区中进行编码。此文件必须符合 AOSP trace_config.proto 中定义的协议缓冲区架构。

根据 AOSP data_source_config.proto 中的定义,可以使用 TraceConfigDataSourceConfig 成员来选择和配置数据源。

--txt 指示 perfetto 将配置文件解析为 pbtxt。此标志仅用于本地测试,不建议将其用于生产环境。

支持的数据源

本部分介绍了 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
  • 文件系统事件:

  • atrace 事件

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

进程统计信息

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

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

perfetto 生成的数据包括:

  • 系统级

    • /proc/meminfo
    • /proc/vmstat
    • /proc/stat
  • 每个进程

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

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

heapprofd

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

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

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

其他来源

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

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