📚 课程目录第3章 Ftrace内核配置

3. Ftrace 内核配置：Kernel hacking 中的关键选项

Ftrace 作为内核内置的跟踪器，其功能高度依赖于内核编译时的配置选项。在 make menuconfig 的 Kernel hacking 菜单下，集中了所有与 Ftrace 相关的开关。正确理解并启用这些选项，是使用 Ftrace 进行性能分析的前提。

3.1 核心配置选项总览

以下表格列出了 Ftrace 功能依赖的核心配置项，以及它们各自的作用域和依赖关系：

配置宏	菜单路径 (Kernel hacking)	功能描述	依赖关系
`CONFIG_FTRACE`	Tracers	Ftrace 总开关，必须启用才能使用任何跟踪功能	无
`CONFIG_FUNCTION_TRACER`	Tracers → Function Tracer	启用函数调用跟踪，记录内核函数的进入和退出	依赖 `CONFIG_FTRACE`
`CONFIG_DYNAMIC_FTRACE`	Tracers → Dynamic Ftrace	动态插桩，允许运行时选择跟踪哪些函数，降低性能开销	依赖 `CONFIG_FUNCTION_TRACER`
`CONFIG_FUNCTION_GRAPH_TRACER`	Tracers → Function Graph Tracer	以调用图形式显示函数调用链，包含执行时间	依赖 `CONFIG_FUNCTION_TRACER`
`CONFIG_STACK_TRACER`	Tracers → Stack Tracer	跟踪内核栈使用情况，用于检测栈溢出	依赖 `CONFIG_FTRACE`
`CONFIG_IRQSOFF_TRACER`	Tracers → Interrupts Off Tracer	跟踪中断关闭的时长，用于分析系统实时性	依赖 `CONFIG_FTRACE`
`CONFIG_PREEMPT_TRACER`	Tracers → Preemption Off Tracer	跟踪抢占关闭的时长，用于分析调度延迟	依赖 `CONFIG_FTRACE`

配置建议： 在开发或调试内核时，建议将上述所有选项均设为 Y（编译进内核）。在生产环境中，可根据需要仅启用 CONFIG_FTRACE 和 CONFIG_FUNCTION_TRACER，以最小化性能影响。

3.2 CONFIG_FUNCTION_TRACER：函数跟踪的基石

CONFIG_FUNCTION_TRACER 是 Ftrace 最核心的功能之一。启用后，编译器会在每个内核函数的入口处插入一段 5 字节的 NOP 指令（在 x86 架构上为 call __fentry__ 的占位符）。当跟踪激活时，这些 NOP 指令会被动态替换为跳转到 Ftrace 回调函数的指令。

该选项直接影响以下能力：

函数调用计数： 统计每个函数被调用的次数。
函数调用栈： 记录当前进程的函数调用路径。
函数执行时间： 配合 function_graph 跟踪器，测量函数执行耗时。

  性能开销说明： 即使不启用任何跟踪器，CONFIG_FUNCTION_TRACER 也会在编译时引入额外的 mcount 调用（或 __fentry__）。虽然现代内核通过 DYNAMIC_FTRACE 将其优化为 NOP，但理论上仍存在极小的指令缓存影响。在极端性能敏感的场景下，可考虑关闭此选项。

3.3 CONFIG_DYNAMIC_FTRACE：动态插桩与性能优化

CONFIG_DYNAMIC_FTRACE 是 Ftrace 实现低开销的关键技术。它允许内核在运行时动态地启用或禁用对特定函数的跟踪，而无需重新编译内核或重启系统。

其工作原理分为两个阶段：

编译阶段： 所有函数入口处仍然保留 __fentry__ 占位符。
运行时阶段： 内核维护一张 ftrace 函数哈希表。当用户通过 set_ftrace_filter 添加某个函数时，内核会将该函数入口处的 NOP 指令修改为跳转到 Ftrace 回调的指令；当移除该函数时，再将其恢复为 NOP。

下图展示了动态插桩的运行时状态切换流程：

注意事项： 动态插桩依赖于内核的代码修改能力。在 RO 内核代码段保护（如 CONFIG_STRICT_KERNEL_RWX）开启的情况下，Ftrace 需要依赖 patch_text 机制来临时禁用写保护。如果该机制失效，动态插桩将无法正常工作。

3.4 其他关键配置选项

除了上述两个核心选项，以下配置在中断上下文分析和函数调用链追踪中同样重要：

CONFIG_FUNCTION_GRAPH_TRACER：提供可视化的函数调用图，显示每个函数的进入、退出和执行时间。对于分析中断处理函数（如 handle_irq）的调用链尤为有用。
CONFIG_IRQSOFF_TRACER：专门用于跟踪中断被关闭的时间段。在实时系统或驱动开发中，过长的关中断时间会导致调度延迟。
CONFIG_PREEMPT_TRACER：跟踪内核抢占被关闭的时间。与 IRQSOFF_TRACER 配合使用，可以全面分析系统的实时性瓶颈。
CONFIG_STACK_TRACER：记录内核栈的使用峰值。在中断嵌套较深的场景中，可以帮助检测栈溢出风险。

3.5 配置验证与检查

在已运行的内核上，可以通过以下命令快速验证当前系统是否启用了相关配置：

# 检查 Ftrace 总开关
zcat /proc/config.gz | grep CONFIG_FTRACE

# 检查函数跟踪器
zcat /proc/config.gz | grep CONFIG_FUNCTION_TRACER

# 检查动态插桩
zcat /proc/config.gz | grep CONFIG_DYNAMIC_FTRACE

# 检查是否支持 function_graph
zcat /proc/config.gz | grep CONFIG_FUNCTION_GRAPH_TRACER

如果 /proc/config.gz 不存在，可以尝试从 /boot 目录下查找 config-$(uname -r) 文件：

cat /boot/config-$(uname -r) | grep CONFIG_FTRACE

快速判断： 如果 /sys/kernel/debug/tracing/available_tracers 文件中包含 function 和 function_graph，则说明 CONFIG_FUNCTION_TRACER 和 CONFIG_FUNCTION_GRAPH_TRACER 均已启用。

3.6 配置选项之间的依赖关系图

以下 SVG 图展示了 Ftrace 核心配置选项之间的依赖层级，帮助理解哪些选项是基础，哪些是扩展：

3.7 常见配置问题与排查

现象	可能原因	解决方案
`available_tracers` 中缺少 `function`	`CONFIG_FUNCTION_TRACER` 未启用	重新编译内核，启用该选项
`set_ftrace_filter` 写入失败	`CONFIG_DYNAMIC_FTRACE` 未启用	检查内核配置，确保动态插桩已开启
跟踪数据为空或异常	内核代码段写保护导致动态修改失败	检查 `dmesg` 中是否有 `ftrace: failed to modify` 错误
系统启动时 Ftrace 相关日志缺失	内核启动参数 `ftrace=` 未正确设置	在 GRUB 中添加 `ftrace=function` 等参数

  内核编译建议： 在 make menuconfig 中，建议将 Kernel hacking → Tracers → Enable ftrace with dynamic tracing 设置为 [*]。同时，为了支持函数图跟踪，确保 Kernel hacking → Tracers → Kernel Function Graph Tracer 也被选中。这些选项共同构成了 Ftrace 驱动性能分析的基础设施。