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

问题背景

在使用PostgreSQL Exporter进行数据库监控时，用户可能会遇到"target is required"的错误提示。这种情况通常发生在尝试通过HTTP接口获取指标数据时，表明Exporter未能正确识别监控目标。

错误现象

当用户按照文档说明启动PostgreSQL Exporter容器后，使用curl命令访问/probe端点时，系统返回"target is required"的错误信息，且Exporter日志中未显示任何数据库连接尝试。

原因分析

这个问题的根源在于对PostgreSQL Exporter两种不同运行模式的理解不足：

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

当用户使用DATA_SOURCE_NAME环境变量配置数据库连接时，实际上是在使用单目标模式，此时应该访问/metrics端点而非/probe端点。/probe端点是专为多目标模式设计的，需要额外指定target参数。

解决方案

正确配置单目标模式

对于大多数只需要监控单个PostgreSQL实例的场景，推荐使用以下配置方式：

1. 使用DATA_SOURCE_URI、DATA_SOURCE_USER和DATA_SOURCE_PASS三个环境变量分别配置连接信息：

   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端点获取指标数据：

   curl http://localhost:9187/metrics
   

多目标模式说明

如果确实需要使用多目标模式（通过一个Exporter监控多个PostgreSQL实例），则需要：

1. 确保Exporter以多目标模式运行
2. 访问/probe端点时附带target参数：

   curl http://localhost:9187/probe?target=pgsql-host:5432
   

最佳实践建议

1. 权限配置：确保监控用户具有pg_monitor和pg_read_all_stats角色权限
2. 连接安全：生产环境应考虑使用SSL加密连接
3. 指标验证：首次部署后，建议手动访问/metrics端点验证指标是否正常采集
4. 日志监控：关注Exporter日志中的警告和错误信息

总结

PostgreSQL Exporter提供了灵活的监控方案，但需要根据实际使用场景选择合适的配置方式。对于大多数单实例监控需求，使用单目标模式并通过/metrics端点获取数据是最简单可靠的方式。理解不同模式的区别和适用场景，可以避免"target is required"这类常见配置问题。