4. Ftrace框架入门：Ftrace架构、tracefs文件系统、基本使用流程

Ftrace（Function Tracer）是Linux内核内置的追踪框架，专为性能分析和调试设计。在PREEMPT_RT调优场景中，Ftrace是验证调度延迟、中断响应和临界区行为的关键工具。本节从架构、文件系统和基本操作三个维度建立Ftrace的使用基础。

4.1 Ftrace整体架构

Ftrace采用分层设计，从上到下依次为：用户态接口层、核心框架层、追踪器层和事件源层。各层职责清晰，通过回调函数和环形缓冲区串联数据流。

4.2 tracefs文件系统

tracefs是Ftrace的用户态接口，挂载后提供一组虚拟文件用于控制追踪行为、读取追踪数据和配置过滤器。在大多数现代发行版中，tracefs自动挂载于 /sys/kernel/tracing；若未自动挂载，可手动操作。

4.2.1 挂载tracefs

# 检查是否已挂载
mount | grep tracefs

# 手动挂载到标准路径
mount -t tracefs tracefs /sys/kernel/tracing

# 或挂载到自定义路径（不推荐，工具默认路径为 /sys/kernel/tracing）
mount -t tracefs tracefs /mytrace

4.2.2 核心控制文件一览

tracefs下包含数十个控制文件，以下列出调优PREEMPT_RT时最常用的文件：

4.3 基本使用流程

Ftrace的标准操作流程遵循“挂载 → 选择追踪器 → 设置过滤器 → 启用追踪 → 采集数据 → 停止追踪 → 读取分析”的闭环。以下以function_graph追踪器为例演示完整步骤。

4.3.1 步骤一：确认环境

# 确认tracefs已挂载
ls /sys/kernel/tracing/current_tracer

# 查看可用追踪器列表
cat /sys/kernel/tracing/available_tracers

输出示例（PREEMPT_RT内核典型输出）：

function function_graph wakeup_dl wakeup_rt wakeup preemptirqsoff preemptoff irqsoff nop

4.3.2 步骤二：选择追踪器并配置

# 切换到 function_graph 追踪器
echo function_graph > /sys/kernel/tracing/current_tracer

# 设置只追踪特定函数（例如调度相关函数）
echo "schedule*" > /sys/kernel/tracing/set_ftrace_filter

# 设置追踪深度（可选，默认无限制）
echo 10 > /sys/kernel/tracing/max_graph_depth

4.3.3 步骤三：启用追踪并采集数据

# 清空历史追踪数据
echo 0 > /sys/kernel/tracing/trace

# 启用追踪
echo 1 > /sys/kernel/tracing/tracing_on

# 执行目标负载（例如触发一次调度延迟）
# 此处模拟一个实时线程调度操作
chrt -f 50 sleep 0.01

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

4.3.4 步骤四：读取追踪结果

# 读取完整追踪数据
cat /sys/kernel/tracing/trace

# 或使用 trace_pipe 实时流式读取（阻塞，适合持续监控）
cat /sys/kernel/tracing/trace_pipe

输出片段示例：

# tracer: function_graph
#
# CPU  DURATION                  FUNCTION CALLS
# |     |   |                     |   |   |   |
 0)   0.125 us    |  __schedule();
 0)   0.250 us    |    dequeue_task();
 0)   0.375 us    |      dequeue_task_fair();
 0)   0.500 us    |        update_curr();
 0)   0.625 us    |          update_min_vruntime();
 0)   0.750 us    |    pick_next_task_fair();
 0)   0.875 us    |      set_next_entity();
 0)   1.000 us    |    context_switch();

4.4 使用流程可视化

以下SVG图总结了Ftrace从挂载到分析的标准操作流程，适用于PREEMPT_RT调优场景。

4.5 常见问题与避坑

• 追踪数据为空：检查 tracing_on 是否为1，确认 current_tracer 不是 nop，验证 set_ftrace_filter 未过度过滤。
• 环形缓冲区溢出：默认缓冲区较小（约1-2MB），可通过 buffer_size_kb 文件调整大小，例如 echo 8192 > buffer_size_kb。
• 性能开销：function_graph追踪器对系统性能影响较大（约5-20%），生产环境慎用；建议使用 tracing_thresh 只记录超过阈值的延迟事件。
• 权限问题：tracefs文件默认仅root可读写；非root用户需通过 chmod 或 sudo 提权，或配置 sysctl kernel.tracepoint_printk=1。