Glance项目AdguardHome DNS统计图表显示问题解析

问题现象

在使用Glance项目监控AdguardHome DNS服务器时，用户遇到了一个典型问题：虽然DNS小部件已经成功连接到两个AdguardHome服务器并返回了部分数据，但统计图表却显示为空白。这种情况持续了数小时，用户无法确定是等待时间不足、配置错误还是其他技术问题。

技术分析

数据获取机制

Glance项目在设计AdguardHome DNS统计功能时，最初采用了与Pi-hole类似的数据获取逻辑。开发者假设AdguardHome会默认返回最近24小时的统计数据，这一假设源于Pi-hole的默认行为。然而，这种假设在实际应用中出现了偏差。

根本原因

问题的核心在于AdguardHome的统计保留时间配置。与Pi-hole不同，AdguardHome允许用户自定义统计数据的保留期限（从1天到90天不等）。当Glance尝试获取24小时内的统计数据时，如果AdguardHome的统计保留时间设置与预期不符，就会导致图表数据无法正确显示。

解决方案

版本更新修复

Glance开发团队在v0.6.1版本中修复了这一问题。新版本改进了数据获取逻辑，不再硬性假设24小时的统计周期，而是能够适应AdguardHome的各种统计保留时间设置。

配置建议

对于使用AdguardHome的用户，建议：

1. 确保AdguardHome的统计功能已启用
2. 检查统计保留时间设置（位于"设置→统计配置"）
3. 使用Glance v0.6.1或更高版本进行监控

技术启示

这个案例展示了监控工具与被监控服务之间数据接口兼容性的重要性。开发者在集成第三方服务时，应当：

1. 全面了解被监控服务的API特性
2. 避免对服务行为做出硬性假设
3. 提供足够的配置灵活性以适应不同的使用场景

验证结果

用户升级到修复版本后，AdguardHome的DNS统计图表已能正常显示，包括查询总数、阻止的查询、客户端数量等关键指标，实现了预期的监控功能。