静态跟踪点

 

在 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/

 

posted @ 2025-02-28 09:07  dos_hello_world  阅读(42)  评论(0)    收藏  举报