§ PgBouncer. Admin console cheatsheet.

список команд управления PgBouncer.

Консоль управления доступна в виде отдельной базы именуемой pgbouncer

Доступ к ней имеют пользователи прописанные в директивах admin_users и stats_users.  В нашем случае это будет postgres. Исключением является вариант настройки при auth_mode=any, в таком случае все пользователи имеют административные привилегии.

$ psql -p 6543 -U postgres pgbouncer

show stats; - показ общей статистики:

• database - статистика по конкретной базе;
• total_requests - количество запросов обработанное pgbouncer;
• total_received - объем трафика принятый pgbouncer;
• total_sent - отправленный pgbouncer объем трафика;
• total_query_time - время проведенное pgbouncer в подключенном состоянии с postgresql (в микросекундах);
• avg_req - среднее количество запросов за последний отчетный период;
• avg_recv - средний объем принятых данных  (байт в секунду);
• avg_sent - средний объем отправленных данных (байт в секунду);
• avg_query - средняя продолжительность запроса в микросекундах.

show servers/clients; информация о подключенных серверах/клиентах:

• type - тип, S значит сервер, С - клиент;
• user - имя используемое в подключении;
• database - имя базы данных;
• state - состояние подключения (active, used, idle);
• addr - ip-адрес сервера/клиента;
• port - порт сервера/клиента;
• local_addr - используемый локальный адрес;
• local_port - используемый локальный порт;
• connect_time - когда выполнено подключение;
• request_time - время последнего запроса;
• ptr - внутренний указатель соединения;
• link - адрес клиентского подключения с которым связан сервер.

show pools; - информация о пулах:

• database - имя базы;
• user - используемый пользователь;
• cl_active - текущее количество активных клиентских подключений;
• cl_waiting - текущее количество клиентских подключений находящихся в ожидании (заняты все соединения в пуле = плохо!);
• sv_active - текущее количество активных серверных подключений;
• sv_idle - текущее количество простаиваемых серверных подключений;
• sv_used - текущее количество используемых серверных подключений;
• sv_tested - текущее количество тестовых серверных подключений;
• sv_login - текущее количество серверных подключений выполнивших login в PostgreSQL;
• maxwait - время ожидания самого первого клиента в очереди. Увеличивающееся значение говорит о том что пул не успевает освбодиться и нужно увеличить количество соединений в нем.

show lists; - показ внутренней информации:

• databases - количество баз данных;
• users - количество клиентов;
• pools - количество пулов;
• free_clients - количество свободных слотов под клиентские соединения;
• used_clients - количество используемых слотов под клиентские соединения;
• login_clients - количество слотов занятых клиентами выполняющими вход в PostgreSQL;
• free_servers - количество свободных слотов под соединения с сервером;
• used_servers - количество используемых слотов для серверных подключений.

show users; - показ пользователей по одному в строку:

• show databases; - показ информации о базах;
• name - имя в конфигурации;
• host - адрес подключения;
• port - порт подключения;
• database - имя базы к которой выполняется подключение;
• force_user - имя пользователя используемое при подключении;
• pool_size - максимальное число серверных подключений.

show fds; - показ списка используемых файловых дескрипторов:

• fd - числовое значение дескриптора;
• task - ассоциированая задача (pooler, client, server);
• user - пользователь использующий дескриптор;
• database - база используемая в подключении;
• addr - ip-адрес соединения или "unix" если это подключение через сокет;
• port - порт используемый в соединении;
• cancel - ключ отмены соединения;
• link - дескриптор для отвечающего сервера/клиента.

show config; - показ параметров конфигурации:

• key - имя параметра;
• value - значение параметра;
• changeable - возможность изменения на лету.

show dns_hosts; - показать имена хостов в DNS кэше:

• hostname - имя хоста;
• ttl - количество секунд до следующего просмотра;
• addrs - список адресов;

show dns_zones; - просмотр DNS зон в кэше:

• zonename - имя зоны;
• serial - текущий серийный номер;
• count - адреса принадлежащие зоне.

pause [database]; - pgbouncer ждет завершения запросов и выполняет отключение от всех серверов. Используется при перезапуске сервера с бд.

kill db; - немедленно завершает все клиентские и серверные соединения.

suspend; - pgbouncer выполняет очистку всех буферов и затем останавливает прием данных. Используется при перезагрузке pgbouncer на лету.

resume [db]; - возобновление работы после pause или suspend команд.

shutdown; - остановка и выход pgbouncer

reload; - pgbouncer выполняет перезагрузку конфигурации и обновляет изменяемые параметры.

На главную "Virtualizing Linux"