3. ftrace 环境准备：内核配置要求与系统检查

在开始使用 ftrace 进行内核函数调用跟踪与延迟分析之前，必须确保系统内核已正确配置并支持 ftrace 功能。本章将详细讲解内核编译选项、tracefs 文件系统的挂载方法，以及如何快速验证当前系统是否具备 ftrace 运行条件。

3.1 内核配置要求

ftrace 依赖于内核编译时开启的一系列跟踪相关选项。以下表格列出了核心配置项及其作用：

3.2 检查当前内核是否支持 ftrace

在开始配置之前，首先需要确认当前运行的内核是否已编译了 ftrace 支持。以下步骤可快速验证：

1. 检查内核配置文件：查看 /boot/config-$(uname -r) 或 /proc/config.gz 中是否包含 ftrace 相关选项。
2. 检查 tracefs 文件系统：ftrace 通过 tracefs 暴露控制接口，确认该文件系统是否可用。
3. 检查 debugfs 中的 tracing 目录：部分旧版本内核将 ftrace 接口放在 debugfs 下。

使用以下命令快速验证：

# 方法1：检查内核配置
zgrep CONFIG_FUNCTION_TRACER /proc/config.gz

# 方法2：查看 tracefs 是否已挂载
mount | grep tracefs

# 方法3：检查 debugfs tracing 目录是否存在（兼容旧内核）
ls /sys/kernel/debug/tracing/ 2>/dev/null && echo "debugfs tracing available"

如果上述命令返回 CONFIG_FUNCTION_TRACER=y 且 tracefs 已挂载，则说明系统已具备 ftrace 运行条件。

3.3 挂载 tracefs 文件系统

ftrace 的控制接口通过 tracefs 文件系统暴露，通常挂载在 /sys/kernel/tracing 目录下。如果系统未自动挂载，需要手动执行挂载操作。

3.3.1 自动挂载（推荐）

大多数现代 Linux 发行版会在系统启动时自动挂载 tracefs。验证方法：

# 检查 tracefs 挂载点
ls /sys/kernel/tracing/

如果该目录存在且包含 available_tracers、current_tracer 等文件，则说明已自动挂载。

3.3.2 手动挂载

若系统未自动挂载，可执行以下命令：

# 创建挂载点（如果不存在）
sudo mkdir -p /sys/kernel/tracing

# 挂载 tracefs
sudo mount -t tracefs tracefs /sys/kernel/tracing

# 验证挂载结果
mount | grep tracefs

3.4 ftrace 环境架构总览

下图展示了 ftrace 环境的核心组件及其关系：

3.5 验证 ftrace 功能是否正常

挂载 tracefs 后，通过以下步骤确认 ftrace 可正常工作：

1. 查看可用的跟踪器：

cat /sys/kernel/tracing/available_tracers

输出应包含 function 和 function_graph 等跟踪器名称。

2. 测试 function tracer：

# 切换到 function tracer
echo function > /sys/kernel/tracing/current_tracer

# 启动跟踪
echo 1 > /sys/kernel/tracing/tracing_on

# 等待几秒，产生一些跟踪数据
sleep 2

# 停止跟踪
echo 0 > /sys/kernel/tracing/tracing_on

# 查看跟踪结果（前20行）
head -20 /sys/kernel/tracing/trace

3. 测试 function_graph tracer：

# 切换到 function_graph tracer
echo function_graph > /sys/kernel/tracing/current_tracer

# 启动跟踪
echo 1 > /sys/kernel/tracing/tracing_on

# 产生一些内核活动
ls /dev/ > /dev/null

# 停止跟踪
echo 0 > /sys/kernel/tracing/tracing_on

# 查看调用图
head -30 /sys/kernel/tracing/trace

3.6 常见问题与排查

3.7 环境准备检查清单

完成本章学习后，请对照以下清单确认环境就绪：

• 内核已开启 CONFIG_FUNCTION_TRACER、CONFIG_FUNCTION_GRAPH_TRACER、CONFIG_DYNAMIC_FTRACE
• tracefs 已挂载到 /sys/kernel/tracing
• available_tracers 包含 function 和 function_graph
• 可成功切换跟踪器并读取 trace 输出
• 具备 root 权限或 sudo 执行能力