PostgreSQL Exporter配置问题排查与解决方案

问题背景

在使用Prometheus社区维护的PostgreSQL Exporter时，用户可能会遇到"target is required"的错误提示。这种情况通常发生在尝试通过curl命令获取指标数据时，系统提示需要指定目标参数，但用户并不清楚如何正确配置。

错误现象

当用户按照标准方式启动PostgreSQL Exporter容器后，尝试通过/probe端点获取指标时，会收到"target is required"的错误响应。这表明Exporter期望接收一个目标参数，但用户并未提供。

根本原因分析

PostgreSQL Exporter支持两种工作模式：

1. 单目标模式：直接监控一个指定的PostgreSQL实例
2. 多目标模式：通过参数动态指定要监控的PostgreSQL实例

当用户尝试访问/probe端点时，Exporter默认进入多目标模式，因此要求提供目标参数。而用户实际需要的是单目标模式，即直接监控预先配置好的数据库实例。

正确配置方法

要实现单目标监控，应采用以下配置方式：

1. 环境变量配置：

   podman run --net=host \
     -e DATA_SOURCE_URI='pgsql-host:5432/postgres?sslmode=disable' \
     -e DATA_SOURCE_USER=monitoring-user \
     -e DATA_SOURCE_PASS=monitoring-password \
     quay.io/prometheuscommunity/postgres-exporter
   

2. 指标获取端点： 使用/metrics而非/probe端点来获取指标数据：

   curl http://localhost:9187/metrics
   

关键配置参数说明

• DATA_SOURCE_URI：指定PostgreSQL服务器的连接URI，包括主机名、端口和数据库名
• DATA_SOURCE_USER：监控专用用户名
• DATA_SOURCE_PASS：监控用户密码
• sslmode=disable：禁用SSL连接（生产环境应考虑启用SSL）

权限配置建议

为确保Exporter能正常获取监控数据，PostgreSQL数据库用户需要以下权限：

• pg_monitor角色
• pg_read_all_stats权限

验证方法

成功配置后，通过curl获取的指标数据应包含类似以下内容：

pg_database_size_bytes{datname="postgres"} 7.5117027e+07
pg_database_size_bytes{datname="template0"} 7.520783e+06
pg_database_size_bytes{datname="template1"} 7.754211e+06

总结

理解PostgreSQL Exporter的两种工作模式对于正确配置至关重要。对于大多数单实例监控场景，使用单目标模式并通过/metrics端点获取数据是最简单直接的解决方案。正确配置连接参数和环境变量后，Exporter将能够顺利采集并暴露PostgreSQL数据库的各项性能指标。