1. 项目缘起为什么需要从命令行捕获SystemTrace在日常的Android应用性能优化和系统问题排查中我们经常需要分析应用的卡顿、掉帧、响应慢等问题。Android Studio自带的Profiler工具固然强大图形化界面操作也直观但在很多场景下它显得“笨重”且不够灵活。比如当你需要在持续集成CI流水线中自动化收集性能数据。测试设备是远程的、无图形界面的如云真机、嵌入式设备。需要长时间、高频率地捕获Trace但不想被IDE的内存占用和UI刷新拖慢。只想快速抓取一个Trace文件然后用更专业的工具如Perfetto UI进行离线深度分析。这时通过adb shell命令直接捕获systemtrace系统跟踪就成为了一个高效、精准的选择。它绕过了IDE的中间层直接与设备上的跟踪服务对话获取最原始的跟踪数据。这对于追求极致效率和自动化流程的开发者、测试工程师来说是一项必备技能。网络上关于adb shell和systemtrace的搜索热度一直很高也侧面印证了大家对这种“硬核”操作方式的需求。2. 核心工具链认识Perfetto与systrace的演进在深入命令之前必须理清Android性能跟踪工具的演进脉络否则很容易被新旧概念搞混。传统方案systrace.py (已过时)早期大致在Android 9之前我们主要使用systrace.py这个Python脚本。它位于Android SDK的platform-tools/systrace目录下。其本质是通过adb shell在设备端启动atrace进程来收集数据。将数据拉取到本地。调用systrace工具生成一个HTML报告。 这个流程依赖Python环境且功能相对固定扩展性差。命令形如python systrace.py gfx view sched freq -t 5。现代方案Perfetto (推荐)从Android 10开始Perfetto成为了Android平台官方的、统一的性能检测和跟踪框架旨在取代systrace。systemtrace现在通常指代由Perfetto框架生成的、以.perfetto-trace或.systrace为后缀的跟踪文件。它的优势在于统一性整合了内核跟踪ftrace、用户空间跟踪atrace、堆分析heapprofd等多种数据源。强大性支持更长的跟踪时间、更丰富的事件类型、自定义的跟踪配置。现代化提供了功能强大的Web UI (ui.perfetto.dev) 进行可视化分析远超旧版systrace HTML报告。我们通过adb shell捕获的正是Perfetto格式的跟踪数据。因此本文讨论的核心是现代Perfetto命令行工具的使用。3. 环境准备与前置检查在敲下任何命令之前确保你的环境是就绪的可以避免绝大多数“命令执行了却没效果”的坑。3.1 ADB环境与设备连接首先确保你的ADBAndroid Debug Bridge工作正常。安装/更新Platform-Tools从 Android开发者官网 下载最新的platform-tools包并确保其adb可执行文件路径已添加到系统的环境变量PATH中。连接设备使用USB线连接你的Android设备手机/平板/模拟器并开启设备的“开发者选项”和“USB调试”。授权连接在电脑终端执行adb devices。首次连接时设备屏幕会弹出RSA密钥指纹确认对话框点击“允许”。再次执行adb devices应看到设备序列号后显示device而不是unauthorized或offline。$ adb devices List of devices attached ABCDEF1234567890 device注意如果遇到unauthorized除了检查设备弹窗还可以尝试重启设备端的adb服务adb kill-server adb start-server。3.2 确认设备端的跟踪能力并非所有设备或系统版本都支持完整的Perfetto跟踪。我们需要检查两个关键服务。检查traced服务这是Perfetto的守护进程负责控制跟踪会话。adb shell ps -A | grep traced如果能看到traced相关的进程说明服务已运行。检查traced_probes服务这个服务负责从内核通过ftrace收集数据。adb shell ps -A | grep traced_probes同样应有相关进程存在。如果这两个服务不存在可能意味着你的设备系统版本较低早于Android 9或者设备制造商移除了相关组件。在这种情况下你可能只能使用功能受限的旧版atrace命令。3.3 获取Perfetto命令行工具Perfetto工具链包含一个强大的可执行文件perfetto用于从命令行配置和捕获跟踪。你有两种方式获取它从设备中提取推荐在Android 11及更高版本的设备上这个二进制文件通常存在于/system/bin/perfetto。我们可以直接通过adb shell调用它。adb shell which perfetto如果返回/system/bin/perfetto则工具已就位。从源码编译或下载预构建版本对于更复杂的需求或旧版系统你可以从 Perfetto的GitHub仓库 获取源码编译或直接下载预构建的二进制文件到本地然后通过adb push上传到设备并执行。但这通常只适用于高级用户或特定定制场景。4. 命令行捕获SystemTrace的三种实战姿势掌握了基础我们来进入实战环节。根据不同的复杂度和需求主要有三种使用方式。4.1 方式一使用内置的Trace配置预设这是最简单快捷的方式。Android系统内置了一些常用的跟踪配置预设我们可以直接通过perfetto命令触发。命令格式adb shell perfetto --txt --config-name[预设名称] --out/data/misc/perfetto-traces/trace_file.perfetto-trace关键参数解析--txt指示后面的--config-name参数引用的是内置的文本配置名。--config-name指定要使用的内置配置名。常用的有android.systrace相当于旧版systrace的默认配置包含调度、图形、系统服务等事件。android.camera针对相机管道的跟踪配置。android.graphics专注于图形和渲染事件。android.power与电源管理相关的事件。--out指定跟踪数据输出的文件路径。注意这个路径必须在设备上可写。/data/misc/perfetto-traces/是Perfetto服务默认使用的目录通常具有正确的权限。实战示例捕获一个10秒钟的systrace# 在设备后台启动一个跟踪会话持续10秒使用systrace预设输出到指定文件。 adb shell perfetto --txt --config-nameandroid.systrace --out/data/misc/perfetto-traces/trace_$(date %s).perfetto-trace --duration-ms10000--duration-ms10000设置跟踪持续时间为10000毫秒10秒。如果不指定跟踪会一直进行直到你手动中断CtrlC。trace_$(date %s).perfetto-trace使用Shell命令生成一个带时间戳的文件名避免覆盖。如何停止对于设置了--duration-ms的命令它会自动停止。对于未设置时长的命令你需要在终端中按下CtrlC来发送中断信号Perfetto会优雅地结束跟踪并写出文件。4.2 方式二使用自定义的Trace配置文本内置配置不能满足所有需求。Perfetto的强大之处在于其灵活的配置系统。你可以编写一个文本配置文件来精确控制要捕获哪些数据源Data Source。步骤1创建配置文件在电脑上创建一个文本文件例如my_trace_config.txt。内容如下duration_ms: 5000 # 跟踪5秒 buffers: { size_kb: 10240 # 缓冲区大小10MB fill_policy: DISCARD # 缓冲区满后丢弃旧数据 } data_sources: { config { name: linux.ftrace # 数据源Linux内核ftrace ftrace_config { ftrace_events: sched/sched_switch # 捕获进程调度切换事件 ftrace_events: sched/sched_wakeup ftrace_events: irq/irq_handler_entry ftrace_events: irq/irq_handler_exit ftrace_events: power/suspend_resume # 可以添加更多ftrace事件路径通常在 /sys/kernel/debug/tracing/events/ } } } data_sources: { config { name: android.systrace # 数据源Android系统层atrace android_systrace_config { # 启用特定的atrace类别与atrace命令的类别一致 atrace_categories: gfx # 图形 atrace_categories: view # 视图系统 atrace_categories: sched # CPU调度 atrace_categories: freq # 频率 # 其他常见类别wm(窗口管理), am(活动管理), dalvik(虚拟机), webview等 } } }这个配置同时抓取了内核层的调度、中断、电源事件以及用户层的图形、视图、调度和频率事件。步骤2将配置文件推送到设备adb push my_trace_config.txt /data/local/tmp/步骤3执行跟踪命令adb shell perfetto --config /data/local/tmp/my_trace_config.txt --out /data/misc/perfetto-traces/custom_trace.perfetto-trace这条命令会读取设备上的配置文件并按照配置进行5秒的跟踪。4.3 方式三使用预编译的Trace配置原型Proto Config这是功能最强大、也最推荐用于自动化脚本的方式。配置以二进制的protobuf格式定义可以通过Perfetto的Python API生成。步骤1编写Python脚本生成配置安装Perfetto的Python包pip install perfetto。 创建一个gen_config.py脚本#!/usr/bin/env python3 from perfetto.trace_processor import TraceProcessor from perfetto.trace_processor import TraceProcessorConfig from google.protobuf import text_format import perfetto.protos.PerfettoConfig_pb2 as PerfettoConfig import sys # 创建一个TraceConfig对象 config PerfettoConfig.TraceConfig() # 设置持续时间 config.duration_ms 8000 # 设置缓冲区 buff config.buffers.add() buff.size_kb 20480 # 20MB缓冲区 # 添加ftrace数据源 ds config.data_sources.add() ds.config.name linux.ftrace ftrace_cfg ds.config.ftrace_config ftrace_cfg.buffer_size_kb 2048 # 使用通配符添加所有sched和irq事件比逐一列举更简洁 ftrace_cfg.ftrace_events.append(sched/*) ftrace_cfg.ftrace_events.append(irq/*) # 添加atrace数据源 ds2 config.data_sources.add() ds2.config.name android.systrace atrace_cfg ds2.config.android_systrace_config atrace_cfg.categories.append(gfx) atrace_cfg.categories.append(view) atrace_cfg.categories.append(webview) # 添加WebView跟踪 # 将配置序列化为二进制文件 with open(/tmp/trace_config.pb, wb) as f: f.write(config.SerializeToString()) print(Config generated at /tmp/trace_config.pb)步骤2推送并执行# 在电脑上运行脚本生成配置文件 python3 gen_config.py # 推送配置文件到设备 adb push /tmp/trace_config.pb /data/local/tmp/ # 执行跟踪 adb shell perfetto --config /data/local/tmp/trace_config.pb --out /data/misc/perfetto-traces/proto_trace.perfetto-trace5. 跟踪文件的提取与可视化分析跟踪完成后文件保存在设备的/data/misc/perfetto-traces/目录下。我们需要将其拉取到本地进行分析。5.1 从设备拉取Trace文件# 先列出文件确认生成的文件名 adb shell ls -la /data/misc/perfetto-traces/ # 拉取文件到当前目录 adb pull /data/misc/perfetto-traces/trace_xxxx.perfetto-trace .注意有些设备可能需要root权限才能访问/data/misc/目录。如果没有root可以尝试将--out路径改为SD卡等用户可访问的目录例如--out/sdcard/trace.perfetto-trace。5.2 使用Perfetto UI进行可视化分析这是分析跟踪文件的最佳工具。打开浏览器访问 Perfetto UI 。点击左上角的“Open trace file”按钮。选择你刚从设备拉取下来的.perfetto-trace文件。Perfetto UI界面提供了时间线、计数器、切片详情、查询框等强大功能。你可以查看CPU频率和进程调度了解每个CPU核心上运行的线程及其状态运行R、可运行R、休眠S等。分析渲染帧查看SurfaceFlinger、应用渲染线程如RenderThread的活动定位掉帧Frame missed或帧耗时过长的原因。跟踪系统服务调用查看ActivityManager、WindowManager等服务的耗时。使用SQL查询在界面底部的“Query (SQL)”标签页中可以直接对跟踪数据运行SQL查询进行更灵活的分析。5.3 使用命令行工具进行初步解析如果你需要在服务器或无UI环境下自动化处理Trace可以使用trace_processor工具包含在Perfetto SDK中。# 假设你已经下载了 trace_processor 可执行文件 ./trace_processor --run-metrics android_startup --metrics-output json your_trace.perfetto-trace这条命令会运行一个名为android_startup的指标计算脚本并将结果以JSON格式输出可以用于自动化性能评分。6. 实战避坑指南与高级技巧掌握了基本操作后下面这些从实际项目中总结的经验和技巧能让你事半功倍避开常见的“坑”。6.1 权限问题与“/data/misc/perfetto-traces”目录这是最常见的障碍。当你执行命令后如果看到类似 “/data/misc/perfetto-traces/...: Permission denied” 的错误说明Perfetto服务没有权限写入该目录。根本原因traced服务通常以system或shell用户身份运行而/data/misc/perfetto-traces的目录权限可能设置不当。解决方案使用SD卡路径无需root这是最通用的方法。将--out参数指向SD卡路径。adb shell perfetto ... --out/sdcard/Download/my_trace.perfetto-trace之后用adb pull /sdcard/Download/my_trace.perfetto-trace .拉取。检查并修复目录权限需要root如果设备已root可以尝试修复目录权限。adb root # 获取root权限 adb shell chmod 0777 /data/misc/perfetto-traces/ # 谨慎操作仅用于测试使用run-as命令针对已调试的应用如果你跟踪的是自己开发的应用包名为com.example.myapp可以尝试将文件输出到应用沙盒内。adb shell run-as com.example.myapp perfetto --config ... --out /data/data/com.example.myapp/trace.pb然后通过adb shell run-as com.example.myapp cat /data/data/com.example.myapp/trace.pb local_trace.pb拉取。这种方法限制较多。6.2 跟踪数据不完整或事件缺失你打开了Perfetto UI却发现预期的调度事件或图形事件没有显示。可能原因1配置中未启用对应数据源或事件。仔细检查你的配置文件确保ftrace_events和atrace_categories包含了你想跟踪的类别。对于内核事件可以到设备的/sys/kernel/debug/tracing/events/目录下查看所有可用事件。可能原因2设备内核或系统未启用该跟踪点。有些设备制造商为了省电或稳定性会关闭部分ftrace事件。你可以尝试一个更宽泛的配置比如先只启用atrace_categories: “gfx”和ftrace_events: “sched/*”看看基础数据是否存在。可能原因3缓冲区大小不足。如果跟踪时间很长或事件非常密集默认的缓冲区可能被快速填满并丢弃旧数据如果fill_policy是DISCARD。尝试在配置中增加buffers.size_kb的值。6.3 长时间跟踪与定时自动化对于稳定性测试或性能监控我们需要进行长时间如半小时或定时的跟踪。长时间跟踪直接设置一个很大的duration_ms例如--duration-ms180000030分钟。务必同步增加缓冲区大小并考虑输出文件的大小可能达到GB级别。定时/循环跟踪可以结合Shell脚本和adb shell实现。例如一个每5分钟抓取10秒Trace的简单脚本#!/bin/bash for i in {1..12}; do # 循环12次总计1小时 timestamp$(date %Y%m%d_%H%M%S) echo Capturing trace $i at $timestamp adb shell perfetto --txt --config-nameandroid.systrace --out/sdcard/traces/trace_${timestamp}.perfetto-trace --duration-ms10000 sleep 300 # 等待5分钟300秒 done在执行此脚本前需要在设备上创建目录adb shell mkdir -p /sdcard/traces/。6.4 与其他调试工具的联动systemtrace不是孤立的它可以和别的工具产生联动提供更立体的视角。与Logcat结合在抓取Trace的同时另开一个终端窗口同步抓取Logcat日志并加上时间戳。adb logcat -v threadtime -b all logcat_$(date %s).txt分析时可以将Trace中的关键事件时间点如一次卡顿与Logcat中的错误或警告信息时间点进行对照快速定位问题根源。与dumpsys快照结合在Trace开始前和结束后分别执行adb shell dumpsys gfxinfo package_name reset和adb shell dumpsys gfxinfo package_name可以获取应用在跟踪期间渲染的帧统计信息Janky frames, Missed Vsync等与Trace中的帧数据相互印证。通过命令行捕获和分析SystemTrace是将性能优化工作从手动、随机的“碰运气”转向自动化、数据驱动的“精确定位”的关键一步。它要求你对Android系统和性能分析有更深的理解但带来的回报是极高的效率和问题排查的精准度。刚开始可能会觉得步骤繁琐但一旦形成脚本和流程它就会成为你工具箱中最锋利的一把刀。