Когда pg_wait_sampling работает, показания снимаются по умолчанию каждые 10 мс. Обратиться к собранной статистике вы можете через набор функций и представлений. Если вы замечаете, что некоторые запросы «зависли» или выполняются дольше, чем ожидается, вы можете увидеть все текущие события ожидания в представлении pg_wait_sampling_current:

SELECT * FROM pg_wait_sampling_current;

Возвращаемая статистика охватывает все активные процессы, включая фоновые рабочие процессы. Чтобы отфильтровать это представление по одному процессу, воспользуйтесь функцией pg_wait_sampling_get_current() и передайте ей идентификатор интересующего процесса:

SELECT * FROM pg_wait_sampling_get_current(pid);

Параметр конфигурации pg_wait_sampling.history_dimensions определяет, какие столбцы заполняются в этом представлении. По умолчанию представление содержит значения для pid, event и queryid, а остальные столбцы содержат NULL.

Чтобы лучше понимать динамику недавних событий ожидания, можно обратиться к представлению pg_wait_sampling_history, показывающему историю событий ожидания для последних процессов:

SELECT * FROM pg_wait_sampling_history;

Это представление содержит показатели по событиям ожидания в с отметками времени. Параметр pg_wait_sampling.history_dimensions определяет, какие столбцы заполняются в этом представлении. По умолчанию представление содержит значения для pid, event и queryid, а остальные столбцы содержат NULL.

История ожиданий реализована как кольцевой буфер в памяти, размер которого по умолчанию ограничен 5000 показаниями. Чтобы сохранить историю за больший период времени, вы можете изменить переменную pg_wait_sampling.history_size либо подключить клиентское приложение, которое будет периодически считывать историю ожиданий и сохранять её в локальном хранилище.

Для отслеживания событий ожидания в вашей базе данных в течение длительного времени используйте представление pg_wait_sampling_profile:

SELECT * FROM pg_wait_sampling_profile;

Профиль ожиданий сохраняется как хеш-таблица в памяти, накапливающая показатели по отдельным процессам и по событиям ожидания. Вы можете сбросить профиль ожиданий, вызвав функцию pg_wait_sampling_reset_profile(). Если вы подключите к вашей базе данных клиента, который будет периодически сбрасывать данные событий ожидания и очищать профиль, вы можете сохранять и анализировать концентрацию событий ожидания во времени.

Если вас не интересует распределение событий ожидания по процессам, вы можете присвоить переменной pg_wait_sampling.profile_pid false. В этом случае значение pid для всех процессов считается равным нулю и показатели ожиданий для всех процессов аккумулируются вместе.

С помощью параметра конфигурации pg_wait_sampling.profile_dimensions можно настроить, какие измерения собираются для выборок событий ожидания в профиле. Например, можно собирать информацию о базе данных, пользователе, адресе клиента, приложении или времени начала сеанса. Полный список возможных измерений приведён в pg_wait_sampling.profile_dimensions.

Помимо представлений, описанных выше, pg_wait_sampling предоставляет агрегированную статистику событий ожидания, сгруппированную по операторам или объектам:

Чтобы просмотреть статистику событий ожидания, сгруппированную по идентификаторам запросов и планов, используйте представление pg_wait_sampling_statements:

SELECT * FROM pg_wait_sampling_statements;

Это представление выдаёт агрегированный профиль событий ожидания для каждой уникальной комбинации queryid и planid. За подробной информацией обратитесь к Подразделу F.66.3.2.4.

Чтобы просмотреть статистику событий ожидания для настраиваемых измерений, таких как база данных, пользователь, адрес клиента или приложение, используйте представление pg_wait_sampling_objects:

SELECT * FROM pg_wait_sampling_objects;

Параметр pg_wait_sampling.profile_dimensions определяет, какие измерения собираются для выборок событий ожидания в этом представлении. За подробной информацией обратитесь к Подразделу F.66.3.2.5.

Поведение расширения pg_wait_sampling настраивается с помощью переменных GUC, которые хранятся в локальной памяти. Изменить их можно в файле postgresql.conf или при помощи команды ALTER SYSTEM. Чтобы изменения вступили в силу, перезагрузите конфигурацию сервера. Это можно сделать, например, вызвав функцию pg_reload_conf() или выполнив команду pg_ctl reload.