Blocky监控面板在v0.25版本中的兼容性问题分析

Blocky作为一款开源的DNS代理和广告拦截工具，其内置的Grafana监控面板在v0.25版本中出现了一些兼容性问题。这些问题主要影响以下几个关键监控指标面板的正常显示。

问题表现

在Blocky v0.25版本中，用户报告了多个监控面板出现"bad_data"错误或无数据显示的情况。受影响的面板包括：

1. 平均响应时间面板
2. 缓存命中/未命中率面板
3. 预取计数面板
4. 上游请求持续时间面板

根本原因分析

经过技术分析，这些问题主要源于v0.25版本中Prometheus指标名称的变更。具体变更如下：

• 旧版指标blocky_prefetchs_total变更为blocky_prefetches_total
• blocky_prefetch_hit_count变更为blocky_prefetch_hits_total
• blocky_cache_hit_count变更为blocky_cache_hits_total
• blocky_cache_miss_count变更为blocky_cache_misses_total
• blocky_request_duration_ms_bucket变更为blocky_request_duration_seconds_bucket

此外，黑名单缓存条目指标也从blocky_denylist_cache变更为blocky_denylist_cache_entries。

解决方案

针对这些问题，项目维护者已经提交了修复代码，主要做了以下调整：

1. 更新所有受影响的Prometheus查询表达式，使用新的指标名称
2. 修正了拼写错误的指标名称（如prefetchs→prefetches）
3. 统一了指标命名规范（如hit_count→hits_total）

实施建议

对于正在使用Blocky v0.25版本的用户，建议：

1. 更新到最新版本的监控面板配置
2. 如果同时需要支持v0.24和v0.25版本，可以考虑使用条件查询表达式
3. 定期检查指标名称变更，特别是在升级Blocky版本时

总结

Blocky在v0.25版本中对Prometheus监控指标进行了规范化命名调整，这虽然带来了短期的兼容性问题，但从长期来看有利于维护更一致的监控体系。用户只需更新监控面板配置即可解决这些问题，无需担心功能上的影响。