Ftrace 触发器的使用

  

Ftrace trigger的基本概念和功能

Ftrace trigger可以在特定事件发生时执行以下命令:

  • ‌enable/disable_event‌:启用或禁用其他事件的跟踪。
  • ‌stacktrace‌:将堆栈跟踪信息输出到跟踪缓冲区。
  • ‌snapshot‌:创建当前跟踪缓冲区的快照。
  • ‌traceon/traceoff‌:开启或关闭跟踪。
  • ‌hist‌:创建事件的直方图统计数据‌ 

每当调用带有触发器的跟踪事件时( > 右边是触发器事件),就会调用与该事件关联的触发器命令集(> 左边是触发器触发后要执行的关联事件)。触发器可以与过滤器一起使用,只有通过过滤的触发器才会生效;如果没有设置触发器,则表示触发器对所有事件生效。

如果触发器没有关联过滤器,默认情况下,针对所有内核函数执行关联事件。

通过将触发器表达式写入给定事件的触发器文件中,可以在触发器触发后,针对另一个事件执行表达式中的内容。

以上提到的给定事件,可以关联多个触发器,所有触发器的配置,必须遵守触发器的配置规则。如配置 read 系统调用触发时,跟踪 kmem:kmalloc 函数的调用,以及记录它的堆栈。

 

应用场景

‌Snapshot‌:Snapshot功能是在触发事件发生时,创建一个当前跟踪缓冲区的快照。这意味着它会捕获并保存当前跟踪缓冲区中的所有信息,通常用于记录和分析特定事件发生时的系统状态‌。Stacktrace‌:Stacktrace功能是在触发事件发生时,将当前的调用栈信息输出到跟踪缓冲区。这通常用于调试目的,帮助开发者了解触发事件时函数调用的上下文和路径‌。

 

Trigger 表达式语法

通过向 trigger 文件输入指令实现添加触发器

# echo 'command[:count] [if filter]' > trigger 

触发器的删除方式与添加方式一致,只是指令前面必须用“!” 开头

# echo '!command[:count] [if filter]' > trigger

 

当一件事件发生时开启/关闭另外一件事件跟踪的语法格式

事件触发器导致其它事件开启跟踪

如下所示:当 read 系统调用(对应 sys_enter_read,内核执行 read 系统调用之前被调用的钩子)被调用时,kmalloc 事件将会被跟踪。语法中 “:1” 表示跟踪开启事件只会执行一次。

  # echo 'enable_event:kmem:kmalloc:1' > \
      /sys/kernel/debug/tracing/events/syscalls/sys_enter_read/trigger

事件触发器导致其它事件关闭跟踪

如下所示:当 read 系统调用(对应 sys_exit_read,内核执行 read 系统调用结束时被调用的钩子)调用结束时,结束 kmalloc 事件的跟踪。

  # echo 'disable_event:kmem:kmalloc' > \
      /sys/kernel/debug/tracing/events/syscalls/sys_exit_read/trigger 

当一件事件发生时开启/关闭另外一件事件跟踪的语法格式

      enable_event:<system>:<event>[:count]
      disable_event:<system>:<event>[:count]

移除以上配置的方式:  

  # echo '!enable_event:kmem:kmalloc:1' > \
      /sys/kernel/debug/tracing/events/syscalls/sys_enter_read/trigger

  # echo '!disable_event:kmem:kmalloc' > \
      /sys/kernel/debug/tracing/events/syscalls/sys_exit_read/trigger

  注意:一个事件在关联触发器后,可以触发多个其它事件跟踪的开启或者关闭。如 sys_enter_read 触发器触发后,可以同时启用 kmem:kmalloc 和 sched:sched_switch 两个事件的跟踪,但是不能同时为 kmem:kmalloc 事件同时设置两个不同的参数,如 kmem:kmalloc 和 kmem:kmalloc:1。

 

堆栈回溯

当触发器触发时,会将对应事件的堆栈写入 ftrace ring buffer 中。

如下所示:每次 kmalloc 跟踪点触发时,将堆栈信息写入 trace buffer。

  # echo 'stacktrace' > \
        /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger

 以下命令,如果 kmalloc 的 size>=64K ,则将前 5 次事件的堆栈写入 trace buffer 

  # echo 'stacktrace:5 if bytes_req >= 65536' > \
        /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger 

 堆栈回溯的语法格式

     stacktrace[:count]

  清除堆栈回溯的方式

  # echo '!stacktrace' > \
        /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger

  # echo '!stacktrace:5 if bytes_req >= 65536' > \
        /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger

  以上示例中第二条堆栈回溯的删除方式可以更简单一些

  # echo '!stacktrace:5' > \
        /sys/kernel/debug/tracing/events/kmem/kmalloc/trigger

  注意:每个触发器只能关联一个事件

snapshot

 

 

 

 

 

 

 

原文:
https://lwn.net/Articles/556254/

stacktrace[:count]

  

posted @ 2025-03-06 15:08  dos_hello_world  阅读(9)  评论(0)    收藏  举报