📚 课程目录第4章 ftrace架构概览

4. ftrace 架构概览：框架组成、tracefs 文件系统与环形缓冲区

ftrace 是 Linux 内核内置的跟踪基础设施，用于捕获内核函数调用、调度事件、中断上下文切换等运行时信息。理解 ftrace 的架构是进行调度延迟分析的前提。本章从框架组成、用户态接口（tracefs）和核心数据存储（环形缓冲区）三个维度展开。

4.1 ftrace 框架组成

ftrace 采用分层设计，从上到下依次为：用户态接口层、核心管理层、跟踪器层和事件源层。各层职责清晰，便于扩展。

  架构要点： ftrace 不依赖外部模块，所有组件均内置于内核；通过 tracefs 文件系统暴露控制接口，用户无需编写内核代码即可启用/禁用跟踪。

4.2 tracefs 文件系统

tracefs 是 ftrace 的用户态控制面，挂载点通常为 /sys/kernel/tracing（旧内核为 /debug/tracing）。通过读写该目录下的文件，用户可控制跟踪器、设置过滤器、读取跟踪数据。

4.2.1 核心控制文件

文件	功能	典型操作
`available_tracers`	列出当前内核支持的跟踪器	`cat available_tracers`
`current_tracer`	设置/查看当前激活的跟踪器	`echo function > current_tracer`
`tracing_on`	全局跟踪开关（1 开 / 0 关）	`echo 1 > tracing_on`
`trace`	读取环形缓冲区中的跟踪输出	`cat trace`
`trace_pipe`	阻塞式读取跟踪流（类似 tail -f）	`cat trace_pipe`
`set_ftrace_filter`	按函数名过滤跟踪目标	`echo schedule > set_ftrace_filter`
`set_ftrace_pid`	按 PID 过滤跟踪目标	`echo 1234 > set_ftrace_pid`
`buffer_size_kb`	设置每个 CPU 的环形缓冲区大小	`echo 4096 > buffer_size_kb`

实践建议： 在分析调度延迟时，通常先设置 current_tracer = wakeup 或 wakeup_rt，然后通过 set_ftrace_pid 锁定目标进程 PID，减少无关噪声。

4.2.2 典型操作流程

挂载 tracefs（如未自动挂载）：mount -t tracefs nodev /sys/kernel/tracing
查看可用跟踪器：cat /sys/kernel/tracing/available_tracers
选择跟踪器：echo wakeup > /sys/kernel/tracing/current_tracer
设置过滤器：echo __schedule > /sys/kernel/tracing/set_ftrace_filter
清空缓冲区：echo > /sys/kernel/tracing/trace
开启跟踪：echo 1 > /sys/kernel/tracing/tracing_on
等待事件发生（运行目标负载）
关闭跟踪：echo 0 > /sys/kernel/tracing/tracing_on
读取结果：cat /sys/kernel/tracing/trace

4.3 trace 环形缓冲区

环形缓冲区是 ftrace 的核心数据存储结构，采用 per-CPU 设计，每个 CPU 拥有独立的缓冲区实例。这种设计避免了多核竞争锁，保证了高并发场景下的写入性能。

4.3.1 缓冲区结构

per-CPU 实例：每个 CPU 对应一个 trace_array，内部包含 ring_buffer 结构。
固定大小：默认缓冲区大小可通过 buffer_size_kb 调整，单位为 KB/CPU。
覆盖模式：当缓冲区写满时，新数据覆盖最旧的数据（默认行为）。
原子写入：跟踪事件通过 trace_buffer_lock_reserve / trace_buffer_unlock_commit 原子操作写入。

4.3.2 缓冲区关键参数

参数	默认值	影响	调整建议
`buffer_size_kb`	1408 (per CPU)	决定可保存的事件数量	调度延迟分析建议 4096~8192
`trace_entries`	自动计算	最大事件条目数	通常无需手动设置
`overwrite`	1 (开启)	满时覆盖旧数据	关闭可防止丢失早期事件，但可能阻塞写入

4.3.3 读取与解析

通过 cat trace 读取时，ftrace 会从所有 per-CPU 缓冲区中收集事件，并按时间戳全局排序后输出。每条跟踪记录包含以下字段：

# tracer: wakeup
#
#           TASK-PID    CPU#    TIMESTAMP  FUNCTION
#              | |       |          |         |
          kworker/0:1-14    [000]   123.456789:  __schedule <- worker_thread
          swapper/0-0       [000]   123.456790:  __schedule <- schedule_idle
          my_app-1234       [001]   123.456800:  __schedule <- schedule

注意事项： 高频率跟踪（如 function 跟踪器）会迅速填满缓冲区。若 buffer_size_kb 设置过小，可能导致关键调度事件被覆盖。建议在分析前先通过 echo 0 > tracing_on 停止跟踪，再读取数据。

4.4 本章小结

ftrace 采用四层架构：用户态接口 → 核心管理 → 跟踪器 → 事件源。
tracefs 提供 /sys/kernel/tracing/ 下的控制文件，是操作 ftrace 的唯一入口。
环形缓冲区采用 per-CPU 设计，避免锁竞争，支持覆盖模式和大小动态调整。
掌握 current_tracer、set_ftrace_filter、tracing_on 和 trace 四个核心文件即可完成大部分调度延迟跟踪任务。