Grafana界面指标重复显示问题：GitHub Stars Exporter旧数据残留

可能原因及对应解决方法 #

• Exporter侧重复上报：
  简易Exporter大概率存在重复抓取或未做去重的逻辑，导致同一仓库的stars指标被多次上报到Prometheus。可以从这几点排查：

  • 检查Exporter代码，确认是否每次抓取都生成了新的时间序列（比如有没有不必要的标签变动，或是每次请求都创建新的metric实例）
  • 调整抓取间隔，避免短时间内重复触发抓取
  • 给Exporter的metric添加固定的唯一标识标签（比如exporter_instance），防止不同实例或重复启动的实例上报的同仓库数据被当成不同序列，但图例显示一致

• Prometheus数据清理策略问题：
  Prometheus默认不会自动删除旧时间序列，如果Exporter曾经上报过某个仓库的指标，后来因配置变更不再抓取，但旧数据仍留在存储中，查询时就会新旧数据同时出现。

  • 检查Prometheus的storage.tsdb.retention.time配置，设置合理的保留时长（比如15d，覆盖你的14d查询范围），让旧数据能被自动清理
  • 用Prometheus的删除API手动清理无用旧序列：

    curl -X POST -g 'http://<prometheus地址>:9090/api/v1/admin/tsdb/delete_series?match[]=github_repo_stars{repo="重复的仓库名"}'
    

    替换实际的Prometheus地址和重复的仓库名称即可

• Grafana查询配置优化：
  当前查询github_repo_stars > 1没有做去重或最新值过滤，会拉取同一仓库的所有时间序列数据。可以修改查询逻辑：

  • 改用last_over_time(github_repo_stars[14d]) > 1，只取每个时间序列在14d内的最后一个值，避免旧序列的历史数据干扰
  • 或者用max_over_time(github_repo_stars[1m])，按分钟取最大值，过滤掉重复上报的冗余数据
  • 先在Prometheus的Graph页面验证查询结果，确认同一仓库只有一条有效序列后，再同步到Grafana

验证步骤 #

1. 在Prometheus的Explore页面执行github_repo_stars查询，查看是否存在同一repo标签对应多条时间序列（可通过instance或其他标签区分）
2. 查看Exporter的日志，确认是否有重复抓取的记录
3. 修改查询语句后，刷新Grafana图表，观察重复指标是否消失

内容的提问来源于stack exchange，提问作者snwfdhmp