Pi-hole仪表盘24小时查询统计异常问题分析

问题现象

Pi-hole用户在使用过程中发现仪表盘中的"Total queries over last 24 hours"图表区域显示为空，且数据不会实时更新。该图表本应展示过去24小时内DNS查询请求的统计趋势，正常情况下会以柱状图形式动态展示查询量变化。

环境信息

• Pi-hole核心版本：v5.18.2
• 管理界面版本：v5.21
• FTL引擎版本：v5.25.1
• 运行平台：树莓派上的Debian 10系统

技术分析

该问题涉及Pi-hole的数据收集和展示机制，主要与以下几个API端点相关：

1. 24小时查询统计图表：依赖overTimeData10minsAPI，正常情况下应返回包含时间序列数据的JSON响应
2. 客户端统计图表：依赖overTimeDataClientsAPI
3. 查询类型图表：依赖getQueryTypesAPI
4. 上游服务器图表：依赖getForwardDestinationsAPI

在故障状态下，overTimeData10minsAPI返回了空数组：

{"domains_over_time":[],"ads_over_time":[]}

而客户端统计API虽然能返回客户端列表，但时间序列数据同样为空：

{"clients":[...],"over_time":[]}

解决方案

经过排查，该问题可通过以下步骤解决：

1. 系统重启：最简单的解决方法是重启运行Pi-hole的设备（如树莓派），这可以重置FTL引擎和相关服务
2. 服务检查：重启后应确认pihole-FTL服务正常运行
3. 数据验证：通过命令行工具pihole -q example.com测试查询功能，确保新数据能被记录

技术原理

Pi-hole的统计数据由FTL引擎实时收集并存储在内存数据库中。当API返回空数据时，通常表明：

• FTL引擎未能正确初始化时间序列数据收集模块
• 内存数据库连接异常
• 系统资源限制导致统计功能被禁用

重启操作之所以有效，是因为它：

1. 释放了可能被占用的系统资源
2. 重新初始化了FTL引擎的所有功能模块
3. 重建了内存数据库连接

预防建议

为避免类似问题再次发生，建议：

1. 定期检查系统资源使用情况（内存、CPU）
2. 保持Pi-hole及其组件更新到最新版本
3. 对于长期运行的设备，考虑设置定期维护重启计划
4. 关注FTL服务的运行状态

总结

Pi-hole仪表盘统计异常通常与后台服务状态相关，通过系统重启可以快速恢复。理解Pi-hole的数据收集机制有助于快速定位和解决类似问题，确保系统功能的持续稳定运行。