Perfetto 翻译第四篇-快速入门-android 平台入门-抓取trace

前言：虽然有翻译软件，虽然有chatgpt,毕竟语言隔阂，对这个工具还是一知半解，因此想通过翻译的方式和大家来一起学习下Perfetto这个强大的工具

目录

#####################以下分割线#####################

英文原文在这里
Perfetto可以从各种数据源（通过ftrace的内核调度程序、通过atrace的用户空间instrumentation以及本网站中列出的所有其他数据源）收集安卓设备的系统范围性能trace。

开启tracing service

Perfetto基于自Android 9（P）以来的系统service，但默认情况下仅自Android 11（R）以来启用。在Android 9（P）和10（Q）上，您需要执行以下操作，以确保在开始之前开启tracing service：

# Needed only on Android 9 (P) and 10 (Q) on non-Pixel phones.
adb shell setprop persist.traced.enable 1

如果Android版本早于P，您仍然可以使用record_Android_trace脚本使用Perfetto来抓取trace。请参阅下面通过cmdline抓取trace的说明。

抓取trace

命令行工具

1 使用 tools/record_android_trace 直接抓取

2 直接使用 /system/bin/perfetto 命令抓取参考这里

可视化抓取工具

1 通过Perfetto UI的抓取界面

2 使用设备上的System Tracing App

使用Perfetto UI抓取trace

打开ui.perfetto.dev这个网址，然后从左侧菜单中选择Record new trace。在此页面中，选择并打开需要trace的数据源。有关不同数据源的更多详细信息，请参阅文档的数据源部分。

1.png

如果不确定抓取数据源，请先打开“CPU”选项卡下的“调度详细信息”。

首先需要确保设备已连接，然后选择“添加ADB设备”。一旦设备成功配对（可能需要允许在设备上进行USB调试），请点击“开始录制”按钮。

等待trace抓取完成（默认为10秒），然后就可以看到trace出现。

2.png

如果选择的数据源不同，收集到的trace也会不一样。

使用命令行抓取trace

前提

通过命令行抓取，需要系统变量Path中包含了adb可执行文件的路径。适用于Linux、Mac或Windows的ADB二进制文件可以从https://developer.android.com/studio/releases/platform-tools这里下载。

使用helper脚本

我们建议使用tools/record_android_trace 这个脚本从命令行记录跟踪。这相当于运行adb shell perfetto，但它有助于获得正确的路径，完成后拉取trace并在浏览器上打开它。此外，在旧版本的Android上，它负责sideloading tracebox二进制文件，以弥补tracing系统服务的不足。

如果您已经熟悉systrace或atrace，那么这两个cmdline工具都支持与systrace等效的语法：

Linux 和 Mac:

curl -O https://raw.githubusercontent.com/google/perfetto/master/tools/record_android_trace
chmod u+x record_android_trace

# See ./record_android_trace --help for more
./record_android_trace -o trace_file.perfetto-trace -t 10s -b 32mb \
sched freq idle am wm gfx view binder_driver hal dalvik camera input res memory

Windows

curl -O https://raw.githubusercontent.com/google/perfetto/master/tools/record_android_trace
python3 record_android_trace -o trace_file.perfetto-trace -t 10s -b 32mb \
sched freq idle am wm gfx view binder_driver hal dalvik camera input res memory

使用设备上的/system/bin/perfetto命令

如果你想直接直接设备上的perfetto命令

adb shell perfetto -o /data/misc/perfetto-traces/trace_file.perfetto-trace -t 20s \
sched freq idle am wm gfx view binder_driver hal dalvik camera input res memory

直接使用adb shell perfetto的注意事项：

Ctrl+C通常会导致trace的终止，但在使用ADB shell perfetto时，ADB一般不会响应Ctrl+C，只在使用 PTY-based 的交互式会话时相应Ctrl+C

1 在安卓12之前的非root设备上，由于SELinux规则过于严格，配置只能作为cat config|adb shell perfetto-c（-：stdin）的方式传递。在Android 12上/data/misc/perfetto-configs可以用于存储配置。

2 在Android 10之前的设备上，adb无法直接提取/data/misc/perfetto-traces。使用adb-shell cat/data/misc/perfetto-traces/trace>trace将perfetto-traces从手机上复制出来。

3 当捕获较长的traces时，例如在基准测试或CI的上下文中，使用PID=PID来停止。

Full trace config

简单的命令仅启用部分数据源；要完全控制trace的配置，请在输入中传递完整的trace配置。

有关如何配置Perfetto的所有各种选项的详细说明，请参阅trace 配置界面和每个数据源文档页面中的示例。

如果在Mac或Linux主机上运行，或者在Windows上使用基于bash的终端，则可以使用以下方法：

提示：以下的命令参数在Android P是不能运行的，因为--txt 参数是Android Q版本引入的。在Android P上应该使用protobuf 格式的二进制格式。详细信息在trace 配置界面

cat<<EOF>config.pbtx
duration_ms: 10000

buffers: {
    size_kb: 8960
    fill_policy: DISCARD
}
buffers: {
    size_kb: 1280
    fill_policy: DISCARD
}
data_sources: {
    config {
        name: "linux.ftrace"
        ftrace_config {
            ftrace_events: "sched/sched_switch"
            ftrace_events: "power/suspend_resume"
            ftrace_events: "sched/sched_process_exit"
            ftrace_events: "sched/sched_process_free"
            ftrace_events: "task/task_newtask"
            ftrace_events: "task/task_rename"
            ftrace_events: "ftrace/print"
            atrace_categories: "gfx"
            atrace_categories: "view"
            atrace_categories: "webview"
            atrace_categories: "camera"
            atrace_categories: "dalvik"
            atrace_categories: "power"
        }
    }
}
data_sources: {
    config {
        name: "linux.process_stats"
        target_buffer: 1
        process_stats_config {
            scan_all_processes_on_start: true
        }
    }
}
EOF

./record_android_trace -c config.pbtx -o trace_file.perfetto-trace 

如果直接在设备上使用perfetto命令

cat config.pbtx | adb shell perfetto -c - --txt -o /data/misc/perfetto-traces/trace.perfetto-trace

也可以先推送config 文件，再执行perfetto命令

adb push config.pbtx /data/local/tmp/config.pbtx
adb shell 'cat /data/local/tmp/config.pbtx | perfetto --txt -c - -o /data/misc/perfetto-traces/trace.perfetto-trace'

提示：由于严格的SELinux规则，在Android的非root版本上，直接将文件路径传递为-c/data/local/tmp/config将失败，因此上面使用了-c-+stdin管道。在Android 12（S）中，可以使用/data/misc/perfetto-configs/。

然后使用adb pull /data/misc/perfetto-traces/trace ~/trace.perfetto-trace 命令从手机上拷贝出来，最后在Perfetto UI界面打开。

完整的perfetto命令行参数可以在这里找到

#####################以上分割线#####################

后记：
1 本次主要使用百度翻译，虽然被骂，但至少翻译这个工具降低了门槛。
2 英文文档中的长难句真的是又长又难，基于百度的翻译，然后自己再调整下，水平实在有限。
3 技术背景知识不够，有些专有名词不知道怎么翻译，也不知道百度翻译的是否准确，功夫在诗外。
4 万事开头难，中间难不难，还不知道。中间的事后面再说，正确一天翻译一篇。
5 虽然可能会有人不屑，但总要有人去做不起眼的小事。
6 google 厉害，这个perfetto 工具也很厉害。君子善假于物也。
7 工具的使用是最简单的入门，背后还有更多的东西值得学习。
8 水平实在有限，闻过则喜，希望有更多的人反馈，期待更好的建议