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]

浙公网安备 33010602011771号