第3章 录制卡顿Trace的三种方式与参数选择规则

卡顿排查的第一步是获取高质量的Trace数据。本章围绕“数据采集”阶段，系统讲解命令录制、代码插桩、系统跟踪三种方式及其参数选择规则。你将在实际定位卡顿时，根据问题场景快速选定正确的录制方案。

三种录制方式总览

方式一：命令录制

命令录制是最灵活的临场式采集方式。典型流程：连接设备 → 设置ATRACE标签 → 执行perfetto命令 → 复现问题 → 停止并拉取Trace。

基础命令模板

adb shell perfetto \
  -o /data/misc/perfetto-traces/card_issue.pb \
  -t 10s \
  -b 32mb \
  sched freq idle am wm gfx view input

参数含义

• -o：输出路径（必须写入可写分区，建议/data/misc/perfetto-traces/）
• -t：持续时长，卡顿场景建议10～30秒
• -b：缓冲区大小，复杂场景推荐32～64 MB
• 末尾为数据源，卡顿分析必须包含：sched（调度）、gfx（图形）、view（视图）、input（输入）

典型卡顿采集命令

adb shell perfetto \
  -o /data/misc/perfetto-traces/jank_test.pb \
  -t 15s \
  -b 64mb \
  sched freq idle am wm gfx view input

方式二：代码插桩

在应用关键路径（如点击响应、列表滑动、动画开始/结束）中嵌入Perfetto SDK的Trace开始/结束调用，实现“按需录制”。

集成要点

// 引入Perfetto SDK
#include "perfetto/tracing.h"

// 定义类别
PERFETTO_DEFINE_CATEGORIES(
    perfetto::Category("app.jank")
        .SetDescription("应用卡顿相关事件"),
    perfetto::Category("app.network")
        .SetDescription("网络请求"));

// 在需要录制的代码段中
TRACE_EVENT("app.jank", "UserClick", "button_id", buttonId);
// ... 实际业务逻辑 ...
TRACE_EVENT_END("app.jank");

参数选择规则

在代码中设置录制时长、缓冲区、数据源时，建议通过远程配置下发，避免硬编码：

// 动态启动Trace
perfetto::Tracing::Begin(
    perfetto::TraceConfig cfg;
    cfg.set_duration_ms(10000);
    cfg.add_buffers()->set_size_kb(32768);
    auto* ds = cfg.add_data_sources();
    ds->mutable_config()->set_name("track_event");
    // 可选：只采集当前进程
    ds->mutable_config()->set_target_buffer(0);
    // 开始录制
    TracingSession::Setup(cfg);
);

方式三：系统跟踪

系统跟踪用于排查无法在单一应用内复现的卡顿（如后台服务抢占、SystemUI响应延迟）。通过perfetto --background或开发者选项中的“系统跟踪”开启持续录制。

启动命令（后台模式）

adb shell perfetto \
  --background \
  -o /data/misc/perfetto-traces/long_trace.pb \
  -c /data/local/tmp/long_trace.cfg

配置文件示例（long_trace.cfg）

duration_ms: 300000  # 5分钟
buffers {
    size_kb: 65536
    fill_policy: RING_BUFFER
}
data_sources {
    config {
        name: "linux.syscalls"
    }
}
data_sources {
    config {
        name: "android.surfaceflinger.frametimeline"
    }
}
data_sources {
    config {
        name: "android.app.packages"
        target_buffer: 0
    }
}
# 只针对系统关键进程，减少体积
incremental_state_config {
    clear_period_ms: 5000
}

录制参数选择规则

故障树：选择正确的录制方式

以下决策树可帮助你在接到卡顿报告后，快速定位最合适的Trace采集路径：

排查清单：录制前的检查项

1. 确认设备已开启“开发者选项”和“USB调试”。
2. 检查存储空间：至少预留500 MB可用空间（避免Trace写入失败）。
3. 关闭不必要的后台进程（如游戏、高清视频播放），减少Trace中的噪音。
4. 根据卡顿现象选择正确的数据源（必选：sched, gfx, input；可选：freq, idle, am）。
5. 录制时长：尽量短（10～30秒），避免产生超大文件。
6. 若使用代码插桩，提前确认SDK版本与编译正确。