Blocky项目多实例监控与Grafana仪表板配置指南

多实例监控需求背景

在DNS过滤解决方案Blocky的实际部署中，用户经常需要监控多个实例的运行状态。通过Prometheus和Grafana的组合可以实现这一需求，但在配置过程中存在一些技术细节需要注意。

核心配置要点

1. Prometheus数据采集配置

在Prometheus的配置文件中，需要为每个Blocky实例设置独立的job_name。例如：

scrape_configs:
  - job_name: 'blocky01'
    static_configs:
      - targets: ['blocky01:4000']
  - job_name: 'blocky02'
    static_configs:
      - targets: ['blocky02:4000']

2. Grafana仪表板变量设置

Blocky官方仪表板(13768)默认使用变量$job，其查询表达式为label_values(blocky_blocking_enabled,job)。这个变量会自动发现所有配置的Blocky实例。

3. 查询表达式优化

对于多实例监控，可以采用以下几种查询方式：

• 汇总所有实例数据：sum(rate(blocky_query_total[5m])) * 60
• 按实例筛选：sum(rate(blocky_query_total{job=~"blocky01|blocky02"}[5m])) * 60
• 使用变量筛选：sum(rate(blocky_query_total{job=~"$myjob"}[5m])) * 60

4. 请求持续时间指标解析

Blocky的"请求持续时间(upstream)"指标包含两部分：

1. 条件处理时间(如黑名单/白名单检查)
2. 实际上游查询时间

这个指标反映了从收到DNS请求到返回响应的完整处理流程耗时。

常见问题解决方案

仪表板按钮显示异常

需要在Grafana配置中启用HTML渲染：

1. 修改grafana.ini配置文件：

[panels]
disable_sanitize_html = true

2. 或通过环境变量设置：

GF_PANELS_DISABLE_SANITIZE_HTML=TRUE

多仪表板配置策略

如果需要为每个Blocky实例创建独立仪表板，可以采用以下方法：

1. 为每个实例创建独立的数据源
2. 在仪表板JSON中修改job_name过滤条件
3. 使用Grafana的仪表板变量实现动态切换

最佳实践建议

1. 推荐使用单个仪表板配合实例筛选功能，而非创建多个独立仪表板
2. 定期检查Prometheus的up指标，确保所有实例数据正常采集
3. 对于关键业务指标，设置适当的告警规则
4. 考虑使用Grafana的注释功能标记不同实例的特殊事件

通过合理配置，可以轻松实现Blocky多实例的集中监控，帮助管理员全面掌握DNS服务的运行状态。