k6测试工具中Dashboard图表显示问题的分析与解决

问题现象描述

在使用k6进行API性能测试时，开发者遇到了一个Dashboard图表显示异常的问题。当将API定义代码移动到单独的js文件中后，Dashboard界面中的图表区域变为空白，但测试检查(check)功能仍能正常执行并显示结果。

问题复现环境

• k6版本：0.50.0
• 操作系统：MacOS Sonoma
• 测试场景：包含两个API调用的简单测试脚本

问题详细分析

开发者最初将两个API调用(get_Data_User和update_NewUser)分别放在单独的js文件中，通过import方式引入主测试脚本。执行测试时使用以下命令：

K6_WEB_DASHBOARD=true K6_WEB_DASHBOARD_EXPORT=testreport.html k6 run script.js

测试结果显示Dashboard界面中的图表区域为空白，但检查结果仍能正常显示。经过进一步调查，发现这与k6 Dashboard的聚合周期设置有关。

根本原因

k6 Dashboard的图表显示有一个重要限制条件：只有当测试持续时间大于聚合周期值(K6_WEB_DASHBOARD_PERIOD)的三倍时，才会显示图表数据。默认情况下：

• 聚合周期(K6_WEB_DASHBOARD_PERIOD)默认值为10秒
• 因此测试持续时间需要至少30秒才能显示图表

在最初的问题复现中，测试持续时间设置为10秒，不满足上述条件，导致图表无法显示。

解决方案

有两种方法可以解决这个问题：

1. 延长测试持续时间：将测试场景中的duration参数设置为大于30秒的值

   duration: 30000, // 30秒
   

2. 调整聚合周期参数：通过设置K6_WEB_DASHBOARD_PERIOD环境变量来缩短聚合周期

   K6_WEB_DASHBOARD_PERIOD=3s K6_WEB_DASHBOARD=true k6 run script.js
   

   这样测试持续时间只需大于9秒(3×3)即可显示图表

最佳实践建议

1. 对于短期测试(小于30秒)，建议显式设置更短的聚合周期
2. 对于需要精确监控的测试，可以结合使用k6的实时输出和Dashboard功能
3. 在编写模块化测试脚本时，注意测试持续时间与监控需求的匹配
4. 对于CI/CD环境中的短期测试，可以考虑使用k6的文本输出或JSON导出功能替代Dashboard

总结

k6 Dashboard的图表显示功能有其特定的工作条件限制，理解这些限制条件有助于开发者更好地利用这一功能进行性能测试监控。通过合理配置测试持续时间和聚合周期参数，可以确保在各种测试场景下都能获得有效的可视化结果。