【SPDK 用户态存储】可观测与性能口径：iostat、直方图与官方 Report 读法
内容提要
本文介绍SPDK v26.01的性能观测与口径，强调区分进程内RPC统计、官方Performance Reports和本机fio三类数据。核心是理解bdev_get_iostat字段语义，如延迟ticks需除以tick_rate换算，min/max非百分位。读官方报告须核对硬件、拓扑、QD等条件，不能外推本机。观测需记录口径四元组，避免跨版本比较和重复计数。
延伸解读
区分三类性能数据，避免误用
文章强调进程内RPC统计、官方Performance Reports和本机fio是三种不同性质的性能数据，各有合法用途。RPC统计适合观察同一进程内的趋势和异常，官方报告用于学习方法和硬件代际，只有本机fio或应用SLO才能支撑上线结论。跨机器或跨版本比较时，必须注意口径差异，否则容易得出错误结论。
理解bdev_get_iostat字段语义
bdev_get_iostat返回的延迟字段以tick为单位，需除以tick_rate才能换算为秒。平均延迟由累计ticks和操作数计算，min/max是极值而非百分位。队列深度相关字段依赖采样周期配置，未启用或周期不同时不能跨实例比较。此外，reset操作会影响所有消费者，监控和排障共用计数器时需谨慎。
官方Performance Report的正确读法
阅读官方Performance Report时，必须核对SPDK版本、硬件型号、拓扑、队列深度、块大小、读写比、核mask等条件，才能判断是否可比。报告中的指标是特定硬件和条件下的结果，不能直接外推到本机。引用时应采用规范句式，注明版本、硬件和条件，避免将报告数值当作本机预期。
观测接入排障与发布门禁的要点
将观测接入排障和发布门禁时，至少需要三类信号：存活与配置对账、速率与错误、延迟形状。发布前后对比必须保证相同的tick_rate理解、reset纪律和QD/块大小，否则无法判断性能变化是否真实。门禁条件应基于相对基线变更或误差计数，而非达到某个PDF的IOPS。
Q&A
SPDK中bdev_get_iostat返回的延迟ticks如何换算成微秒？
延迟ticks需要除以tick_rate（响应中的tick_rate字段）才能得到秒，再乘以1e6得到微秒。平均延迟由累计的latency_ticks除以操作数和tick_rate得到。
SPDK官方Performance Report能否直接用于预测本机性能？
不能。官方报告是在特定硬件和条件下测得的，只能作为学习方法和参考，不能外推到本机或其他环境。引用时应注明版本、硬件、拓扑、队列深度等条件。
SPDK中bdev_get_iostat的min/max延迟字段代表什么？
min/max是观测期间的最小和最大延迟极值，不是百分位数。它们可能被偶发I/O拉高，不能代表典型延迟分布。
SPDK中bdev_reset_iostat的reset操作有什么注意事项？
reset操作会影响所有消费者，因为计数器是共享的。监控和人工排查共用计数器时，不应随意reset，否则会干扰其他观测。
SPDK中如何正确使用直方图观测延迟分布？
直方图提供离散的桶近似，用于观察分布形状（如双峰、长尾），但不能跨版本或跨机器直接比较桶计数。需要声明采样窗口和是否reset过。
SPDK性能对比中，为什么必须记录QD、块大小、读写比和核mask？
这些参数构成“口径四元组”，是性能对比的基础。缺少任何一项，对比结果就不可比，无法判断性能变化是来自软件变更还是测试条件变化。
SPDK中如何避免层间重复计数？
nvmf入口、bdev、下层nvme可能各自暴露统计，直接相加会双计。应选定一层作为主真相（通常是最贴近症状的层），其他层仅用于交叉验证。
SPDK中监控采样和事故抓取应如何分开？
监控采样应低频、只读、禁止reset；事故抓取应在明确窗口内使用per_channel或直方图，并记录是否reset。两套系统不应共用同一reset入口，以免互相干扰。
