首次采集缓存相关的 Trace：选择 categories、buffer 大小、时长、adb 命令示例

1. 现象识别：何时需要采集缓存 Trace

在以下场景中，缓存命中率下降是核心嫌疑之一，应当立即启动首次 Trace 采集：

2. 数据采集：首次缓存 Trace 参数配置

首次采集的目标是“低成本、全覆盖” —— 用最少的 categories 捕获缓存关键事件，同时保证 buffer 不丢失数据。下面从四个维度逐一展开。

2.1 选择 Categories

下表列出与缓存命中率直接相关的 Perfetto 数据源和推荐类别：

2.2 配置 Buffer 大小

缓存事件产生频率极高（尤其是 PMU 事件），buffer 过小会提前截断。参考以下阈值：

2.3 设置采集时长

首次建议控制在 30 秒，覆盖 App 冷启动+首屏渲染+一次用户交互即可。后续可根据问题复现窗口调整：

• 30 秒：首次基线采集，风险最低。
• 60 秒：复测验证修复效果，覆盖更多执行路径。
• 120 秒：排查偶发性抖动，需要配合触发脚本。

2.4 adb 命令执行示例

下方命令使用 Perfetto 文本配置格式，同时启用 PMU 缓存事件和关键 ftrace 事件，输出到设备 /data/local/tmp/：

adb shell perfetto \
  -c - -o /data/local/tmp/cache_trace.perfetto \
  --txt << 'EOF'
buffers: {
  size_kb: 4096
}
data_sources: [
  {
    config {
      name: "linux.ftrace"
      ftrace_config {
        ftrace_events: "mm_page_alloc"
        ftrace_events: "mm_vmscan/mm_vmscan_lru_isolate"
        ftrace_events: "sched/sched_switch"
      }
    }
  },
  {
    config {
      name: "linux.perf_event"
      perf_event_config {
        timebase: {
          period: 1000
        }
        events: [
          {
            type: 0
            config: 0x2    # PERF_COUNT_HW_CACHE_REFERENCES
          },
          {
            type: 0
            config: 0x3    # PERF_COUNT_HW_CACHE_MISSES
          },
          {
            type: 0
            config: 0x0    # PERF_COUNT_HW_CPU_CYCLES (用于计算miss ratio)
          }
        ]
      }
    }
  }
]
duration_ms: 30000
flush_period_ms: 5000
EOF

3. 原因定位：首次采集后的数据有效性验证

采集完成后，将 Trace 文件 pull 到本地并用 Perfetto UI 打开，按以下规则快速判断数据是否可用：

4. 修复动作：调整采集参数

根据验证结果，对照下表进行针对性调整：

5. 复测：验证新配置

使用调整后的参数重新执行同一条 adb 命令，再次执行 原因定位 中的验证项。重点确认：

• PMU 事件覆盖整个时长（而非仅开头几秒）。
• 缓存未命中率（misses / references）在问题时段有明显波动。
• ftrace 事件包含 2～3 次完整的 mm 操作序列。

6. 预防：建立标准采集模板

将已验证的配置保存为 cache_first_trace.cfg，纳入团队工具库。以后每次缓存问题排查都以此模板为起点，避免重复调参：

# cache_first_trace.cfg  —— 首次缓存 Trace 标准模板
buffers: {
  size_kb: 4096
}
data_sources: [
  {
    config {
      name: "linux.ftrace"
      ftrace_config {
        ftrace_events: "mm_page_alloc"
        ftrace_events: "sched/sched_switch"
      }
    }
  },
  {
    config {
      name: "linux.perf_event"
      perf_event_config {
        timebase: { period: 1000 }
        events: [
          { type: 0 config: 0x2 }
          { type: 0 config: 0x3 }
          { type: 0 config: 0x0 }
        ]
      }
    }
  }
]
duration_ms: 30000
flush_period_ms: 5000

每次复用模板时，只需修改 duration_ms 和 size_kb 即可适配不同场景。