PgBouncer 导出器

![构建状态]([***]

Prometheus的PgBouncer导出器，用于收集PgBouncer指标并在9127/metrics端点暴露。

要求

自PgBouncer导出器0.11.0起，需PgBouncer 1.8或更高版本。

构建与运行

执行以下命令构建并运行：

make build
./pgbouncer_exporter <flags>

查看所有可用配置标志：

./pgbouncer_exporter -h

PgBouncer配置

pgbouncer_exporter需要PgBouncer配置忽略一个PostgreSQL驱动连接参数。在pgbouncer.ini中需包含以下选项：

ignore_startup_parameters = extra_float_digits

使用Docker运行

docker run prometheuscommunity/pgbouncer-exporter <flags>

Docker部署示例

连接到PgBouncer实例并暴露指标端口：

docker run -d -p 9127:9127 --name pgbouncer-exporter prometheuscommunity/pgbouncer-exporter --pgbouncer.connection-string="postgres://user:password@pgbouncer-host:6432/pgbouncer?sslmode=disable"

指标

PgBouncer列	Prometheus指标	描述
stats_total_query_count	pgbouncer_stats_queries_pooled_total	池化的SQL查询总数
stats.total_query_time	pgbouncer_stats_queries_duration_seconds_total	PgBouncer主动连接PostgreSQL执行查询所花费的总秒数
stats.total_received	pgbouncer_stats_received_bytes_total	PgBouncer接收的网络流量总字节数
stats.total_requests	pgbouncer_stats_queries_total	PgBouncer池化的SQL请求总数（单位：请求）
stats.total_sent	pgbouncer_stats_sent_bytes_total	PgBouncer发送的网络流量总字节数
stats.total_wait_time	pgbouncer_stats_client_wait_seconds_total	客户端等待服务器的时间（单位：秒）
stats.total_xact_count	pgbouncer_stats_sql_transactions_pooled_total	池化的SQL事务总数
stats.total_xact_time	pgbouncer_stats_server_in_transaction_seconds_total	PgBouncer连接PostgreSQL处于事务中的总秒数（包括事务中空闲或执行查询）
pools.cl_active	pgbouncer_pools_client_active_connections	链接到服务器连接并能处理查询的客户端连接数（单位：连接）
pools.cl_waiting	pgbouncer_pools_client_waiting_connections	等待服务器连接的客户端连接数（单位：连接）
pools.sv_active	pgbouncer_pools_server_active_connections	链接到客户端连接的服务器连接数（单位：连接）
pools.sv_idle	pgbouncer_pools_server_idle_connections	空闲且准备处理客户端查询的服务器连接数（单位：连接）
pools.sv_used	pgbouncer_pools_server_used_connections	空闲时间超过server_check_delay、需执行server_check_query的服务器连接数（单位：连接）
pools.sv_tested	pgbouncer_pools_server_testing_connections	正在运行server_reset_query或server_check_query的服务器连接数（单位：连接）
pools.sv_login	pgbouncer_pools_server_login_connections	正在登录过程中的服务器连接数（单位：连接）
pools.maxwait	pgbouncer_pools_client_maxwait_seconds	最旧未服务客户端连接的存在时间（单位：秒）
config.max_client_conn	pgbouncer_config_max_client_connections	配置的最大客户端连接数
config.max_user_connections	pgbouncer_config_max_user_connections	配置的每用户最大服务器连接数