在命令行中捕获系统跟踪

systrace 命令调用 Systrace 工具，该工具允许您在系统级别收集和检查设备上所有正在运行的进程的计时信息。

本文档说明如何从命令行生成 Systrace 报告。在运行 Android 9（API 级别 28）或更高版本的设备上，您还可以使用 系统跟踪系统应用 生成 Systrace 报告。

要运行 systrace，请完成以下步骤

  1. 从 Android Studio 中，下载并安装最新的 Android SDK 工具。
  2. 安装 Python 并将其包含在工作站的 PATH 环境变量中。
  3. 将 android-sdk/platform-tools/ 添加到您的 PATH 环境变量中。此目录包含 Android 调试桥二进制文件 (adb)，它由 systrace 程序调用。
  4. 使用 USB 调试连接 将运行 Android 4.3（API 级别 18）或更高版本的设备连接到您的开发系统。

systrace 命令包含在 Android SDK 工具包中，位于 android-sdk/platform-tools/systrace/ 中。

语法

要为应用生成 HTML 报告，您需要使用以下语法从命令行运行 systrace

python systrace.py [options] [categories]

例如，以下命令调用 systrace 来记录设备活动并生成名为 mynewtrace.html 的 HTML 报告。此类别列表对于大多数设备来说是合理的默认列表。

$ python systrace.py -o mynewtrace.html sched freq idle am wm gfx view \
    binder_driver hal dalvik camera input res memory

提示：如果您想查看跟踪输出中任务的名称，则必须在命令参数中包含 sched 类别。

要查看连接的设备支持的类别列表，请运行以下命令

$ python systrace.py --list-categories

如果您未指定任何类别或选项，systrace 将生成包含所有可用类别的报告并使用默认设置。可用的类别取决于您正在使用的连接设备。

全局选项

全局选项 描述
-h | --help 显示帮助消息。
-l | --list-categories 列出连接设备可用的跟踪类别。

命令和命令选项

命令和选项 描述
-o file 将 HTML 跟踪报告写入指定的 file。如果您未指定此选项，systrace 会将您的报告保存到与 systrace.py 相同的目录中，并将其命名为 trace.html。
-t N | --time=N 跟踪设备活动 N 秒。如果您未指定此选项，systrace 将提示您通过从命令行按 Enter 键来结束跟踪。
-b N | --buf-size=N 使用 N 千字节的跟踪缓冲区大小。此选项允许您限制在跟踪期间收集的数据的总大小。
-k functions
| --ktrace=functions		 跟踪以逗号分隔的列表中指定的特定内核函数的活动。
-a app-name
| --app=app-name		 启用应用的跟踪，指定为 进程名称 的逗号分隔列表。这些应用必须包含来自 Trace 类的跟踪检测调用。在分析应用时，应指定此选项——许多库（例如 RecyclerView）包含跟踪检测调用，当您启用应用级跟踪时，这些调用会提供有用的信息。有关更多信息，请参阅 定义自定义事件。

要在运行 Android 9（API 级别 28）或更高版本的设备上跟踪所有应用，请传递通配符字符 "*"（包括引号）。
--from-file=file-path 从文件（例如包含原始跟踪数据的 TXT 文件）创建交互式 HTML 报告，而不是运行实时跟踪。
-e device-serial
| --serial=device-serial		 对特定连接设备进行跟踪，由其 设备序列号 识别。
类别 包含您指定系统进程的跟踪信息，例如 gfx 用于渲染图形的系统进程。您可以使用 -l 命令运行 systrace 以查看连接设备可用的服务列表。