Apache DevLake 项目中 Grafana DORA 仪表板年份显示问题分析

Apache DevLake 是一个开源的数据湖平台，用于收集、分析和可视化软件开发过程中的各种指标。在使用过程中，部分用户反馈 Grafana 中的 DORA（DevOps Research and Assessment）仪表板存在年份显示异常的问题，仅能显示2021和2023年的数据，而无法显示当前年份的数据。

问题现象

当用户通过Docker Compose方式本地运行DevLake后，在访问Grafana的DORA仪表板时发现：

1. 报告选择器仅显示2021和2023两个年份选项
2. 即使手动尝试选择当前年份，仪表板仍然显示为空
3. 其他仪表板（如Github仪表板）数据收集和显示正常

问题根源分析

经过对项目代码的检查，发现问题主要源于DORA仪表板的配置文件中预设的年份范围限制。在仪表板的JSON配置文件中，开发者预先设置了特定的年份选项，这导致前端界面只能显示这些预设年份的数据。

解决方案

要解决这个问题，可以从以下几个技术层面进行调整：

1. 修改仪表板配置文件

需要编辑DORA仪表板的JSON配置文件，主要修改两个部分：

• 更新dora_report变量的查询定义，添加当前年份选项
• 调整时间范围设置，确保覆盖当前年份

2. 数据同步配置验证

确保数据收集和同步配置正确：

• 检查数据收集的时间范围设置
• 确认ETL流程是否包含最新数据
• 验证数据转换规则是否适用于当前年份

3. 仪表板时间范围调整

在Grafana仪表板配置中：

• 修改time部分的from和to字段
• 设置合理的默认时间范围
• 确保时间选择器支持当前年份

实施建议

对于希望快速解决问题的用户，可以直接修改仪表板配置文件。而对于长期维护的项目，建议：

1. 将年份选项改为动态生成，而非硬编码
2. 实现自动检测数据中可用的年份范围
3. 添加仪表板配置的版本控制，便于追踪修改

总结

Apache DevLake的DORA仪表板年份显示问题主要是由于预设配置导致的。通过适当修改配置文件并验证数据同步设置，用户可以解决这个问题并获取当前年份的指标数据。这个问题也提醒我们在开发类似数据可视化系统时，应该考虑更灵活的配置方式，以适配不断变化的数据时间范围。

对于开源项目贡献者来说，这也是一个改进项目的好机会，可以考虑提交PR将年份选择改为动态方式，提升产品的易用性和适应性。