Показать пулы, статистику и подключения PgBouncer (SHOW POOLS/STATS/CLIENTS/SERVERS)

Команда

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

Что делает

Для каждого пула базы данных/пользователя показывает активных и ожидающих клиентов (cl_active, cl_waiting), активные/простаивающие серверные подключения (sv_active, sv_idle), наибольшее время ожидания (maxwait) и счётчики запросов/транзакций.

Когда использовать

Когда приложение сообщает о сбоях подключения/тайм-аутах, для определения размера пула и чтобы увидеть активные подключения перед обслуживанием.

Внимание

Консоль администратора не принимает SQL; она выполняет только команды PgBouncer. Если cl_waiting остаётся высоким, сначала проверьте серверную сторону на долгие транзакции или блокировки; слепое увеличение default_pool_size подталкивает PostgreSQL к лимиту max_connections и нехватке памяти. Значения SHOW STATS накопительные; средние относятся к интервалу stats_period.