jbub/pgbouncer_exporter

镜像概述

该镜像提供了一个Prometheus导出器，专门用于从Pgbouncer（PostgreSQL连接池）收集性能指标并将其暴露给Prometheus监控系统。通过该导出器，用户可以实时监控Pgbouncer的连接池状态、资源使用情况及性能表现，助力数据库基础设施的可观测性建设。

核心功能与特性

• 指标收集：从Pgbouncer的管理接口（通常为pgbouncer数据库）收集关键指标，包括连接数（客户端连接、服务器连接、空闲连接）、池状态（活跃池、等待队列长度）、查询统计（总查询数、平均查询耗时）等。
• Prometheus兼容：以Prometheus标准格式（OpenMetrics）暴露指标，默认端点为/metrics，支持Prometheus直接拉取。
• 轻量级设计：资源占用低，部署简单，可快速集成到现有监控架构。
• 配置灵活：支持通过环境变量自定义Pgbouncer连接参数（地址、端口、认证信息）及导出器监听端口。

使用场景

• Pgbouncer监控：在使用Pgbouncer作为PostgreSQL连接池的生产环境中，需监控其连接池效率、资源瓶颈时使用。
• 数据库性能观测：结合Prometheus和Grafana，构建Pgbouncer指标的可视化面板，实现连接池性能趋势分析与告警。
• DevOps与SRE实践：作为数据库基础设施监控链的一部分，辅助排查连接超时、池耗尽等问题。

使用方法

基本部署（Docker Run）

通过以下命令启动导出器，需替换环境变量值为实际Pgbouncer配置：

bash
docker run -d \
  --name pgbouncer-exporter \
  -e PGBOUNCER_HOST=pgbouncer-service  \  # Pgbouncer服务地址（必填）
  -e PGBOUNCER_PORT=6432               \  # Pgbouncer端口（默认6432，可选）
  -e PGBOUNCER_USER=pgbouncer          \  # Pgbouncer管理用户（通常为pgbouncer，必填）
  -e PGBOUNCER_PASSWORD=your-password  \  # Pgbouncer管理用户密码（若启用认证则必填）
  -e LISTEN_PORT=9127                  \  # 导出器监听端口（默认9127，可选）
  -p 9127:9127                         \  # 映射导出器端口到主机
  [镜像名称]  # 替换为实际镜像名称（如prometheuscommunity/pgbouncer-exporter）

环境变量配置

Prometheus集成

在Prometheus配置文件（prometheus.yml）中添加如下scrape_config，拉取导出器指标：

yaml
scrape_configs:
  - job_name: 'pgbouncer'
    static_configs:
      - targets: ['<导出器IP或容器名>:9127']  # 替换为导出器实际地址（如宿主机IP:9127或pgbouncer-exporter:9127）
    scrape_interval: 10s  # 指标拉取间隔，根据监控精度需求调整

重启Prometheus后，即可在Prometheus UI中查询pgbouncer_*前缀的指标（如pgbouncer_client_connections、pgbouncer_server_connections）。