添加sdt探针前必须确认程序含debuginfo和.note.stapsdt段，编译需加-g并用asm volatile插入标记，perf probe须指定绝对路径，参数解析需手动处理。
perf probe 添加 SDT 探针前，先确认程序带 debuginfo 和 SDT 标记
没符号、没标记，perf probe 就是盲人摸象。SDT（Statically Defined Tracing）探针不是自动埋点，得你自己加，而且编译时得保留调试信息和特殊 section。
- 编译 C++ 程序时必须加
-g（生成 DWARF），否则perf probe -l看不到任何用户探针 - 用
gcc或g++时，需链接libstapsdt（或直接内联宏），但更常用的是用asm volatile写原始标记 —— 因为libstapsdt在多数发行版默认不装，且 C++ name mangling 会让探针名难匹配 - 检查是否真有 SDT section：
readelf -x .note.stapsdt ./myapp；为空就说明没埋成功
用 asm volatile 埋点，绕过 C++ 名字修饰问题
别信“只要函数名对就能 probe”，C++ 函数经过 mangling 后，perf probe 根本不认识。直接在关键位置插汇编标记最稳。
- 在源码里插入类似这样的代码（注意：必须在函数体内、不能在头文件里重复定义）：
#ifdef __linux__
#define MY_SDT_PROBE() \
asm volatile (".note.stapsdt.1; .asciz \"provider\"; .asciz \"probe_name\"; .asciz \"\"; .quad 0; .quad 0; .quad 0; .previous" ::: "r0", "r1", "r2")
#else
#define MY_SDT_PROBE()
#endif
- 实际使用时，在你想观测的逻辑点调用
MY_SDT_PROBE()，比如if (verbose) { MY_SDT_PROBE(); } - 标记里的
provider和probe_name会出现在perf probe -l输出中，例如myapp:provider:probe_name - 不要用变量名或 this 指针做参数传入 asm —— SDT 不支持动态参数绑定，只占位，后续靠 perf script 解析寄存器/栈
perf probe 命令要带 -x 并指定绝对路径
perf probe 默认查当前目录或 PATH 下的二进制，但实际运行的可能是带版本号的路径、或被 systemd 拉起的非标准路径。错路径 = 找不到探针。
- 务必用
perf probe -x /path/to/myapp -l列出所有可用 SDT 探针，确认输出里有你的provider:probe_name - 添加时也必须带
-x：perf probe -x /path/to/myapp 'provider:probe_name' - 如果提示
No symbol found for probe，八成是路径不对，或者二进制被 strip 过（检查file ./myapp是否含not stripped） - 加完后用
perf list | grep sdt验证是否注册成功
perf record + script 抓到探针后，参数解析得自己写逻辑
SDT 探针本身不带类型信息，perf script 输出只有地址和 raw 字节，没有自动解包的 %arg1 之类 —— 这点和 USDT（BCC/eBPF）完全不同。
-
perf script -F trace_fields,comm,pid,tid,event,ip,sym能看到触发事件，但参数列全是空或十六进制 dump - 想读取探针附近栈或寄存器值，得结合
perf script -F ip,sym,brstack --no-children，再人工对照汇编定位参数位置 - 如果用了
libstapsdt的STAP_PROBE宏，它会在标记里写入参数偏移，但需要你用perf script -F event,ip,args（仅较新 kernel + perf 支持），且 C++ 成员函数仍可能因 this 调整导致 offset 偏移 - 简单场景建议只用探针做「打点计数」或「触发时机判断」，别指望自动抓 std::string 或对象字段
真正麻烦的从来不是加 probe，而是怎么让那个 .note.stapsdt section 在 strip、RPM 构建、容器镜像分层里不被删掉 —— 这部分没标准流程，得盯紧构建链路每一步。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
