K6 JSON输出内置指标vus与控制台值不一致的原因及解决方案
K6 输出VU数值异常问题说明
核心结论
该现象不属于K6的产品缺陷,本质是对内置指标的采集规则、执行器调度逻辑和控制台展示逻辑的认知偏差导致的。
具体原因拆解:
- K6的内置指标中,
vus代表当前实际处于运行状态的虚拟用户数,vus_max代表当前阶段允许调度的最大虚拟用户数,两者本身的定义和设计是准确的。 - 多数场景下两者数值完全一致,是因为K6的调度策略默认会在每个测试阶段开始前,预拉起该阶段需要的全部VU实例。只要测试没有进入最终的VU回收清零阶段,所有被调度的VU本身就是全量活跃状态,自然两个指标数值完全相等。
- 控制台能看到动态变化的VU数值,是因为终端实时面板直接对接调度器的实时计数,渲染频率为1s一次,可以捕捉到VU从初始化、执行逻辑到回收的全流程动态过程;而JSON输出管道默认的指标聚合/上报间隔为10s,加上用户常见的预分配全量VU的配置,就会把短时间的VU爬坡、回收过程完全聚合抹平,最终表现为输出的JSON条目里除了最终
vus=0的节点,其余节点的vus取值都和vus_max完全一致,和实际观察到的表现完全匹配。
在JSON输出中获取准确动态VU数的配置方法
要拿到和控制台展示一致的、带动态变化过程的活跃VU数值,需要从调度配置和指标上报规则两方面调整:
- 调整VU预分配策略,不要提前把全量VU资源初始化完成
对于带爬坡过程的测试场景,不要在执行器配置中将preAllocatedVUs设置为峰值VU数,只需要为初始启动阶段预留最小的VU资源即可。这样K6会在爬坡过程中按需动态拉起新的VU实例,vus指标才能捕捉到动态增长的过程,而不是从测试一开始就达到满值。 - 缩短指标的上报聚合间隔
K6默认的指标flush间隔为10s,这个间隔长度很容易把短时间的VU爬坡过程聚合为一个稳定值。可以在执行测试时,通过环境变量将上报间隔调整为1s,让JSON输出捕捉到更细粒度的数值变化。对应的执行命令示例:k6 run --out json=test-result.json -e K6_METRIC_FLUSH_INTERVAL=1s your-test-script.js - 适配测试脚本的执行时长
如果测试脚本单次执行耗时极短,VU初始化速度快于指标上报间隔,哪怕完成了上述两项配置,也会很快看到vus和vus_max数值对齐,这属于正常调度表现,并非配置错误。
内容的提问来源于stack exchange,提问作者Jessy
相关产品推荐
相关产品推荐

