Afficher les pools, statistiques et connexions PgBouncer (SHOW POOLS/STATS/CLIENTS/SERVERS)

Commande

# 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;

Ce que fait la commande

Pour chaque pool base/utilisateur, affiche les clients actifs et en attente (cl_active, cl_waiting), les connexions serveur actives/inactives (sv_active, sv_idle), le temps d'attente le plus long (maxwait) et les compteurs de requêtes/transactions.

Quand l'utiliser

Lorsque l'application signale des échecs/timeouts de connexion, pour dimensionner les pools, et pour voir les connexions actives avant une maintenance.

Attention

La console d'administration n'accepte pas le SQL ; elle n'exécute que des commandes PgBouncer. Si cl_waiting reste élevé, vérifiez d'abord côté serveur les transactions longues ou les verrous ; augmenter aveuglément default_pool_size pousse PostgreSQL vers sa limite max_connections et une pression mémoire. Les valeurs de SHOW STATS sont cumulées ; les moyennes portent sur l'intervalle stats_period.