k6仪表盘图表空白问题的分析与解决

问题现象

在使用k6进行API性能测试时，当将API定义移动到不同文件夹后，仪表盘(dashboard)显示的图表出现空白现象。具体表现为：

• 测试脚本正常执行，所有检查(check)都能正常通过
• 控制台日志显示API调用状态码正常
• 但仪表盘中的图表区域完全空白，无法显示任何性能数据

问题复现环境

• k6版本：0.50.0
• 操作系统：MacOS Sonoma
• 测试脚本结构：主脚本通过import引入位于不同文件夹的API定义文件

问题分析

经过深入分析，发现这个问题与k6仪表盘的数据聚合机制有关。k6仪表盘默认会对测试数据进行聚合处理，以减少数据量并提高显示效率。这个聚合过程受到以下两个关键参数的影响：

1. K6_WEB_DASHBOARD_PERIOD：数据聚合周期，默认值为10秒
2. 测试持续时间：测试脚本中定义的duration参数

仪表盘显示图表有一个重要规则：只有当测试持续时间大于三倍的数据聚合周期时，才会显示图表数据。这是为了防止在测试时间过短时显示不完整或无意义的图表。

解决方案

针对这个问题，有两种可行的解决方案：

方案一：延长测试持续时间

将测试脚本中的duration参数设置为大于三倍K6_WEB_DASHBOARD_PERIOD的值。例如：

export const options = {
    scenarios: {
        getUser_then_UpdateUser: {
          executor: 'constant-arrival-rate',
          duration: 30000, // 从10秒改为30秒
          rate: 1,
          preAllocatedVUs: 1,
          timeUnit: "1s",
        }
    }
}

方案二：调整数据聚合周期

通过设置环境变量K6_WEB_DASHBOARD_PERIOD来缩短数据聚合周期，使其三分之一小于测试持续时间。例如：

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

最佳实践建议

1. 合理规划测试时长：在设计性能测试场景时，应确保测试持续时间足够长，既能收集有意义的性能数据，又能满足仪表盘显示需求。

2. 理解数据聚合机制：了解k6的数据处理机制有助于正确解读测试结果，特别是在短时测试场景中。

3. 模块化脚本设计：虽然将API定义移动到不同文件夹可能导致初始显示问题，但这种模块化设计仍然是推荐的做法，有利于测试脚本的维护和复用。

4. 环境变量配置：在CI/CD环境中运行时，应确保正确配置所有相关的k6环境变量，以获得一致的测试报告。

通过理解k6仪表盘的工作原理并合理配置相关参数，可以有效避免图表空白的问题，获得准确可靠的性能测试可视化结果。