sourcemation/postgres-exporter

Prometheus PostgreSQL Exporter 容器

该镜像提供了一个 robust 的 postgres-exporter 环境，专为 Prometheus 设计。它用于导出 PostgreSQL 的各类指标以进行监控，包括性能、资源利用率和运行健康状况。镜像配置灵活，允许对收集的指标进行广泛自定义。

由 Sourcemation 维护，此 postgres_exporter 发行版定期更新，确保其时效性和安全性。它是一个轻量级且专注的容器，旨在轻松集成到现有的 Prometheus 和 PostgreSQL 监控栈中。

核心功能

• 广泛的 PostgreSQL 指标：从 PostgreSQL 服务器收集大量指标，并支持添加自定义查询。
• 高度可配置：通过环境变量和命令行参数微调 exporter 的行为。
• 自动数据库发现：可配置为自动发现并监控 PostgreSQL 实例中的所有数据库。
• Prometheus 集成：以 Prometheus 可抓取的格式暴露指标，便于集成到现有监控和告警工作流中。

操作使用

该镜像适用于需要监控 PostgreSQL 的生产环境。必须配置 PostgreSQL 服务器的连接详情。

本地非生产测试示例：

bash
# 启动示例数据库
docker run --net=host -it --rm -e POSTGRES_PASSWORD=password docker.xuanyuan.run/postgres

# 连接数据库
docker run \
  --net=host \
  -e DATA_SOURCE_URI="localhost:5432/postgres?sslmode=disable" \
  -e DATA_SOURCE_USER=postgres \
  -e DATA_SOURCE_PASS=password \
  docker.xuanyuan.run/sourcemation/postgres-exporter

# 测试指标
curl "http://localhost:9187/metrics"

关键环境变量

容器使用以下环境变量进行配置：

• DATA_SOURCE_NAME：默认的传统格式。接受 URI 形式和 key=value 形式的参数。URI 可包含连接所需的用户名和密码。
• DATA_SOURCE_URI：DATA_SOURCE_NAME 的替代方案，仅接受不含用户名和密码的主机名。例如：my_pg_hostname 或 my_pg_hostname:5432/postgres?sslmode=disable。
• DATA_SOURCE_USER：使用 DATA_SOURCE_URI 时，此环境变量用于指定用户名。
• DATA_SOURCE_PASS：使用 DATA_SOURCE_URI 时，此环境变量用于指定连接密码。
• DATA_SOURCE_PASS_FILE：与上述相同，但从文件读取密码。

有关完整的环境变量和配置选项列表，请参考 https://github.com/prometheus-community/postgres_exporter。

端口暴露

默认暴露标准的 postgres-exporter 端口 9187。指标可在 /metrics 端点获取。

贡献和问题报告

您的贡献非常有价值！欢迎通过在 Sourcemation GitHub 仓库提交 issue 提出增强建议或请求新镜像，或通过 pull request 提交您的贡献。

• https://github.com/Sourcemation/images/issues/new/choose
• https://github.com/Sourcemation/images/compare

额外说明

免责声明：sourcemation/postgres-exporter 镜像与 prometheus-community 无关联。所提及的商标归各自实体所有。sourcemation/postgres-exporter 镜像是一个独立项目，由 https://sourcemation.com 维护。

镜像及其组件风险分析报告

有关镜像及其组件的详细风险分析报告，可在 https://www.sourcemation.com/products/b95ab2de-202b-45f2-a2a3-086e64968979/deployments 上找到。

更多信息，请查看 https://github.com/prometheus-community/postgres_exporter 页面。

许可证

解决方案（postgres_exporter）的基础许可证为 https://github.com/prometheus-community/postgres_exporter?tab=Apache-2.0-1-ov-file#readme。