Mostrar pools, estatísticas e conexões do PgBouncer (SHOW POOLS/STATS/CLIENTS/SERVERS)

Comando

# Connect to the PgBouncer admin console (user must be in admin_users/stats_users):
psql -h 127.0.0.1 -p 6432 -U pgbouncer -d pgbouncer -X
SHOW POOLS;    -- if cl_waiting > 0 and maxwait grows, the pool is saturated
SHOW STATS;    -- per-database total/average query, transaction and wait times
SHOW CLIENTS;  -- client connections (state, source address, linked server connection)
SHOW SERVERS;  -- server connections opened to PostgreSQL
SHOW CONFIG;

O que faz

Para cada pool de banco/usuário, mostra os clientes ativos e em espera (cl_active, cl_waiting), as conexões de servidor ativas/ociosas (sv_active, sv_idle), o maior tempo de espera (maxwait) e os contadores de consultas/transações.

Quando usar

Quando a aplicação relata falhas/timeouts de conexão, para dimensionar pools e para ver as conexões ativas antes de uma manutenção.

Atenção

O console de administração não aceita SQL; executa apenas comandos do PgBouncer. Se cl_waiting continuar alto, verifique primeiro o lado do servidor em busca de transações longas ou locks; aumentar default_pool_size às cegas empurra o PostgreSQL para o limite de max_connections e para pressão de memória. Os valores de SHOW STATS são cumulativos; as médias se referem ao intervalo stats_period.