📚 课程目录第3章 ftrace基础

3. ftrace 基础：tracefs 文件系统与核心文件结构

ftrace 是 Linux 内核内置的跟踪器，其用户态接口通过 tracefs 伪文件系统暴露。理解 tracefs 的挂载点、目录布局和核心文件语义，是使用 ftrace 定位网络性能瓶颈的第一步。本章将深入剖析 tracefs 的结构，并解释每个关键文件的作用。

3.1 tracefs 文件系统概述

tracefs 是一个仅存在于内存中的文件系统，通常在 /sys/kernel/tracing 或 /sys/kernel/debug/tracing 路径下挂载。它不存储持久化数据，而是通过读写文件来动态控制内核跟踪引擎的行为。

挂载路径	说明	推荐使用
`/sys/kernel/tracing`	独立挂载 tracefs，不依赖 debugfs	✅ 首选路径（Linux 4.0+）
`/sys/kernel/debug/tracing`	通过 debugfs 挂载的旧路径	⚠️ 兼容旧内核

检查挂载： 使用 mount | grep tracefs 确认当前系统挂载点。若未挂载，执行 mount -t tracefs tracefs /sys/kernel/tracing。

3.2 核心文件结构总览

tracefs 根目录下包含数十个控制文件和缓冲区文件。下图展示了与网络性能调试最相关的核心文件及其层级关系。

3.3 核心文件详解

3.3.1 跟踪器控制文件

文件	权限	功能描述	网络调试典型值
`available_tracers`	只读	列出当前内核支持的所有跟踪器	`function function_graph nop`
`current_tracer`	读写	设置或查看当前激活的跟踪器	`function_graph`
`set_ftrace_filter`	读写	白名单：只跟踪匹配的函数	`tcp_v4_*`
`set_ftrace_notrace`	读写	黑名单：排除匹配的函数	`__kernfs_*`

  网络函数过滤示例： 若只想跟踪 TCP 接收路径，执行 

  echo tcp_v4_rcv > /sys/kernel/tracing/set_ftrace_filter

  然后设置 echo function_graph > current_tracer，即可看到 TCP 接收函数的调用图。

3.3.2 事件控制文件

事件跟踪是 ftrace 最强大的功能之一，允许在特定内核函数入口/出口或自定义探针点记录数据。对于网络协议栈，事件文件位于 events/skb/、events/tcp/、events/net/ 等子目录下。

文件/目录	类型	说明
`available_events`	只读	列出所有可跟踪的事件 ID
`events/`	目录	按子系统组织的事件层级，如 `events/skb/kfree_skb`
`set_event`	读写	写入事件名以启用跟踪，如 `echo skb:kfree_skb > set_event`

每个事件目录下通常包含以下控制文件：

enable：写入 1 启用该事件，写入 0 禁用。
filter：设置过滤表达式，例如 len > 100 只记录长度大于 100 字节的 skb。
format：显示该事件的字段格式，用于解析 trace 输出。

3.3.3 输出与缓冲区文件

文件	功能	网络调试用法
`trace`	以人类可读格式输出当前缓冲区内容	`cat trace \| grep tcp`
`trace_pipe`	持续输出流式跟踪数据（阻塞读取）	`cat trace_pipe \| tee trace.log`
`per_cpu/`	按 CPU 分离的跟踪缓冲区目录	分析多核网络软中断分布
`tracing_on`	全局跟踪开关（1=开，0=关）	减少跟踪开销时临时关闭

性能注意： trace_pipe 在读取时会阻塞并消耗 CPU，生产环境建议先写入 trace 文件再离线分析，或使用 trace-cmd 工具进行低开销记录。

3.4 缓冲区与选项配置

ftrace 使用环形缓冲区存储跟踪记录。以下文件控制缓冲区行为：

buffer_size_kb：设置每个 CPU 的缓冲区大小（单位 KB）。网络调试时建议设为 4096 以上，避免丢事件。
buffer_total_size_kb：只读，显示所有 CPU 缓冲区总大小。
options/：目录，包含数十个开关文件，如 sym-offset（显示符号偏移）、stacktrace（记录调用栈）、print-tgid（显示线程组 ID）。

3.5 实战：快速定位网络丢包事件

以下步骤演示如何利用 tracefs 核心文件，快速捕获内核网络协议栈中的 skb 释放事件（通常意味着丢包或错误）：

挂载 tracefs（如未挂载）：

mount -t tracefs tracefs /sys/kernel/tracing

清空缓冲区并关闭其他跟踪器：

echo nop > /sys/kernel/tracing/current_tracer
echo 0 > /sys/kernel/tracing/tracing_on
echo > /sys/kernel/tracing/trace

启用 skb 释放事件：

echo "skb:kfree_skb" >> /sys/kernel/tracing/set_event

设置过滤条件（可选，只记录特定协议）：

echo "protocol == 0x0800" > /sys/kernel/tracing/events/skb/kfree_skb/filter

开启跟踪并触发网络流量：

echo 1 > /sys/kernel/tracing/tracing_on
# 在此处运行网络测试命令，如 curl、ping 等
sleep 5
echo 0 > /sys/kernel/tracing/tracing_on

读取跟踪结果：

cat /sys/kernel/tracing/trace | head -50

输出解读： trace 输出中每一行包含 任务名-PID [CPU] 时间戳: 事件名: 字段=值。对于 kfree_skb 事件，重点关注 location 字段（指示释放位置）和 reason 字段（指示释放原因，如 SKB_DROP_REASON_TCP_RCV_WINDOW）。

3.6 本章小结

tracefs 是 ftrace 的用户态接口，核心路径为 /sys/kernel/tracing/。
控制文件（current_tracer、set_ftrace_filter）决定“跟踪什么”。
事件文件（events/、set_event）决定“跟踪哪些内核活动”。
输出文件（trace、trace_pipe）决定“如何查看结果”。
缓冲区配置（buffer_size_kb、tracing_on）影响跟踪的可靠性与性能。
网络性能调试中，skb:kfree_skb 和 tcp:tcp_probe 是最常用的事件入口。