jmccarty3/prometheus-pgbouncer-exporter

Prometheus PgBouncer Exporter 镜像

镜像概述

本镜像基于 https://github.com/spreaker/prometheus-pgbouncer-exporter 的自动化分支构建，用于采集PgBouncer（PostgreSQL连接池）实例的运行指标，并以Prometheus可抓取的格式暴露，帮助用户监控PgBouncer的连接状态、流量及性能。

核心功能

• 支持监控多个PgBouncer实例（适配高负载场景下多进程部署需求）
• 允许为每个实例配置额外标签，便于区分不同实例的指标
• 可设置PgBouncer连接超时时间
• 通过include_databases和exclude_databases过滤需导出指标的数据库

使用场景

• 高负载环境中监控多进程部署的PgBouncer实例（如每CPU核心一个实例）
• 实时跟踪PgBouncer的连接数、查询量、网络流量等关键指标
• 集成到Prometheus+Grafana体系，实现PgBouncer状态可视化

配置说明

配置文件格式

通过YAML文件配置Exporter监听信息及待监控实例：

yaml
# Exporter监听地址（默认127.0.0.1）
exporter_host: 0.0.0.0
# Exporter监听端口（默认9100）
exporter_port: 9100
# 待监控的PgBouncer实例列表
pgbouncers:
  - dsn: postgresql://pgbouncer:$(PGBOUNCER_PASS)@localhost:6431/pgbouncer
    connect_timeout: 5
    exclude_databases: [pgbouncer]
    extra_labels: {pool_id: 1}
  - dsn: postgresql://pgbouncer:$(PGBOUNCER_PASS)@localhost:6432/pgbouncer
    exclude_databases: [pgbouncer]
    extra_labels: {pool_id: 2}

说明：配置支持环境变量替换（如$(PGBOUNCER_PASS)会替换为对应环境变量的值）。

Docker部署示例

单实例运行

bash
docker run -d \
  --name pgbouncer-exporter \
  -p 9100:9100 \
  -v /path/to/your/config.yml:/app/config.yml \
  -e PGBOUNCER_PASS=your_pgbouncer_password \
  docker.xuanyuan.run/jmccarty3/prometheus-pgbouncer-exporter \
  --config /app/config.yml

Docker Compose示例

yaml
version: '3'
services:
  pgbouncer-exporter:
    image: docker.xuanyuan.run/jmccarty3/prometheus-pgbouncer-exporter
    ports:
      - "9100:9100"
    volumes:
      - ./config.yml:/app/config.yml
    environment:
      - PGBOUNCER_PASS=your_pgbouncer_password
    command: ["--config", "/app/config.yml"]

许可协议

本软件基于MIT许可协议发布。