在命令行中捕获系统跟踪

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以查看已连接设备可用的服务列表。