Linux下必须用perf_event_open捕获线程调度延迟，因标准C++无跨平台接口；需通过sched:sched_stat_wait/sleep tracepoint、正确解析ring buffer、线程局部存储管理fd，并注意内核版本差异与单位问题。
Linux下用perf_event_open捕获线程调度延迟
标准C++没有提供跨平台的线程调度延迟统计接口，必须依赖操作系统提供的性能事件机制。在Linux上，perf_event_open是唯一能低开销、高精度采集调度延迟（如sched:sched_stat_sleep、sched:sched_stat_wait）的手段。glibc和std::thread完全不暴露这类底层调度器信息。
关键点：不能靠clock_gettime(CLOCK_MONOTONIC)或std::chrono自行打点——用户态计时无法覆盖内核调度排队时间，测出来只是“业务逻辑耗时”，不是“被调度器延迟了多久”。
- 需以
PERF_TYPE_TRACEPOINT打开sched:sched_stat_wait（就绪队列等待时间）和sched:sched_stat_sleep（睡眠唤醒延迟）两个tracepoint - 每个子线程需单独创建perf event fd，并用
pthread_setname_np设名，后续从perf ring buffer中按pid/tid过滤数据 - 必须用
perf_event_attr.wakeup_events = 1避免采样丢失，否则高负载下大量延迟事件被丢弃
解析perf ring buffer中的sched_stat_wait事件
读取到的raw data是内核tracepoint定义的结构体，字段顺序和大小依赖kernel版本。例如5.10+的sched_stat_wait包含：comm[16]、pid、delay（纳秒）、rundelay（就绪后到实际运行的延迟）。
常见错误：直接reinterpret_cast为固定结构体——不同内核版本字段偏移不同，会导致delay读成垃圾值。必须用perf_event_get_attr()配合libtraceevent解析，或至少用read(2) + perf_event_mmap_page头校验magic number。
立即学习“C++免费学习笔记（深入）”；
- ring buffer head/tail管理必须用内存屏障：
__atomic_load_n(&page->data_head, __ATOMIC_ACQUIRE)，否则可能读到未提交的脏数据 -
delay字段单位是纳秒，但部分老内核（如4.19）用微秒，需查/sys/kernel/debug/tracing/events/sched/sched_stat_wait/format确认 - 一个事件对应一次调度延迟，但同一线程可能在单次sleep中积累多次wait，需按
pid/tid聚合计算平均值
C++封装时避免std::thread与perf fd生命周期错位
子线程退出时若未关闭对应的perf event fd，fd泄漏且后续无法关联该tid的延迟数据；过早关闭则丢失末尾事件。不能依赖RAII自动析构——std::thread对象销毁不等于线程函数结束。
正确做法：在线程函数入口调用perf_event_open()获取fd，存入线程局部存储（thread_local int perf_fd = -1），退出前显式close(perf_fd)并触发一次ioctl(perf_fd, PERF_EVENT_IOC_DISABLE)确保缓冲区刷出。
- 不要把perf fd存在全局map里用tid索引——
gettid()返回的tid可能被内核复用，新线程拿到旧fd残留数据 - 避免在主线程统一回收fd：子线程可能已exit但fd未close，
waitpid无法同步perf事件落盘状态 - 若用
std::jthread（C++20），仍需在std::stop_token回调里close，因join()不保证perf buffer已刷新
Windows下无等效方案，只能退化为粗粒度估算
Windows没有公开的调度延迟tracepoint。QueryPerformanceCounter结合WaitForSingleObject只能测“等待内核对象的时间”，无法分离出就绪后被抢占/未及时调度的部分。ETW的Microsoft-Windows-Kernel-Scheduler事件需管理员权限且开销极大（~10% CPU），不适合长期业务监控。
工程折中方案：在关键线程循环中插入GetThreadTimes，对比dwKernelTime与挂钟时间差，若差值持续>5ms，可判定存在调度挤压——但这只是间接指标，无法区分是CPU满载还是调度器bug。
真正要跨平台统一统计，必须接受Linux-only实现，或改用eBPF（5.15+）替代perf，后者支持更稳定的结构体ABI和按cgroup聚合，但要求内核配置CONFIG_BPF_SYSCALL=y。
