静态跟踪点
在 Linux 内核开发中,tracepoint 是一种用于内核调试和性能分析的机制,允许内核开发者在不修改内核源代码的情况下,插入和触发事件点。这些事件可以被用户空间的工具如 ftrace,systemtrap, perf 捕获和分析。
静态 tracepoint 是预先定义在内核代码中的 tracepoint,它们在编译时就已经嵌入到内核中。
静态跟踪点的定义方式
Linux 跟踪点是为了解决常见问题而设计。例如,考虑以下用于报告页面分配的内存管理代码的跟踪点。跟踪点的声明如下:
#include <linux/tracepoint.h>
TRACE_EVENT(mm_page_allocation,
TP_PROTO(unsigned long pfn, unsigned long free),
TP_ARGS(pfn, free),
TP_STRUCT__entry(
__field(unsigned long, pfn)
__field(unsigned long, free)
),
TP_fast_assign(
__entry->pfn = pfn;
__entry->free = free;
),
TP_printk("pfn=%lx zone_free=%ld", __entry->pfn, __entry->free)
);
如上所示:
- 静态跟踪点是通过在内核代码中使用 TRACE_EVENT 宏来定义的。
- 在这里 mm_page_allocation 是跟踪点名称,跟踪点名称必须唯一。
- TP_PROTO 定义了跟踪点函数签名(函数原型),这块我理解为一旦触发了跟踪点事务后,tracepoint 的内部的钩子会调用一个签名为 TP_PROTO 的函数。该函数应该不需要外部(程序员)传入。
- TP_ARGS 定义了跟踪点函数的参数名,这里说的跟踪点函数,也就是 TP_PROTO 定义的函数原型。这里的函数名,在一定程度上可以说与 TP_PROTO 有重复的嫌疑,原因未知。
- TP_STRUCT__entry 定义了一个代表跟踪点的结构体,应该是 tracepoint 内部会使用到。
- TP_fast_assign 定义了如何给 TP_STRUCT_entry 结构体复制的语句,关联了 TG_ARGS 和 TP_STRUCT_entry
- TP_printk 当跟踪点触发时,内核打印的格式化字符串。会被 perf,Ftrace 等识别
类似实现,还可参考:https://web.git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/samples/trace_events/trace-events-sample.h?id=HEAD
根据以上内容,我们可以在内核中触发这个静态跟踪点:
trace_mm_page_allocation(page_to_pfn(page), zone_page_state(zone, NR_FREE_PAGES));
找到内核中的跟踪点代码
以 netif_rx 跟踪点为例,要想找到该跟踪点必须搜索 trace_netif_rx() 函数,因为跟踪点函数的调用格式是 trace_<跟踪点名称>
static int netif_rx_internal(struct sk_buff *skb)
{
int ret;
net_timestamp_check(netdev_tstamp_prequeue, skb);
trace_netif_rx(skb);
...
静态跟踪点的使用方式举例:debugfs
通过 debugfs 的 enable 文件就可以打开静态跟踪点,并且可以从 trace 或者 trace_pipe 获取对应的调试信息:
$ echo 1 > /sys/kernel/debug/tracing/events/net/netif_receive_skb/enable
$ cat /sys/kernel/debug/tracing/trace_pipe
<idle>-0 [030] ..s. 17429.831685: netif_receive_skb: dev=eth0 skbaddr=ffff99a3b231d600 len=52
<idle>-0 [030] .Ns. 17429.831694: netif_receive_skb: dev=eth0 skbaddr=ffff99a3b231d600 len=52
以上的输出数据,来自 netif_receive_skb 跟踪点里 TP_printk 定义
TP_printk("dev=%s skbaddr=%p len=%u",
__get_str(name), __entry->skbaddr, __entry->len)
如下所示,我们使用过滤器获取指定(更大的 skbs)的内容
$ echo "len > 128" > filter
$ cat filter
len > 128
$ cat /sys/kernel/debug/tracing/trace_pipe
<idle>-0 [038] ..s. 578.249650: netif_receive_skb: dev=eth0 skbaddr=ffff9fa2043c6e00 len=156
<idle>-0 [038] ..s. 579.249051: netif_receive_skb: dev=eth0 skbaddr=ffff9fa2043c6e00 len=156
<idle>-0 [038] ..s. 580.250971: netif_receive_skb: dev=eth0 skbaddr=ffff9fa2043c6e00 len=156
静态跟踪点的使用方式举例:perf
使用 perf record -e 可以获取指定跟踪点的信息。
$ perf record -e net:netif_receive_skb $ perf report Samples: 8 of event 'net:netif_receive_skb', Event count (approx.): 8 Overhead Trace output 50.00% dev=eth0 skbaddr=0xffff99a3b1c10400 len=84 12.50% dev=eth0 skbaddr=0xffff999a9658ef00 len=76 12.50% dev=eth0 skbaddr=0xffff99a3b26de400 len=52 12.50% dev=eth0 skbaddr=0xffff99a3b2765500 len=76 12.50% dev=eth0 skbaddr=0xffff99a7026f0300 len=46
参考:
https://blogs.oracle.com/linux/post/taming-tracepoints-in-the-linux-kernel
https://www.kernel.org/doc/Documentation/trace/tracepoints.txt
https://lwn.net/Articles/330402/

浙公网安备 33010602011771号