📚 课程目录第3章 Ftrace简介

3. Ftrace 简介：架构、文件系统与追踪器

Ftrace（Function Tracer）是 Linux 内核内置的追踪框架，专为性能调优与内核行为分析设计。它无需加载外部模块，即可在几乎零开销（静态插桩）或极低开销（动态插桩）下捕获内核函数调用、中断上下文切换、调度延迟等关键指标。本章从架构、文件系统与追踪器三个维度建立 Ftrace 的完整认知。

  核心要点：Ftrace 基于 tracefs 虚拟文件系统暴露控制接口，通过 静态插桩（tracepoint）与 动态插桩（kprobe/uprobe/fgraph）实现不同粒度的追踪，所有数据最终汇聚到内核环形缓冲区。

3.1 Ftrace 整体架构

Ftrace 采用分层设计，从上到下依次为：用户态接口层、追踪引擎层、插桩层与数据存储层。各层职责清晰，便于扩展。

架构启示：Ftrace 的插桩层与引擎层解耦，使得添加新的追踪器（如 osnoise、timerlat）时无需修改底层环形缓冲区逻辑。调优时，应优先关注插桩层开销（动态插桩 > 静态插桩），再调整引擎层的过滤与触发条件。

3.2 tracefs 文件系统

Ftrace 通过 tracefs 虚拟文件系统暴露控制接口，默认挂载在 /sys/kernel/tracing/（旧内核为 /sys/kernel/debug/tracing/）。以下为调优中最常操作的接口文件：

文件/目录	类型	功能说明	调优场景
`available_tracers`	只读	列出当前内核支持的追踪器列表	确认内核编译选项是否开启所需追踪器
`current_tracer`	读写	设置/查看当前激活的追踪器	切换追踪器（如 `function` → `function_graph`）
`tracing_on`	读写	全局开关（1=开启追踪，0=暂停）	减少追踪对性能的影响
`trace`	只读	输出当前环形缓冲区中的追踪结果	实时查看追踪数据
`trace_pipe`	只读	流式输出追踪结果（阻塞读取）	持续监控中断上下文行为
`set_ftrace_filter`	读写	设置函数过滤白名单（支持通配符）	只追踪目标函数，降低开销
`set_ftrace_notrace`	读写	设置函数过滤黑名单	排除高频无意义函数
`buffer_size_kb`	读写	设置每个 CPU 的环形缓冲区大小（KB）	避免高频中断追踪时数据丢失
`per_cpu/`	目录	每个 CPU 独立的追踪统计与缓冲区	分析特定 CPU 的中断分布

性能警告：在中断上下文调优时，buffer_size_kb 设置过小会导致高频中断事件丢失；设置过大（如 > 10MB）会占用大量内存并增加 TLB 压力。建议根据中断频率动态调整，通常 4~8 MB 可满足大多数场景。

3.3 Ftrace 追踪器种类

Ftrace 内置多种追踪器（tracer），按追踪粒度与用途可分为以下三类：

3.3.1 函数追踪类

function：记录每个内核函数的进入事件，输出函数名与时间戳。开销较低，适合定位高频调用函数。
function_graph：记录函数调用链（进入/返回），显示嵌套层级与执行耗时。是中断上下文调优的核心工具，可直观看到中断处理函数内部调用了哪些子函数。

3.3.2 延迟追踪类

irqsoff：追踪关中断（local_irq_disable）的最大持续时间，直接反映中断响应延迟的上限。
preemptoff：追踪抢占关闭的最大持续时间，影响实时任务的调度延迟。
wakeup / wakeup_rt：测量高优先级任务从唤醒到获得 CPU 的最大延迟，适用于实时系统调优。

3.3.3 事件追踪类

hwlat：通过硬件计数器检测 CPU 被 SMI（系统管理中断）或 C-state 延迟“偷走”的时间。
osnoise：测量操作系统噪声（OS noise），包括中断、调度、RCU 等对用户态线程的干扰。
timerlat：专门测量定时器中断响应延迟，精度可达纳秒级。

  调优选择建议：对于中断上下文性能调优，推荐按以下顺序使用追踪器：

先用 function_graph 定位中断处理函数的热路径；

再用 irqsoff 测量关中断时间是否超标；

最后用 osnoise 排除硬件/固件层面的干扰。

3.4 追踪器对比速查表

追踪器	插桩类型	开销等级	主要输出	中断调优用途
`function`	动态	低	函数名 + 时间戳	定位高频调用函数
`function_graph`	动态	中	函数调用链 + 耗时	分析中断处理函数内部调用路径
`irqsoff`	静态+动态	低	关中断最大延迟 + 调用栈	测量中断响应延迟上限
`preemptoff`	静态+动态	低	关抢占最大延迟 + 调用栈	评估调度延迟
`osnoise`	静态	极低	噪声源分布 + 时间线	检测硬件/固件干扰
`timerlat`	静态	极低	定时器延迟直方图	测量定时器中断响应

开销说明：动态插桩（function、function_graph）需要在函数入口写入跳转指令（mcount/nop），首次启用时有少量开销；静态插桩（tracepoint）在编译时已埋点，运行时几乎无额外开销。在中断上下文调优时，优先使用静态插桩类追踪器，避免引入过多测量噪声。

3.5 快速验证：查看当前内核支持的追踪器

在目标系统上执行以下命令，确认 Ftrace 功能是否正常：

# 挂载 tracefs（如未自动挂载）
mount -t tracefs tracefs /sys/kernel/tracing/

# 查看支持的追踪器列表
cat /sys/kernel/tracing/available_tracers

# 示例输出（不同内核版本有差异）：
# hwlat blk mmiotrace function_graph wakeup_dl wakeup_rt wakeup function nop

若输出中包含 function_graph 和 irqsoff，说明当前内核已具备中断上下文调优所需的核心追踪能力。若缺少，需重新编译内核并开启 CONFIG_FUNCTION_GRAPH_TRACER 和 CONFIG_IRQSOFF_TRACER。