Mostrar pools, estadísticas y conexiones de 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;

Qué hace

Para cada pool de base de datos/usuario, muestra los clientes activos y en espera (cl_active, cl_waiting), las conexiones de servidor activas/inactivas (sv_active, sv_idle), el mayor tiempo de espera (maxwait) y los contadores de consultas/transacciones.

Cuándo usarlo

Cuando la aplicación informa de fallos/timeouts de conexión, para dimensionar el pool y para ver las conexiones activas antes de un mantenimiento.

Precaución

La consola de administración no acepta SQL; solo ejecuta comandos de PgBouncer. Si cl_waiting se mantiene alto, revise primero en el lado del servidor si hay transacciones largas o bloqueos; subir a ciegas default_pool_size empuja a PostgreSQL hacia su límite de max_connections y a presión de memoria. Los valores de SHOW STATS son acumulados; los promedios se refieren al intervalo stats_period.