3. perf sched record：记录调度事件的基本用法与参数

perf sched record 是 perf sched 子命令体系的数据采集入口，负责从内核捕获调度类事件并写入 perf.data 文件。采集数据的质量直接决定后续延迟计算与迁移分析的准确性。本节从基本用法、常用参数、事件选择与采样频率四个维度展开，帮助你在不同场景下正确配置记录命令。

3.1 基本用法与数据流

最简单的记录命令只需指定目标程序，perf sched 会自动选择一组默认的调度事件（包括 sched:sched_switch、sched:sched_wakeup、sched:sched_migrate_task 等）进行全量捕获：

# 记录当前系统所有调度事件（默认 -a 模式）
perf sched record

# 记录指定命令的调度事件
perf sched record -- sleep 10

# 记录并指定输出文件名
perf sched record -o my_sched.data -- stress --cpu 4 --timeout 5

下图展示了 perf sched record 从内核事件源到数据文件的完整数据流：

3.2 常用参数详解

perf sched record 继承了 perf record 的核心参数，同时针对调度场景做了优化。下表列出最常用的参数及其适用场景：

3.3 事件选择与自定义事件集

虽然 perf sched record 会自动选择默认事件集，但在某些场景下你需要精确控制捕获的事件类型。使用 -e 参数可以显式指定事件列表：

# 只捕获调度切换和唤醒事件
perf sched record -e sched:sched_switch,sched:sched_wakeup -a

# 捕获迁移事件（用于 CPU 迁移分析）
perf sched record -e sched:sched_migrate_task -a

# 捕获完整调度事件集（含等待和阻塞）
perf sched record -e sched:sched_switch,sched:sched_wakeup,\
sched:sched_wakeup_new,sched:sched_migrate_task,\
sched:sched_process_exec -a

下表列出与调度延迟和 CPU 迁移分析最相关的内核 tracepoint 事件：

3.4 采样频率与事件丢失

调度事件属于高频事件，尤其在多核系统上，每秒可能产生数十万甚至上百万个事件。如果采样频率设置不当，会导致事件丢失，进而影响延迟计算的准确性。

perf sched record 默认使用 无频率限制的全量捕获，即每个调度事件都会被记录。这与 perf record 的 -F（采样频率）参数不同——调度分析需要完整的事件序列才能计算延迟，因此通常不建议使用 -F 限制频率。

下表总结了不同场景下的参数推荐配置：

3.5 实战示例：组合参数使用

以下示例展示如何组合参数完成一次典型的调度延迟采集：

# 场景：分析 CPU 0-3 上 PID 为 1234 的进程调度延迟，带调用栈
perf sched record \
  -C 0-3 \
  -p 1234 \
  -g \
  -m 64 \
  -o sched_analysis.data \
  -- sleep 30

# 验证事件是否丢失
perf report -i sched_analysis.data --stats | grep -i lost

# 查看记录的事件总数
perf report -i sched_analysis.data --stats | head -20