gramal/postgres-exporter

Postgres Exporter 镜像

镜像概述

本镜像基于默认的https://github.com/prometheus-community/postgres_exporter#quick-start%E8%BF%9B%E8%A1%8C%E6%89%A9%E5%B1%95%EF%BC%8C%E6%B7%BB%E5%8A%A0%E4%BA%86%E9%80%9A%E8%BF%87%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E8%AE%BE%E7%BD%AE%E5%8E%9F%E6%9C%AC%E4%B8%8D%E6%94%AF%E6%8C%81%E7%9A%84Postgres Exporter参数的功能，特别适用于无法直接配置sidecar命令行参数的场景。

核心功能与特性

• 环境变量配置收集器参数：所有收集器参数可通过添加PG_EXPORTER_COLLECTOR_前缀的环境变量设置
• Web监听地址配置：支持通过PG_EXPORTER_WEB_LISTEN_ADDRESS环境变量设置--web.listen-address参数
• 兼容默认镜像：保留原postgres-exporter的所有功能，仅扩展环境变量配置能力

使用场景

主要适用于使用Zalando postgres-operator的环境，该operator目前https://github.com/zalando/postgres-operator/issues/2448%EF%BC%8C%E9%80%9A%E8%BF%87%E6%9C%AC%E9%95%9C%E5%83%8F%E5%8F%AF%E9%97%B4%E6%8E%A5%E5%AE%9E%E7%8E%B0%E5%8F%82%E6%95%B0%E9%85%8D%E7%BD%AE%E3%80%82

使用方法

环境变量说明

收集器参数

所有收集器参数可通过环境变量设置，格式为PG_EXPORTER_COLLECTOR_<参数名>=<true|false>，对应原命令行参数：

• --collector.<参数> 对应 PG_EXPORTER_COLLECTOR_<参数名>=true
• --no-collector.<参数> 对应 PG_EXPORTER_COLLECTOR_<参数名>=false

示例：

• --collector.database → PG_EXPORTER_COLLECTOR_DATABASE=true
• --no-collector.database → PG_EXPORTER_COLLECTOR_DATABASE=false
• --collector.replication_slot → PG_EXPORTER_COLLECTOR_REPLICATION_SLOT=true
• --no-collector.replication_slot → PG_EXPORTER_COLLECTOR_REPLICATION_SLOT=false

Web监听地址

通过PG_EXPORTER_WEB_LISTEN_ADDRESS设置Web监听地址，默认值为9111。

Docker运行示例

bash
docker run --rm \
  -e PG_EXPORTER_COLLECTOR_REPLICATION_SLOT=true \
  -e PG_EXPORTER_WEB_LISTEN_ADDRESS=9111 \
  gramal/postgres-exporter:latest

必要性说明

由于Zalando postgres-operator目前不支持为配置的sidecar添加命令行参数，本镜像通过环境变量映射命令行参数的方式，解决了在该场景下无法自定义postgres-exporter配置的问题。