pgwatch2监控面板无法识别PostgreSQL关系表问题解析

问题现象

在使用pgwatch2监控PostgreSQL数据库时，用户发现Grafana面板无法正常工作，报错显示"pq: relation 'wal' does not exist"。检查发现pgwatch2_metrics数据库中缺少多个预期应该存在的表。

环境配置

用户环境配置如下：

• pgwatch2版本：5f7377084446c7f08b860cbb7f93acc31ef4966f (2023-12-28发布)
• PostgreSQL版本：15
• 存储模式：使用TimescaleDB插件扩展的pgwatch2_metrics存储模式

根本原因分析

经过排查，发现问题的核心在于监控指标的配置方式。pgwatch2的监控表是动态创建的，只有当某个监控指标被激活时，系统才会创建对应的存储表。

用户同时使用了两种配置方式：

1. 通过直接插入pgwatch2.monitored_db表配置，使用了"full"预设
2. 通过instances.yaml文件配置，使用了"minimal"预设

pgwatch2在启动时优先使用了instances.yaml中的"minimal"配置，导致只创建了部分基础监控表（如kpi和configured_dbs），而没有创建WAL等高级监控所需的表。

解决方案

1. 统一配置来源：建议只使用一种配置方式，避免冲突。pgwatch2支持通过配置文件或配置数据库两种方式管理监控目标。

2. 使用完整监控预设：如果选择使用instances.yaml文件配置，应将preset_metrics参数设置为"full"而非"minimal"。

3. 检查服务日志：重启pgwatch2服务后，应检查服务日志确认配置是否生效：

   systemctl restart pgwatch2
   journalctl -u pgwatch2 -f
   

4. 验证表创建：配置生效后，可在pgwatch2_metrics数据库中检查是否创建了所需的监控表。

技术要点

1. pgwatch2的监控表创建机制：采用按需创建策略，只有被激活的监控指标才会创建对应的存储表。

2. 配置优先级：当同时使用文件和数据库配置时，pgwatch2的行为取决于具体实现版本，建议保持一致。

3. 预设配置差异：不同预设（如minimal/basic/full）包含的监控指标数量不同，会影响创建的存储表数量。

最佳实践建议

1. 生产环境建议使用配置数据库方式管理监控目标，便于动态调整。

2. 根据监控需求选择合适的预设配置，资源充足时推荐使用full预设获取完整监控数据。

3. 部署后应验证Grafana面板是否能够正常显示所有预期的监控指标。

4. 定期检查pgwatch2服务日志，确保监控数据收集正常进行。

通过以上分析和解决方案，用户可以正确配置pgwatch2监控系统，确保所有预期的监控指标都能正常收集和展示。