Apache DevLake 中 Grafana DORA 仪表板年份显示问题的分析与解决

Apache DevLake 是一个开源的数据湖平台，用于收集、分析和可视化软件开发过程中的各项指标。在使用过程中，部分用户反馈 Grafana 中的 DORA 仪表板仅显示 2021 和 2023 年的数据，即使手动选择当前年份也无法显示有效数据。

问题现象

用户通过 Docker Compose 方式部署 DevLake 后，发现 Grafana 的 DORA 仪表板存在以下异常：

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

根本原因分析

经过深入调查，发现该问题源于 DORA 仪表板的配置设置。仪表板的 JSON 配置文件中硬编码了特定的年份范围，导致无法动态显示当前年份的数据。具体表现为：

1. 仪表板模板变量配置中限制了可选年份范围
2. 时间范围设置未考虑当前年份的数据查询
3. 数据查询语句中可能包含固定的年份过滤条件

解决方案

要解决此问题并显示当前年份的指标数据，可以采取以下技术措施：

1. 修改仪表板配置

找到 DORA 仪表板的 JSON 配置文件，通常位于项目的 grafana/dashboards 目录下。需要修改以下关键部分：

"templating": {
  "list": [
    {
      "name": "dora_report",
      "type": "query",
      "query": "SELECT DISTINCT year FROM dora_metrics WHERE year IN ('2021','2023')",
      "current": {
        "selected": false,
        "text": "2023",
        "value": "2023"
      }
    }
  ]
}

将查询语句中的年份限制条件移除或更新为包含当前年份。

2. 调整时间范围设置

确保仪表板的时间范围设置能够覆盖当前年份：

"time": {
  "from": "now-1y",
  "to": "now"
}

3. 验证数据同步

检查数据收集和同步配置，确保：

• 数据收集任务已正确配置并执行
• 数据转换规则包含当前年份的数据处理
• 数据库中存在当前年份的指标记录

实施建议

对于生产环境部署，建议采用以下最佳实践：

1. 使用动态时间范围查询替代硬编码年份
2. 定期更新仪表板配置以匹配业务需求
3. 建立仪表板配置的版本控制和变更管理流程
4. 考虑使用 Grafana 的变量功能实现更灵活的时间选择

总结

通过分析 Apache DevLake 中 Grafana DORA 仪表板的年份显示问题，我们发现其根源在于仪表板配置的局限性。通过合理修改配置文件和验证数据同步机制，可以解决这一问题，使仪表板能够正确显示当前年份的指标数据。这为使用 DevLake 进行持续交付和运营指标监控提供了可靠的技术保障。