28.2. Сборщик статистики

Сборщик статистики в PostgreSQL представляет собой подсистему, которая собирает и отображает информацию о работе сервера. В настоящее время сборщик может подсчитывать количество обращений к таблицам и индексам — в виде количества прочитанных блоков или строк с диска. Кроме того, он отслеживает общее число строк в каждой таблице, информацию о выполнении очистки и сбора статистики для каждой таблицы. Он также может подсчитывать вызовы пользовательских функций и общее время, затраченное на выполнение каждой из них.

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

28.2.1. Конфигурация системы сбора статистики

Поскольку сбор статистики несколько увеличивает накладные расходы при выполнении запроса, есть возможность настроить СУБД так, чтобы выполнять или не выполнять сбор статистической информации. Это контролируется конфигурационными параметрами, которые обычно устанавливаются в файле postgresql.conf. (Подробно установка конфигурационных параметров описывается в Главе 20.)

Параметр track_activities включает мониторинг текущих команд, выполняемой любым серверным процессом.

Параметр track_counts определяет необходимость сбора статистики по обращениям к таблицам и индексам.

Параметр track_functions включает отслеживание использования пользовательских функций.

Параметр track_io_timing включает мониторинг времени чтения и записи блоков.

Параметр track_wal_io_timing включает мониторинг времени записи WAL.

Обычно эти параметры устанавливаются в postgresql.conf, поэтому они применяются ко всем серверным процессам, однако, используя команду SET, их можно включать и выключать в отдельных сеансах. (Для того чтобы обычные пользователи не скрывали свою работу от администратора СУБД, изменять эти параметры с помощью команды SET могут только суперпользователи.)

Сборщик статистики использует временные файлы для передачи собранной информации другим процессам PostgreSQL. Имя каталога, в котором хранятся эти файлы, задаётся параметром stats_temp_directory, по умолчанию он называется pg_stat_tmp. Для повышения производительности stats_temp_directory может указывать на каталог, расположенный в оперативной памяти, что сокращает время физического ввода/вывода. При остановке сервера постоянная копия статистической информации сохраняется в подкаталоге pg_stat, поэтому статистику можно хранить на протяжении нескольких перезапусков сервера. Когда восстановление выполняется при запуске сервера (например, после непосредственного завершения работы, катастрофического отказа сервера, и восстановлении на заданную точку во времени), все статистические данные счётчиков сбрасываются.

28.2.2. Просмотр статистики

Для просмотра текущего состояния системы предназначены несколько предопределённых представлений, которые перечислены в Таблице 28.1. В дополнение к ним есть несколько других представлений, перечисленных в Таблице 28.2, позволяющих просмотреть результаты сбора статистики. Кроме того, на базе нижележащих статистических функций можно создать собственные представления, как описано в Подразделе 28.2.22.

Наблюдая собранные данные в сборщике статистики, важно понимать, что эта информация обновляется не сразу. Каждый серверный процесс передаёт новые статистические данные сборщику статистики непосредственно перед переходом в режим ожидания; то есть запрос или транзакция в процессе выполнения не влияют на отображаемые данные статистики. К тому же, сам сборщик статистики формирует новый отчёт не чаще, чем раз в PGSTAT_STAT_INTERVAL миллисекунд (500 мс, если этот параметр не изменялся при компиляции сервера). Так что отображаемая информация отстаёт от того, что происходит в настоящий момент. Однако информация о текущем запросе, собираемая с параметром track_activities, всегда актуальна.

Ещё одним важным моментом является то, что когда в серверном процессе запрашивают какую-либо статистику, сначала он получает наиболее свежий моментальный снимок от сборщика статистики и затем до окончания текущей транзакции использует этот снимок для всех статистических представлений и функций. Так что на протяжении одной транзакции статистическая информация меняться не будет. Подобным же образом информация о текущих запросах во всех сеансах собирается в тот момент, когда она впервые запрашивается в рамках транзакции, и эта же самая информация будет отображаться на протяжении всей транзакции. Это не ошибка, а полезное свойство СУБД, поскольку оно позволяет выполнять запросы к статистическим данным и сравнивать результаты, не беспокоясь о том, что статистические данные изменяются. Но если для каждого запроса вам нужны новые результаты, то их следует выполнять вне любых транзакционных блоков. Или же можно вызывать функцию pg_stat_clear_snapshot(), которая сбросит ранее полученный снимок статистики в текущей транзакции (если он был). При следующем обращении к статистической информации будет сформирован новый моментальный снимок.

Через представления pg_stat_xact_all_tables, pg_stat_xact_sys_tables, pg_stat_xact_user_tables, и pg_stat_xact_user_functions транзакции также доступна её собственная статистика (ещё не переданная сборщику статистики). Данные в этих представлениях ведут себя не так, как описано выше; наоборот, в течение транзакции они постоянно обновляются.

Часть информации в представлениях с динамическими статистическими данными, перечисленных в Таблице 28.1 скрыта по соображениям безопасности. Обычные пользователи могут получать информацию только о своих собственных сеансах (сеансах, принадлежащих роли, членами которой они являются). В строках, относящимся к другим сеансам, многие столбцы будут содержать NULL. Заметьте однако, что информация о самом сеансе и его общих свойствах, например, текущем пользователе и базе данных, доступна всем пользователям. Суперпользователи и члены встроенной роли pg_read_all_stats (см. также Раздел 22.5) могут получить всю информацию о любом сеансе.

Таблица 28.1. Динамические статистические представления

Имя представленияОписание
pg_stat_activity Одна строка для каждого серверного процесса c информацией о текущей активности процесса, включая его состояние и текущий запрос. Подробности в pg_stat_activity.
pg_stat_replicationПо одной строке для каждого процесса-передатчика WAL со статистикой по репликации на ведомом сервере, к которому подключён этот процесс. Подробности в pg_stat_replication.
pg_stat_wal_receiverТолько одна строка со статистикой приёмника WAL, полученной с сервера, на котором работает приёмник. Подробности в pg_stat_wal_receiver.
pg_stat_subscriptionКак минимум одна строка для подписки, сообщающая о рабочих процессах подписки. Подробности в pg_stat_subscription.
pg_stat_sslОдна строка для каждого подключения (обычного и реплицирующего), в которой показывается информация об использовании SSL для данного подключения. Подробности в pg_stat_ssl.
pg_stat_gssapiОдна строка для каждого подключения (обычного и реплицирующего), в которой показывается информация об использовании аутентификации и шифровании GSSAPI для данного подключения. Подробности в pg_stat_gssapi.
pg_stat_progress_analyzeПо одной строке с текущим состоянием для каждого обслуживающего процесса (включая рабочие процессы автоочистки), в котором работает ANALYZE. См. Подраздел 28.4.1.
pg_stat_progress_create_indexПо одной строке с текущим состоянием для каждого обслуживающего процесса, в котором выполняется CREATE INDEX или REINDEX. См. Подраздел 28.4.2.
pg_stat_progress_vacuumПо одной строке с текущим состоянием для каждого обслуживающего процесса (включая рабочие процессы автоочистки), в котором работает VACUUM. См. Подраздел 28.4.3.
pg_stat_progress_clusterПо одной строке с текущим состоянием для каждого обслуживающего процесса, в котором выполняется CLUSTER или VACUUM FULL. См. Подраздел 28.4.4.
pg_stat_progress_basebackupПо одной строке с текущим состоянием для каждого передающего WAL процесса, транслирующего базовую копию. См. Подраздел 28.4.5.
pg_stat_progress_copyПо одной строке с текущим состоянием для каждого обслуживающего процесса, в котором выполняется COPY. См. Подраздел 28.4.6.

Таблица 28.2. Представления собранной статистики

Имя представленияОписание
pg_stat_archiverТолько одна строка со статистикой работы процесса архивации WAL. Подробности в pg_stat_archiver.
pg_stat_bgwriterТолько одна строка со статистикой работы фонового процесса записи. Подробности в pg_stat_bgwriter.
pg_stat_walТолько одна строка со статистикой работы WAL. Подробности в pg_stat_wal.
pg_stat_databaseОдна строка для каждой базы данных со статистикой на уровне базы. Подробности в pg_stat_database.
pg_stat_database_conflictsПо одной строке на каждую базу данных со статистикой по отменам запросов, выполненным вследствие конфликта с процессами восстановления на ведомых серверах. Подробности в pg_stat_database_conflicts.
pg_stat_all_tablesПо одной строке на каждую таблицу в текущей базе данных со статистикой по обращениям к этой таблице. Подробности в pg_stat_all_tables.
pg_stat_sys_tablesАналогично pg_stat_all_tables, за исключением того, что отображаются только системные таблицы.
pg_stat_user_tablesАналогично pg_stat_all_tables, за исключением того, что отображаются только пользовательские таблицы.
pg_stat_xact_all_tablesПодобно pg_stat_all_tables, но подсчитывает действия, выполненные в текущей транзакции к настоящему моменту (которые ещё не вошли в pg_stat_all_tables и связанные представления). Столбцы для числа живых и мёртвых строк, а также количества операций очистки и сбора статистики, в этом представлении отсутствуют.
pg_stat_xact_sys_tablesАналогично pg_stat_xact_all_tables, за исключением того, что отображаются только системные таблицы.
pg_stat_xact_user_tablesАналогично pg_stat_xact_all_tables, за исключением того, что отображаются только пользовательские таблицы.
pg_stat_all_indexesПо одной строке для каждого индекса в текущей базе данных со статистикой по обращениям к этому индексу. Подробности в pg_stat_all_indexes.
pg_stat_sys_indexesАналогично pg_stat_all_indexes, за исключением того, что показываются только индексы по системным таблицам.
pg_stat_user_indexesАналогично pg_stat_all_indexes, за исключением того, что показываются только индексы по пользовательским таблицам.
pg_statio_all_tablesПо одной строке для каждой таблицы в текущей базе данных со статистикой по операциям ввода/вывода с этой таблицей. Подробности в pg_statio_all_tables.
pg_statio_sys_tablesАналогично pg_statio_all_tables, за исключением того, что показываются только системные таблицы.
pg_statio_user_tablesАналогично pg_statio_all_tables, за исключением того, что показываются только пользовательские таблицы.
pg_statio_all_indexesПо одной строке для каждого индекса в текущей базе данных со статистикой по операциям ввода/вывода для этого индекса. Подробности в pg_statio_all_indexes.
pg_statio_sys_indexesАналогично pg_statio_all_indexes, за исключением того, что показываются только индексы по системным таблицам.
pg_statio_user_indexesАналогично pg_statio_all_indexes, за исключением того, что показываются только индексы по пользовательским таблицам.
pg_statio_all_sequencesПо одной строке для каждой последовательности в текущей базе данных со статистикой по операциям ввода/вывода с этой последовательностью. Подробности в pg_statio_all_sequences.
pg_statio_sys_sequencesАналогично pg_statio_all_sequences, за исключением того, что показываются только системные последовательности. (В настоящее время системных последовательностей нет, поэтому это представление всегда пусто.)
pg_statio_user_sequencesАналогично pg_statio_all_sequences, за исключением того, что показываются только пользовательские последовательности.
pg_stat_user_functionsПо одной строке для каждой отслеживаемой функции со статистикой по выполнениям этой функции. Подробности в pg_stat_user_functions.
pg_stat_xact_user_functionsАналогично pg_stat_user_functions, однако подсчитываются только вызовы функций, выполненные в текущей транзакции (которые ещё не были включены в pg_stat_user_functions).
pg_stat_slruОдна строка со статистикой работы для каждого SLRU-кеша. Подробности в pg_stat_slru.
pg_stat_replication_slotsПо одной строке со статистикой по использованию слота репликации для каждого такого слота. Подробности в pg_stat_replication_slots.

Статистика по отдельным индексам особенно полезна для определения того, какие индексы используются и насколько они эффективны.

Представления pg_statio_ полезны, прежде всего, для определения эффективности буферного кеша. Если количество фактических дисковых чтений существенно меньше количества чтений из буферного кеша, то это означает, что кеш справляется с большинством запросов на чтение без обращения к ядру. Однако эта статистика не даёт полной картины: PostgreSQL обрабатывает дисковый ввод/вывод так, что данные, не находящиеся в буферном кеше PostgreSQL, могут все ещё располагаться в кеше ввода/вывода ядра, и, следовательно, для их получения физическое чтение может не использоваться. Для получения более детальной информации о процессе ввода/вывода в PostgreSQL рекомендуется использовать сборщик статистики PostgreSQL в сочетании с утилитами операционной системы, которые дают более полное представление о том, как ядро осуществляет ввод/вывод.

28.2.3. pg_stat_activity

В представлении pg_stat_activity для каждого серверного процесса будет присутствовать по одной строке с информацией, относящейся к текущей деятельности этого процесса.

Таблица 28.3. Представление pg_stat_activity

Тип столбца

Описание

datid oid

OID базы данных, к которой подключён этот серверный процесс

datname name

Имя базы данных, к которой подключён этот серверный процесс

pid integer

Идентификатор процесса этого серверного процесса

leader_pid integer

Идентификатор ведущего процесса группы, если текущий процесс является исполнителем параллельного запроса. NULL, если этот процесс является ведущим или не задействован в параллельном запросе.

usesysid oid

OID пользователя, подключённого к этому серверному процессу

usename name

Имя пользователя, подключённого к этому серверному процессу

application_name text

Название приложения, подключённого к этому серверному процессу

client_addr inet

IP-адрес клиента, подключённого к этому серверному процессу. Значение null в этом поле означает, что клиент подключён через сокет Unix на стороне сервера или что это внутренний процесс, например, автоочистка.

client_hostname text

Имя компьютера для подключённого клиента, получаемое в результате обратного поиска в DNS по client_addr. Это поле будет отлично от null только в случае соединений по IP и только при включённом режиме log_hostname.

client_port integer

Номер TCP-порта, который используется клиентом для соединения с этим обслуживающим процессом, или -1, если используется сокет Unix. Если поле содержит NULL, это означает, что это внутренний серверный процесс.

backend_start timestamp with time zone

Время запуска процесса. Для процессов, обслуживающих клиентов, это время подключения клиента к серверу.

xact_start timestamp with time zone

Время начала текущей транзакции в этом процессе или null при отсутствии активной транзакции. Если текущий запрос был первым в своей транзакции, то значение в этом столбце совпадает со значением столбца query_start.

query_start timestamp with time zone

Время начала выполнения активного в данный момент запроса, или, если state не active, то время начала выполнения последнего запроса

state_change timestamp with time zone

Время последнего изменения состояния (поля state)

wait_event_type text

Тип события, которого ждёт обслуживающий процесс, если это ожидание имеет место; в противном случае — NULL. См. Таблицу 28.4.

wait_event text

Имя ожидаемого события, если обслуживающий процесс находится в состоянии ожидания, а в противном случае — NULL. См. также Таблица 28.5Таблица 28.13.

state text

Общее текущее состояние этого серверного процесса. Возможные значения:

  • active: серверный процесс выполняет запрос.

  • idle: серверный процесс ожидает новой команды от клиента.

  • idle in transaction: серверный процесс находится внутри транзакции, но в настоящее время не выполняет никакой запрос.

  • idle in transaction (aborted): Это состояние подобно idle in transaction, за исключением того, что один из операторов в транзакции вызывал ошибку.

  • fastpath function call: серверный процесс выполняет fast-path функцию.

  • disabled: Это состояние отображается для серверных процессов, у которых параметр track_activities отключён.

backend_xid xid

Идентификатор верхнего уровня транзакции этого серверного процесса, если такой идентификатор есть.

backend_xmin xid

Текущая граница xmin для серверного процесса.

query_id bigint

Идентификатор последнего запроса этого серверного процесса. Если state имеет значение active, то в этом поле отображается идентификатор запроса, выполняемого в данный момент. Если процесс находится в любом другом состоянии, то в этом поле отображается идентификатор последнего выполненного запроса. По умолчанию идентификаторы запросов не вычисляются, поэтому данное поле будет иметь значение NULL, если не включён параметр compute_query_id или если не загружен сторонний модуль, вычисляющий идентификаторы запросов.

запрос text

Текст последнего запроса этого серверного процесса. Если state имеет значение active, то в этом поле отображается запрос, который выполняется в настоящий момент. Если процесс находится в любом другом состоянии, то в этом поле отображается последний выполненный запрос. По умолчанию текст запроса обрезается до 1024 байт; это число определяется параметром track_activity_query_size.

backend_type text

Тип текущего серверного процесса. Возможные варианты: autovacuum launcher, autovacuum worker, logical replication launcher, logical replication worker, parallel worker, background writer, client backend, checkpointer, archiver, startup, walreceiver, walsender и walwriter. Кроме того, фоновые рабочие процессы, регистрируемые расширениями, могут иметь дополнительные типы.


Примечание

Значения в столбцах wait_event и state не зависят друг от друга. Если обслуживающий процесс находится в состоянии active (активен), он может ожидать какое-то событие, или не ожидать никакое. Если состояние active и поле wait_event содержит не NULL, это означает, что запрос выполняется, но заблокирован чем-то в системе.

Таблица 28.4. Типы событий ожидания

Тип события ожиданияОписание
ActivityСерверный процесс простаивает. Это состояние показывает, что процесс ожидает активности в основном цикле обработки. В wait_event обозначается конкретное место ожидания; см. Таблицу 28.5.
BufferPinСерверный процесс ожидает исключительного доступа к буферу данных. Ожидание закрепления буфера может растягиваться, если другой процесс удерживает открытый курсор, который до этого читал данные из целевого буфера. См. Таблицу 28.6.
ClientСерверный процесс ожидает в сокете некоторую активность пользовательского приложения. То есть сервер ждёт, что произойдёт какое-то событие, не зависящее от его внутренних процессов. В wait_event обозначается конкретное место ожидания; см. Таблицу 28.7.
ExtensionСерверный процесс ожидает условия, возникающего в модуле расширения. См. Таблицу 28.8.
IOСерверный процесс ожидает завершения операции ввода/вывода. В wait_event обозначается конкретное место ожидания; см. Таблицу 28.9.
IPCСерверный процесс ожидает взаимодействия с другим процессом. В wait_event обозначается конкретное место ожидания; см. Таблицу 28.10.
LockСерверный процесс ожидает тяжёлую блокировку. Тяжёлые блокировки, также называемые блокировками менеджера блокировок или просто блокировками, в основном защищают объекты уровня SQL, такие как таблицы. Однако они также применяются для взаимоисключающего выполнения некоторых внутренних операций, например, расширения отношений. Тип ожидаемой блокировки показывается в wait_event; см. Таблицу 28.11.
LWLockСерверный процесс ожидает лёгкую блокировку. В большинстве своём такие блокировки защищают определённые структуры данных в общей памяти. В wait_event будет содержаться имя, отражающее цель получения лёгкой блокировки. (Некоторые блокировки имеют особые имена; другие объединяются в группы блокировок с похожим предназначением.) См. Таблицу 28.12.
TimeoutСерверный процесс ожидает истечения определённого времени. В wait_event обозначается конкретное место ожидания; см. Таблицу 28.13.

Таблица 28.5. События ожидания, относящиеся к типу Activity

Событие ожидания ActivityОписание
ArchiverMainОжидание в основном цикле процесса архиватора.
AutoVacuumMainОжидание в основном цикле процесса запуска автоочистки.
BgWriterHibernateОжидание в фоновом процессе записи, переход в режим «заморозки».
BgWriterMainОжидание в основном цикле процесса фоновой записи.
CheckpointerMainОжидание в основном цикле процесса контрольной точки.
LogicalApplyMainОжидание в основном цикле процесса применения логической репликации.
LogicalLauncherMainОжидание в основном цикле процесса запуска обработчиков логической репликации.
PgStatMainОжидание в основном цикле процесса сборщика статистики.
RecoveryWalStreamОжидание поступления записей WAL в основном цикле стартового процесса во время восстановления.
SysLoggerMainОжидание в основном цикле процесса системного журнала (syslogger).
WalReceiverMainОжидание в основном цикле процесса-приёмника WAL.
WalSenderMainОжидание в основном цикле процесса-передатчика WAL.
WalWriterMainОжидание в основном цикле процесса, пишущего WAL.

Таблица 28.6. События ожидания, относящиеся к типу BufferPin

Событие ожидания BufferPinОписание
BufferPinОжидание получения исключительного закрепления буфера.

Таблица 28.7. События ожидания, относящиеся к типу Client

События ожидания ClientОписание
ClientReadОжидание при чтении данных, получаемых от клиента.
ClientWriteОжидание при записи данных, передаваемых клиенту.
GSSOpenServerОжидание при чтении данных, получаемых от клиента при установлении сеанса GSSAPI.
LibPQWalReceiverConnectОжидание в приёмнике WAL установления подключения к удалённому серверу.
LibPQWalReceiverReceiveОжидание в приёмнике WAL поступления данных от удалённого сервера.
SSLOpenServerОжидание SSL при попытке установления соединения.
WalSenderWaitForWALОжидание сброса WAL в процессе-передатчике WAL.
WalSenderWriteDataОжидание какой-либо активности при обработке ответов от WAL-приёмника в процессе-передатчике WAL.

Таблица 28.8. События ожидания, относящиеся к типу Extension

Событие ожидания ExtensionОписание
ExtensionОжидание в расширении.

Таблица 28.9. События ожидания, относящиеся к типу IO

Событие ожидания IOОписание
BaseBackupReadОжидание чтения резервной копии из файла.
BufFileReadОжидание чтения из буферизованного файла.
BufFileWriteОжидание записи в буферизованный файл.
BufFileTruncateОжидание усечения буферизованного файла.
ControlFileReadОжидание чтения из файла pg_control.
ControlFileSyncОжидание помещения файла pg_control в надёжное хранилище.
ControlFileSyncUpdateОжидание переноса изменений файла pg_control в надёжное хранилище.
ControlFileWriteОжидание записи в файл pg_control.
ControlFileWriteUpdateОжидание записи для изменения файла pg_control.
CopyFileReadОжидание чтения во время операции копирования файла.
CopyFileWriteОжидание записи во время операции копирования файла.
DSMFillZeroWriteОжидание заполнения нулями файла, применяемого для поддержки динамической общей памяти.
DataFileExtendОжидание расширения файла данных отношения.
DataFileFlushОжидание помещения файла данных отношения в надёжное хранилище.
DataFileImmediateSyncОжидание немедленной синхронизации файла данных отношения с надёжным хранилищем.
DataFilePrefetchОжидание асинхронной предвыборки из файла данных отношения.
DataFileReadОжидание чтения из файла данных отношения.
DataFileSyncОжидание переноса изменений в файле данных отношения в надёжное хранилище.
DataFileTruncateОжидание усечения файла данных отношения.
DataFileWriteОжидание записи в файл данных отношения.
LockFileAddToDataDirReadОжидание чтения при добавлении строки в файл блокировки каталога данных.
LockFileAddToDataDirSyncОжидание помещения данных в надёжное хранилище при добавлении строки в файл блокировки каталога данных.
LockFileAddToDataDirWriteОжидание записи при добавлении строки в файл блокировки каталога данных.
LockFileCreateReadОжидание чтения при создании файла блокировки каталога данных.
LockFileCreateSyncОжидание помещения данных в надёжное хранилище при создании файла блокировки каталога данных.
LockFileCreateWriteОжидание записи при создании файла блокировки каталога данных.
LockFileReCheckDataDirReadОжидание чтения во время перепроверки файла блокировки каталога данных.
LogicalRewriteCheckpointSyncОжидание помещения отображений логической перезаписи в надёжное хранилище во время контрольной точки.
LogicalRewriteMappingSyncОжидание помещения данных отображений в надёжное хранилище в процессе логической перезаписи.
LogicalRewriteMappingWriteОжидание записи данных отображений в процессе логической перезаписи.
LogicalRewriteSyncОжидание помещения отображений логической перезаписи в надёжное хранилище.
LogicalRewriteTruncateОжидание усечения файла отображений в процессе логической перезаписи.
LogicalRewriteWriteОжидание сохранения отображений логической перезаписи.
RelationMapReadОжидание чтения файла отображений отношений.
RelationMapSyncОжидание помещения файла отображений отношений в надёжное хранилище.
RelationMapWriteОжидание записи в файл отображений отношений.
ReorderBufferReadОжидание чтения при работе с буфером переупорядочивания.
ReorderBufferWriteОжидание записи при работе с буфером переупорядочивания.
ReorderLogicalMappingReadОжидание чтения логического отображения при работе с буфером переупорядочивания.
ReplicationSlotReadОжидание чтения из управляющего файла слота репликации.
ReplicationSlotRestoreSyncОжидание помещения в надёжное хранилище управляющего файла слота репликации при восстановлении его в памяти.
ReplicationSlotSyncОжидание помещения в надёжное хранилище управляющего файла слота репликации.
ReplicationSlotWriteОжидание записи в управляющий файл слота репликации.
SLRUFlushSyncОжидание помещения данных SLRU в надёжное хранилище во время контрольной точки или отключения базы данных.
SLRUReadОжидание чтения страницы SLRU.
SLRUSyncОжидание помещения данных SLRU в надёжное хранилище после записи страницы.
SLRUWriteОжидание записи страницы SLRU.
SnapbuildReadОжидание чтения сериализованного исторического снимка каталога БД.
SnapbuildSyncОжидание помещения сериализованного исторического снимка каталога БД в надёжное хранилище.
SnapbuildWriteОжидание записи сериализованного исторического снимка каталога БД.
TimelineHistoryFileSyncОжидание помещения в надёжное хранилище файла истории линии времени, полученного через потоковую репликацию.
TimelineHistoryFileWriteОжидание записи файла истории линии времени, полученного через потоковую репликацию.
TimelineHistoryReadОжидание чтения файла истории линии времени.
TimelineHistorySyncОжидание помещения в надёжное хранилище только что созданного файла истории линии времени.
TimelineHistoryWriteОжидание записи только что созданного файла истории линии времени.
TwophaseFileReadОжидание чтения файла двухфазного состояния.
TwophaseFileSyncОжидание помещения файла двухфазного состояния в надёжное хранилище.
TwophaseFileWriteОжидание записи файла двухфазного состояния.
WALBootstrapSyncОжидание помещения WAL в надёжное хранилище в процессе начальной загрузки.
WALBootstrapWriteОжидание записи страницы WAL в процессе начальной загрузки.
WALCopyReadОжидание чтения при создании нового сегмента WAL путём копирования существующего.
WALCopySyncОжидание помещения в надёжное хранилище нового сегмента WAL, созданного путём копирования существующего.
WALCopyWriteОжидание записи при создании нового сегмента WAL путём копирования существующего.
WALInitSyncОжидание помещения в надёжное хранилище нового инициализированного файла WAL.
WALInitWriteОжидание записи при инициализации нового файла WAL.
WALReadОжидание чтения из файла WAL.
WALSenderTimelineHistoryReadОжидание чтения из файла истории линии времени при обработки процессом walsender команды timeline.
WALSyncОжидание помещения файла WAL в надёжное хранилище.
WALSyncMethodAssignОжидание помещения данных в надёжное хранилище при смене метода синхронизации WAL.
WALWriteОжидание записи в файл WAL.
LogicalChangesReadОжидание чтения из файла логических изменений.
LogicalChangesWriteОжидание записи в файл логических изменений.
LogicalSubxactReadОжидание чтения из файла логической подтранзакции.
LogicalSubxactWriteОжидание записи в файл логической транзакции.

Таблица 28.10. События ожидания, относящиеся к типу IPC

События ожидания IPCОписание
AppendReadyОжидание готовности узлов вложенных планов узла Append.
BackendTerminationОжидание завершения другого серверного процесса.
BackupWaitWalArchiveОжидание файлов WAL, необходимых для успешного завершения архивации.
BgWorkerShutdownОжидание завершения фонового рабочего процесса.
BgWorkerStartupОжидание запуска фонового рабочего процесса.
BtreePageОжидание доступности номера страницы, необходимого для продолжения параллельного сканирования B-дерева.
BufferIOОжидание завершения буферного ввода/вывода.
CheckpointDoneОжидание завершения контрольной точки.
CheckpointStartОжидание начала контрольной точки.
ExecuteGatherОжидание активности дочернего процесса при выполнении узла плана Gather.
HashBatchAllocateОжидание выделения хеш-таблицы выбранным участником параллельного хеширования.
HashBatchElectОжидание выделения хеш-таблицы выбранным участником параллельного хеширования.
HashBatchLoadОжидание завершения загрузки хеш-таблицы другими участниками параллельного хеширования.
HashBuildAllocateОжидание выделения начальной хеш-таблицы выбранным участником параллельного хеширования.
HashBuildElectОжидание в процессе выбора участника параллельного хеширования для выделения начальной хеш-таблицы.
HashBuildHashInnerОжидание завершения хеширования внутреннего отношения другими участниками параллельного хеширования.
HashBuildHashOuterОжидание завершения хеширования внешнего отношения другими участниками параллельного хеширования.
HashGrowBatchesAllocateОжидание выделения дополнительных пакетов выбранным участником параллельного хеширования.
HashGrowBatchesDecideОжидание в процессе выбора участника параллельного хеширования для принятия решения о предстоящем добавлении пакетов.
HashGrowBatchesElectОжидание в процессе выбора участника параллельного хеширования для выделения дополнительных пакетов.
HashGrowBatchesFinishОжидание решения о предстоящем добавлении пакетов участником параллельного хеширования.
HashGrowBatchesRepartitionОжидание завершения переразбиения другими участниками параллельного хеширования.
HashGrowBucketsAllocateОжидание завершения выделения дополнительных групп выбранным участником параллельного хеширования.
HashGrowBucketsElectОжидание в процессе выбора участника параллельного хеширования для выделения дополнительных групп.
HashGrowBucketsReinsertОжидание завершения добавления кортежей в новые группы другими участниками параллельного хеширования.
LogicalSyncDataОжидание от удалённого сервера, осуществляющего логическую репликацию, передачи данных для начальной синхронизации таблиц.
LogicalSyncStateChangeОжидание изменения состояния удалённого сервера, осуществляющего логическую репликацию.
MessageQueueInternalОжидание подключения другого процесса к общей очереди сообщений.
MessageQueuePutMessageОжидание записи сообщения протокола в общую очередь сообщений.
MessageQueueReceiveОжидание получения байтов из общей очереди сообщений.
MessageQueueSendОжидание передачи байтов в общую очередь сообщений.
ParallelBitmapScanОжидание инициализации параллельного сканирования по битовой карте.
ParallelCreateIndexScanОжидание завершения сканирования кучи параллельными исполнителями CREATE INDEX.
ParallelFinishОжидание завершения вычислений параллельными рабочими процессами.
ProcArrayGroupUpdateОжидание обнуления ID транзакции, которое должен произвести ведущий процесс группы по окончании параллельной операции.
ProcSignalBarrierОжидание обработки события барьера всеми обслуживающими процессами.
PromoteОжидание повышения ведомого.
RecoveryConflictSnapshotОжидание разрешения конфликтов восстановления для осуществления очистки.
RecoveryConflictTablespaceОжидание разрешения конфликтов восстановления для удаления табличного пространства.
RecoveryPauseОжидание возобновления восстановления.
ReplicationOriginDropОжидание перехода источника репликации в неактивное состояние, что позволит затем удалить его.
ReplicationSlotDropОжидание перехода слота репликации в неактивное состояние, что позволит затем удалить его.
SafeSnapshotОжидание получения безопасного снимка для транзакции READ ONLY DEFERRABLE.
SyncRepОжидание подтверждения от удалённого сервера при синхронной репликации.
WalReceiverExitОжидание завершения процесса-приёмника WAL.
WalReceiverWaitStartОжидание от стартового процесса передачи начальных данных для потоковой репликации.
XactGroupUpdateОжидание изменения состояния транзакции, которое должен произвести ведущий процесс группы по окончании параллельной операции.

Таблица 28.11. События ожидания, относящиеся к типу Lock

Событие ожидания LockОписание
advisoryОжидание при запросе рекомендательной пользовательской блокировки.
extendОжидание при расширении отношения.
frozenidОжидание изменения pg_database.datfrozenxid и pg_database.datminmxid.
objectОжидание при запросе блокировки для нереляционного объекта БД.
pageОжидание при запросе блокировки для страницы отношения.
relationОжидание при запросе блокировки для отношения.
spectokenОжидание при запросе блокировки спекулятивного добавления.
transactionidОжидание завершения транзакции.
tupleОжидание при запросе блокировки для кортежа.
userlockОжидание при запросе пользовательской блокировки.
virtualxidОжидание при запросе блокировки виртуального ID транзакции.

Таблица 28.12. События ожидания, относящиеся к типу LWLock

Событие ожидания LWLockОписание
AddinShmemInitОжидание при распределении блоков общей памяти для расширений.
AutoFileОжидание при изменении файла postgresql.auto.conf.
AutovacuumОжидание при чтении или изменении текущего состояния рабочих процессов автоочистки.
AutovacuumScheduleОжидание при подтверждении, что таблица, выбранная для автоочистки, всё ещё нуждается в очистке.
BackgroundWorkerОжидание при чтении или изменении состояния фонового рабочего процесса.
BtreeVacuumОжидание при чтении или изменении информации, связанной с очисткой, для индекса-B-дерева.
BufferContentОжидание при обращении к странице данных в памяти.
BufferMappingОжидание при связывании блока данных с буфером в пуле буферов.
CheckpointerCommОжидание при управлении запросами fsync.
CommitTsОжидание при чтении или изменении последнего значения, заданного в качестве времени фиксирования транзакции.
CommitTsBufferОжидание ввода/вывода с SLRU-буфером данных о времени фиксирования транзакций.
CommitTsSLRUОжидание при обращении к SLRU-кешу данных о времени фиксирования транзакций.
ControlFileОжидание при чтении или изменении файла pg_control либо при создании нового файла WAL.
DynamicSharedMemoryControlОжидание при чтении или изменении информации о выделении динамической общей памяти.
LockFastPathОжидание при чтении или изменении информации процесса о блокировках по быстрому пути.
LockManagerОжидание при чтении или изменении информации о «тяжёлых» блокировках.
LogicalRepWorkerОжидание при чтении или изменении состояния рабочих процессов логической репликации.
MultiXactGenОжидание при чтении или изменении общего состояния мультитранзакций.
MultiXactMemberBufferОжидание ввода/вывода с SLRU-буфером данных о членах мультитранзакций.
MultiXactMemberSLRUОжидание при обращении к SLRU-кешу данных о членах мультитранзакций.
MultiXactOffsetBufferОжидание ввода/вывода с SLRU-буфером данных о смещениях мультитранзакций.
MultiXactOffsetSLRUОжидание при обращении к SLRU-кешу данных о смещениях мультитранзакций.
MultiXactTruncationОжидание при чтении или очистке информации мультитранзакций.
NotifyBufferОжидание ввода/вывода с SLRU-буфером сообщений NOTIFY.
NotifyQueueОжидание при чтении или изменении сообщений NOTIFY.
NotifyQueueTailОжидание при изменении границы массива сообщений NOTIFY.
NotifySLRUОжидание при обращении к SLRU-кешу сообщений NOTIFY.
OidGenОжидание при выделении нового OID.
OldSnapshotTimeMapОжидание при чтении или изменении информации о старом снимке.
ParallelAppendОжидание выбора следующего подплана в процессе выполнения узла параллельного добавления (Parallel Append).
ParallelHashJoinОжидание синхронизации рабочих процессов в процессе выполнения узла плана Parallel Hash Join.
ParallelQueryDSAОжидание выделения динамической общей памяти для параллельного запроса.
PerSessionDSAОжидание выделения динамической общей памяти для параллельного запроса.
PerSessionRecordTypeОжидание при обращении к информации параллельного запроса о составных типах.
PerSessionRecordTypmodОжидание при обращении к информации параллельного запроса о модификаторах типов, относящихся к типам анонимных записей.
PerXactPredicateListОжидание при обращении к списку предикатных блокировок, удерживаемых текущей сериализуемой транзакцией, во время параллельного запроса.
PredicateLockManagerОжидание при обращении к информации о предикатных блокировках, используемой сериализуемыми транзакциями.
ProcArrayОжидание при обращении к общим структурам данных в рамках процесса (например, при получении снимка или чтении идентификатора транзакции в сеансе).
RelationMappingОжидание при чтении или изменении файла pg_filenode.map, в котором отслеживаются назначения файловых узлов для некоторых системных каталогов.
RelCacheInitОжидание при чтении или изменении файла инициализации кеша отношения (pg_internal.init).
ReplicationOriginОжидание при создании, удалении или использовании источника репликации.
ReplicationOriginStateОжидание при чтении или изменении состояния одного источника репликации.
ReplicationSlotAllocationОжидание при выделении или освобождении слота репликации.
ReplicationSlotControlОжидание при чтении или изменении состояния слота репликации.
ReplicationSlotIOОжидание при вводе/выводе со слотом репликации.
SerialBufferОжидание ввода/вывода с SLRU-буфером данных о конфликтах сериализуемых транзакций.
SerializableFinishedListОжидание при обращении к списку завершённых сериализуемых транзакций.
SerializablePredicateListОжидание при обращении к списку предикатных блокировок, удерживаемых сериализуемыми транзакциями.
SerializableXactHashОжидание при чтении или изменении информации о сериализуемых транзакциях.
SerialSLRUОжидание при обращении к SLRU-кешу данных о конфликтах сериализуемых транзакций.
SharedTidBitmapОжидание при обращении к разделяемой битовой карте TID в процессе параллельного сканирования индекса по битовой карте.
SharedTupleStoreОжидание при обращении к разделяемому хранилищу кортежей во время параллельного запроса.
ShmemIndexОжидание при поиске или выделении области в разделяемой памяти.
SInvalReadОжидание при получении сообщений из общей очереди сообщений аннулирования.
SInvalWriteОжидание при добавлении в общую очередь сообщения аннулирования каталога.
SubtransBufferОжидание ввода/вывода с SLRU-буфером данных о подтранзакциях.
SubtransSLRUОжидание при обращении к SLRU-кешу данных подтранзакций.
SyncRepОжидание при чтении или изменении информации о состоянии синхронной репликации.
SyncScanОжидание при выборе начального положения для синхронизированного сканирования таблицы.
TablespaceCreateОжидание при создании или удалении табличного пространства.
TwoPhaseStateОжидание при чтении или изменении состояния подготовленных транзакций.
WALBufMappingОжидание при замене страницы в буферах WAL.
WALInsertОжидание при добавлении записей WAL в буфер в памяти.
WALWriteОжидание при записи буферов WAL на диск.
WrapLimitsVacuumОжидание при изменении лимитов идентификаторов транзакций и мультитранзакций.
XactBufferОжидание ввода/вывода с SLRU-буфером данных о состоянии транзакций.
XactSLRUОжидание при обращении к SLRU-кешу данных о состоянии транзакций.
XactTruncationОжидание выполнения функции pg_xact_status или обновления самого старого видимого в ней идентификатора транзакции.
XidGenОжидание при выделении нового идентификатора транзакции.

Примечание

Приложения могут добавлять дополнительные типы LWLock в список, показанный в Таблице 28.12. В некоторых случаях имя, назначенное расширением, может быть не видно во всех серверных процессах, поэтому событие ожидания может отображаться с именем «extension», а не тем, что было назначено.

Таблица 28.13. События ожидания, относящиеся к типу Timeout

Событие ожидания TimeoutОписание
BaseBackupThrottleОжидание в процессе базового резервного копирования из-за ограничения активности.
CheckpointWriteDelayОжидание между операциями записи при выполнении контрольной точки.
PgSleepОжидание в результате вызова pg_sleep или родственной функции.
RecoveryApplyDelayОжидание применения WAL при восстановлении, вызванное установленной задержкой.
RecoveryRetrieveRetryIntervalОжидание в процессе восстановления, когда нужные сегменты WAL нельзя получить из какого-либо источника (каталога pg_wal, архива или потока).
RegisterSyncRequestОжидание при передаче запросов синхронизации процессу контрольной точки из-за переполнения очереди запросов.
VacuumDelayОжидание, вызванное задержкой очистки по критерию стоимости.

Следующая команда показывает, как можно просмотреть события ожидания:

SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event is NOT NULL;
 pid  | wait_event_type | wait_event 
------+-----------------+------------
 2540 | Lock            | relation
 6644 | LWLock          | ProcArray
(2 rows)

28.2.4. pg_stat_replication

Представление pg_stat_replication для каждого процесса-передатчика WAL будет содержать по одной строке со статистикой о репликации на ведомый сервер, к которому подключён этот процесс. В представлении перечисляются только ведомые серверы, подключённые напрямую; информация о ведомых серверах, подключённых опосредованно, не представлена.

Таблица 28.14. Представление pg_stat_replication

Тип столбца

Описание

pid integer

Идентификатор процесса-передатчика WAL

usesysid oid

OID пользователя, подключённого к этому процессу-передатчику WAL

usename name

Имя пользователя, подключённого к этому процессу-передатчику WAL

application_name text

Имя приложения, которое подключено к этому процессу-передатчику WAL

client_addr inet

IP-адрес клиента, подключённого к этому процессу-передатчику WAL. Значение null в этом поле говорит о том, что клиент подсоединён через сокет Unix на сервере.

client_hostname text

Имя компьютера для подключённого клиента, получаемое в результате обратного поиска в DNS по client_addr. Это поле будет отлично от null только в случае соединений по IP и только при включённом режиме log_hostname.

client_port integer

Номер TCP-порта, который используется клиентом для взаимодействия с процессом-передатчиком WAL, или -1, если используется сокет Unix

backend_start timestamp with time zone

Время запуска процесса, т. е. время подключения клиента к этому процессу-передатчику WAL

backend_xmin xid

Значение xmin, полученное от ведомого сервера при включённом hot_standby_feedback.

state text

Текущее состояние процесса-передатчика WAL. Возможные значения:

  • startup: Передатчик WAL запускается.

  • catchup: Подключённый к этому передатчику WAL ведомый сервер догоняет ведущий.

  • streaming: Передатчик WAL транслирует изменения после того, как подключённый к нему ведомый сервер нагнал ведущий.

  • backup: Передатчик WAL передаёт резервную копию.

  • stopping: Передатчик WAL останавливается.

sent_lsn pg_lsn

Последняя позиция в журнале предзаписи, переданная через это соединение

write_lsn pg_lsn

Последняя позиция в журнале предзаписи, записанная на диск этим ведомым сервером

flush_lsn pg_lsn

Последняя позиция в журнале предзаписи, сброшенная на диск этим ведомым сервером

replay_lsn pg_lsn

Последняя позиция в журнале предзаписи, воспроизведённая в базе данных этим ведомым сервером

write_lag interval

Время, прошедшее с момента локального сброса последних данных WAL до получения уведомления о том, что этот ведомый сервер записал их (но ещё не сбросил на диск и не применил). Это позволяет оценить задержку, возникающую при фиксации транзакции, когда в synchronous_commit выбран уровень remote_write, если данный сервер будет настроен как синхронный ведомый.

flush_lag interval

Время, прошедшее с момента локального сброса последних данных WAL до получения уведомления о том, что этот ведомый сервер записал и сбросил их на диск (но ещё не применил). Это позволяет оценить задержку, возникающую при фиксации транзакции, когда в synchronous_commit выбран уровень on, если данный сервер будет настроен как синхронный ведомый.

replay_lag interval

Время, прошедшее с момента локального сброса последних данных WAL до получения уведомления о том, что этот ведомый сервер записал, сбросил на диск и применил их. Это позволяет оценить задержку, возникающую при фиксации транзакции, когда в synchronous_commit выбран уровень remote_apply, если данный сервер будет настроен как синхронный ведомый.

sync_priority integer

Приоритет этого ведомого сервера для выбора в качестве синхронного ведомого при синхронной репликации с учётом приоритетов. При синхронной репликации с учётом кворума не имеет значения.

sync_state text

Состояние синхронизации этого ведомого сервера. Возможные значения:

  • async: Этот ведомый сервер является асинхронным.

  • potential: Этот ведомый сервер сейчас является асинхронным, но может стать синхронным в случае отказа одного из текущих синхронных серверов.

  • sync: Этот ведомый сервер является синхронным.

  • quorum: Этот ведомый сервер считается кандитатом на участие в кворуме.

reply_time timestamp with time zone

Время отправки последнего ответного сообщения, полученного от ведомого сервера


Длительность задержек, показываемая в представлении pg_stat_replication, включает время, которое потребовалось для того, чтобы записать, сбросить на диск и воспроизвести последние записи WAL и для того, чтобы передатчик WAL узнал об этом. Эта длительность отражает задержку фиксации, которая была (или могла быть) добавлена на уровнях синхронной фиксации, если ведомый сервер был настроен как синхронный. Для асинхронного ведомого в столбце replay_lag показывается примерная задержка перед тем, как последние транзакции становятся видны для запросов. Если ведомый сервер нагоняет передающий и в WAL отсутствует активность, последние длительности задержек будут отображаться ещё некоторое время, а затем сменятся на NULL.

Длительность задержек автоматически определяется при физической репликации. Модули логического декодирования могут не выдавать необходимые контрольные сообщения; в их отсутствие механизм отслеживания просто выводит задержку NULL.

Примечание

Выдаваемые длительности задержек не являются предсказанием времени, которое потребуется ведомому серверу, чтобы нагнать передающий сервер с учётом текущей скорости воспроизведения. Эти показатели будут близки в процессе генерирования нового WAL, но не в то время, когда передающий сервер будет простаивать. В частности, когда ведомый сервер нагоняет ведущий, в pg_stat_replication показывается, сколько времени потребовалось для записи, сброса на диск и воспроизведения последних данных WAL, а не 0, как могли ожидать некоторые пользователи. Это соответствует задаче измерения задержек синхронной фиксации и видимости транзакций для недавно записанных транзакций. Чтобы меньше смущать пользователей, ожидающих видеть другую модель задержек, столбцы задержек сбрасываются в NULL после небольшой паузы в системе, которая воспроизвела все изменения и теперь простаивает. Системы мониторинга могут представлять это как отсутствующие данные, 0 или продолжать показывать последнее известное значение.

28.2.5. pg_stat_replication_slots

Представление pg_stat_replication_slots содержит одну строку со статистикой использования на каждый слот логической репликации.

Таблица 28.15. Представление pg_stat_replication_slots

Тип столбца

Описание

slot_name text

Уникальный в рамках кластера идентификатор для слота репликации

spill_txns bigint

Количество транзакций, вытесненных на диск после того, как объём памяти, используемый при логическом декодировании изменений из WAL, превысил значение logical_decoding_work_mem. Счётчик учитывает как транзакции верхнего уровня, так и подтранзакции.

spill_count bigint

Сколько раз транзакции были вытеснены на диск при декодировании изменений из WAL для этого слота. Этот счётчик увеличивается каждый раз, когда транзакция вытесняется; одна и та же транзакция может быть вытеснена несколько раз.

spill_bytes bigint

Объём декодированных транзакционных данных, вытесненных на диск при выполнении декодирования изменений из WAL для этого слота. Этот и другие счётчики, связанные с вытеснением, помогают оценить объём связанного с логическим декодированием ввода/вывода и настроить параметр logical_decoding_work_mem.

stream_txns bigint

Количество текущих транзакций, переданных в потоке в модуль вывода декодирования после того, как объём памяти, используемый для логического декодирования изменений из WAL для этого слота, превысил значение logical_decoding_work_mem. В потоке передаются только транзакции верхнего уровня (подтранзакции не могут передаваться в потоке отдельно), поэтому счётчик не учитывает подтранзакции.

stream_countbigint

Сколько раз текущие транзакции были переданы в потоке модулю вывода при декодировании изменений из WAL для этого слота. Этот счётчик увеличивается каждый раз, когда транзакция передаётся в потоке; одна и та же транзакция может быть передана в потоке несколько раз.

stream_bytesbigint

Объём транзакционных данных, декодированных для передачи текущих транзакций в потоке в модуль вывода при декодировании изменений из WAL для этого слота. Этот и другие счётчики передаваемых транзакций данного слота могут быть полезны для настройки logical_decoding_work_mem.

total_txns bigint

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

total_bytesbigint

Объём транзакционных данных, декодированных для отправки транзакций в модуль вывода при декодировании изменений из WAL для этого слота. Обратите внимание, что в этом объёме учитываются передаваемые в потоке и/или вытесняемые данные.

stats_reset timestamp with time zone

Последнее время сброса этих статистических данных


28.2.6. pg_stat_wal_receiver

Представление pg_stat_wal_receiver будет иметь только одну строку со статистикой приёмника WAL от сервера, на котором работает приёмник.

Таблица 28.16. Представление pg_stat_wal_receiver

Тип столбца

Описание

pid integer

Идентификатор процесса WAL-приёмника

status text

Состояние активности процесса WAL-приёмника

receive_start_lsn pg_lsn

Первая позиция в журнале предзаписи в момент запуска приёмника WAL

receive_start_tli integer

Первый номер линии времени в момент запуска приёмника WAL

written_lsn pg_lsn

Последняя позиция в журнале предзаписи, уже полученная и переданная для записи на диск, но ещё не сброшенная. Эту позицию не следует использовать при проверках целостности данных.

flushed_lsn pg_lsn

Последняя позиция в журнале предзаписи, уже полученная и сброшенная на диск; начальным значением этого поля будет первая позиция в журнале в момент запуска приёмника WAL

received_tli integer

Номер линии времени последней позиции в журнале предзаписи, уже полученной и сброшенной на диск; начальным значением этого поля будет номер линии времени первой позиции в момент запуска приёмника WAL

last_msg_send_time timestamp with time zone

Время отправки последнего сообщения, полученного от изначального передатчика WAL

last_msg_receipt_time timestamp with time zone

Время поступления последнего сообщения, полученного от изначального передатчика WAL

latest_end_lsn pg_lsn

Последняя позиция в журнале предзаписи, сообщённая изначальному передатчику WAL

latest_end_time timestamp with time zone

Время последней позиции в журнале предзаписи, сообщённой изначальному передатчику WAL

slot_name text

Имя слота репликации, используемого этим приёмником WAL

sender_host text

Узел, где работает сервер PostgreSQL, обслуживающий данный приёмник WAL. Может задаваться именем или IP-адресом компьютера либо путём каталога (если подключение установлено через сокет Unix). (Подключение к сокету легко распознать, потому что путь всегда абсолютный и начинается с /.)

sender_port integer

Номер порта сервера PostgreSQL, к которому подключён этот приёмник WAL.

conninfo text

Строка подключения, используемая этим приёмником WAL (секретные поля в ней скрыты).


28.2.7. pg_stat_subscription

Представление pg_stat_subscription содержит по одной строке для подписки для основного рабочего процесса (с NULL в PID, если процесс не работает) и дополнительные строки для рабочих процессов, осуществляющих копирование начальных данных для таблиц в подписке.

Таблица 28.17. Представление pg_stat_subscription

Тип столбца

Описание

subid oid

OID подписки

subname name

Имя подписки

pid integer

Идентификатор рабочего процесса, обслуживающего подписку

relid oid

OID отношения, которое синхронизирует рабочий процесс сейчас; null для основного процесса применения изменений

received_lsn pg_lsn

Последняя позиция в журнале предзаписи (начальное значение этого поля — 0)

last_msg_send_time timestamp with time zone

Время отправки последнего сообщения, полученного от изначального передатчика WAL

last_msg_receipt_time timestamp with time zone

Время поступления последнего сообщения, полученного от изначального передатчика WAL

latest_end_lsn pg_lsn

Последняя позиция в журнале предзаписи, сообщённая изначальному передатчику WAL

latest_end_time timestamp with time zone

Время последней позиции в журнале предзаписи, сообщённой изначальному передатчику WAL


28.2.8. pg_stat_ssl

Представление pg_stat_ssl содержит по одной строке для каждого обслуживающего процесса и процесса, передающего WAL, и показывает статистику использования SSL для подключений. Его можно соединить с pg_stat_activity или pg_stat_replication по столбцу pid и получить дополнительные сведения о подключении.

Таблица 28.18. Представление pg_stat_ssl

Тип столбца

Описание

pid integer

Идентификатор обслуживающего процесса или процесса, передающего WAL

ssl boolean

True, если для этого подключения используется SSL

version text

Версия SSL либо NULL, если SSL для этого подключения не используется

cipher text

Имя применяемого шифра SSL либо NULL, если SSL для этого подключения не используется

bits integer

Число бит в применяемом алгоритме шифрования либо NULL, если SSL для этого подключения не используется

client_dn text

Поле DN (Distinguished Name, Уникальное имя) из используемого клиентского сертификата либо NULL, если клиент не передал сертификат или SSL для этого подключения не используется. Это значение усекается, если оказывается длиннее NAMEDATALEN символов (64 символа в стандартной сборке).

client_serial numeric

Серийный номер клиентского сертификата либо NULL, если клиент не передал сертификат или SSL для этого подключения не используется. В сочетании с именем центра сертификации, выдавшего сертификат, серийный номер однозначно идентифицирует сертификат (если только ЦС не выдаёт по ошибке одинаковые серийные номера).

issuer_dn text

Уникальное имя (Distinguished Name, DN) центра сертификации, выдавшего клиентский сертификат, либо NULL, если клиент не передал сертификат или SSL для этого подключения не используется. Это значение усекается подобно client_dn.


28.2.9. pg_stat_gssapi

Представление pg_stat_gssapi содержит по одной строке для каждого обслуживающего процесса и показывает статистику использования GSSAPI для конкретного подключения. Его можно соединить с pg_stat_activity или pg_stat_replication по столбцу pid и получить дополнительные сведения о подключении.

Таблица 28.19. Представление pg_stat_gssapi

Тип столбца

Описание

pid integer

Идентификатор (PID) обслуживающего процесса

gss_authenticated boolean

True, если для этого подключения используется аутентификация GSSAPI

principal text

Принципал, для которого было аутентифицировано это подключение, либо NULL, если клиент не передал сертификат или GSSAPI для этого подключения не используется. Это значение усекается, если оказывается длиннее NAMEDATALEN символов (64 символа в стандартной сборке).

encrypted boolean

True, если для этого подключения используется шифрование GSSAPI


28.2.10. pg_stat_archiver

В представлении pg_stat_archiver всегда будет одна строка, содержащая данные о текущем состоянии процесса архивации в кластере.

Таблица 28.20. Представление pg_stat_archiver

Тип столбца

Описание

archived_count bigint

Число файлов WAL, которые были успешно архивированы

last_archived_wal text

Имя последнего файла WAL успешно архивированного

last_archived_time timestamp with time zone

Время последней успешной архивации

failed_count bigint

Число неудачных попыток архивации файлов WAL

last_failed_wal text

Имя файла WAL последней неудавшейся архивации

last_failed_time timestamp with time zone

Время последней неудавшейся архивации

stats_reset timestamp with time zone

Последнее время сброса этих статистических данных


28.2.11. pg_stat_bgwriter

В представлении pg_stat_bgwriter всегда будет только одна строка, в которой будут представлены общие данные по всему кластеру.

Таблица 28.21. Представление pg_stat_bgwriter

Тип столбца

Описание

checkpoints_timed bigint

Количество запланированных контрольных точек, которые уже были выполнены

checkpoints_req bigint

Количество запрошенных контрольных точек, которые уже были выполнены

checkpoint_write_time double precision

Общее время, которое было затрачено на этап обработки контрольной точки, в котором файлы записываются на диск, в миллисекундах

checkpoint_sync_time double precision

Общее время, которое было затрачено на этап обработки контрольной точки, в котором файлы синхронизируются с диском, в миллисекундах

buffers_checkpoint bigint

Количество буферов, записанных при выполнении контрольных точек

buffers_clean bigint

Количество буферов, записанных фоновым процессом записи

maxwritten_clean bigint

Сколько раз фоновый процесс записи останавливал сброс грязных страниц на диск из-за того, что записал слишком много буферов

buffers_backend bigint

Количество буферов, записанных самим серверным процессом

buffers_backend_fsync bigint

Сколько раз серверному процессу пришлось выполнить fsync самостоятельно (обычно фоновый процесс записи сам обрабатывает эти вызовы, даже когда серверный процесс выполняет запись самостоятельно)

buffers_alloc bigint

Количество выделенных буферов

stats_reset timestamp with time zone

Последнее время сброса этих статистических данных


28.2.12. pg_stat_wal

В представлении pg_stat_wal всегда будет одна строка, содержащая данные о работе WAL в кластере.

Таблица 28.22. Представление pg_stat_wal

Тип столбца

Описание

wal_records bigint

Общее число сгенерированных записей WAL

wal_fpi bigint

Общее число сгенерированных образов полных страниц в WAL

wal_bytes numeric

Общий сгенерированный объём WAL в байтах

wal_buffers_full bigint

Сколько раз данные WAL записывались на диск из-за переполнения буферов WAL

wal_write bigint

Сколько раз буферы WAL были записаны на диск функцией XLogWrite. Более подробную информацию о внутренней функции WAL XLogWrite можно найти в Разделе 30.5.

wal_sync bigint

Сколько раз файлы WAL сбрасывались на диск функцией issue_xlog_fsync (если параметр fsync включён (on) и wal_sync_method имеет значение fdatasync, fsync или fsync_writethrough, в противном случае будет выведен ноль). Более подробную информацию о внутренней функции WAL issue_xlog_fsync можно найти в Разделе 30.5.

wal_write_time double precision

Общее время, затраченное на запись буферов WAL на диск функцией XLogWrite, в миллисекундах (если включён параметр track_wal_io_timing, в противном случае 0). Также учитывается время синхронизации, когда wal_sync_method имеет значение open_datasync или open_sync.

wal_sync_time double precision

Общее время, затраченное на синхронизацию файлов WAL с диском функцией issue_xlog_fsync, в миллисекундах (если включён track_wal_io_timing, fsync имеет значение on, а wal_sync_method имеет значение fdatasync, fsync или fsync_writethrough, в противном случае 0).

stats_reset timestamp with time zone

Последнее время сброса этих статистических данных


28.2.13. pg_stat_database

Представление pg_stat_database содержит по одной строке со статистикой уровня базы данных для каждой базы кластера, и ещё одну для общих объектов.

Таблица 28.23. Представление pg_stat_database

Тип столбца

Описание

datid oid

OID базы данных либо 0 для объектов, относящихся к общим отношениям

datname name

Имя базы данных либо NULL для общих объектов.

numbackends integer

Количество обслуживающих процессов, в настоящее время подключённых к этой базе данных, либо NULL для общих объектов. Это единственный столбец в представлении, значение в котором отражает текущее состояние; все другие столбцы возвращают суммарные значения со времени последнего сброса статистики.

xact_commit bigint

Количество зафиксированных транзакций в этой базе данных

xact_rollback bigint

Количество транзакций в этой базе данных, для которых был выполнен откат транзакции

blks_read bigint

Количество прочитанных дисковых блоков в этой базе данных

blks_hit bigint

Сколько раз дисковые блоки обнаруживались в буферном кеше, так что чтение с диска не потребовалось (в значение входят только случаи обнаружения в буферном кеше PostgreSQL, а не в кеше файловой системы ОС)

tup_returned bigint

Количество строк, возвращённое запросами в этой базе данных

tup_fetched bigint

Количество строк, извлечённое запросами в этой базе данных

tup_inserted bigint

Количество строк, вставленное запросами в этой базе данных

tup_updated bigint

Количество строк, изменённое запросами в этой базе данных

tup_deleted bigint

Количество строк, удалённое запросами в этой базе данных

conflicts bigint

Количество запросов, отменённых из-за конфликта с восстановлением в этой базе данных. (Конфликты происходят только на ведомых серверах; подробности в pg_stat_database_conflicts.)

temp_files bigint

Количество временных файлов, созданных запросами в этой базе данных. Подсчитываются все временные файлы независимо от причины их создания (например, для сортировки или для хеширования) и независимо от установленного значения log_temp_files

temp_bytes bigint

Общий объём данных, записанных во временные файлы запросами в этой базе данных. Учитываются все временные файлы, вне зависимости от того, по какой причине они созданы и вне зависимости от значения log_temp_files.

deadlocks bigint

Количество взаимных блокировок, зафиксированное в этой базе данных

checksum_failures bigint

Количество ошибок контрольных сумм в страницах данных этой базы (или общего объекта) либо NULL, если контрольные суммы не проверяются.

checksum_last_failure timestamp with time zone

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

blk_read_time double precision

Время, которое затратили обслуживающие процессы в этой базе на чтение блоков из файлов данных, в миллисекундах (если включён параметр track_io_timing; в противном случае 0).

blk_write_time double precision

Время, которое затратили обслуживающие процессы в этой базе на запись блоков в файлы данных, в миллисекундах (если включён параметр track_io_timing; в противном случае 0)

session_time double precision

Длительность сеансов в этой базе в миллисекундах (обратите внимание, что статистика обновляется только при изменении состояния сеанса, поэтому, если сеансы простаивают в течение длительного времени, оно не будет учитываться)

active_time double precision

Время, затраченное на выполнение операторов SQL в этой базе, в миллисекундах (соответствует состояниям active и fastpath function call в pg_stat_activity)

idle_in_transaction_time double precision

Время простоя в транзакциях в этой базе в миллисекундах (соответствует состояниям idle in transaction и idle in transaction (aborted) в pg_stat_activity)

sessions bigint

Общее количество сеансов, относящихся к этой базе

sessions_abandoned bigint

Количество сеансов в этой базе данных, прерванных из-за потери соединения с клиентом

sessions_fatal bigint

Количество сеансов в этой базе данных, прерванных из-за критических ошибок

sessions_killed bigint

Количество сеансов в этой базе данных, прерванных из-за вмешательства оператора

stats_reset timestamp with time zone

Последнее время сброса этих статистических данных


28.2.14. pg_stat_database_conflicts

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

Таблица 28.24. Представление pg_stat_database_conflicts

Тип столбца

Описание

datid oid

OID базы данных

datname name

Имя базы данных

confl_tablespace bigint

Количество запросов в этой базе данных, отменённых из-за того, что табличные пространства были удалены

confl_lock bigint

Количество запросов в этой базе данных, отменённых по истечении времени ожидания блокировки

confl_snapshot bigint

Количество запросов в этой базе данных, отменённых из-за устаревших снимков данных

confl_bufferpin bigint

Количество запросов в этой базе данных, отменённых из-за прикреплённых страниц буфера

confl_deadlock bigint

Количество запросов в этой базе данных, отменённых из-за взаимных блокировок


28.2.15. pg_stat_all_tables

Представление pg_stat_all_tables будет содержать по одной строке на каждую таблицу в текущей базе данных (включая таблицы TOAST) со статистикой по обращениям к этой таблице. Представления pg_stat_user_tables и pg_stat_sys_tables содержат ту же самую информацию, но отфильтрованную так, чтобы показывать только пользовательские и системные таблицы соответственно.

Таблица 28.25. Представление pg_stat_all_tables

Тип столбца

Описание

relid oid

OID таблицы

schemaname name

Имя схемы, в которой расположена эта таблица

relname name

Имя таблицы

seq_scan bigint

Количество последовательных чтений, произведённых в этой таблице

seq_tup_read bigint

Количество «живых» строк, прочитанных при последовательных чтениях

idx_scan bigint

Количество сканирований по индексу, произведённых в этой таблице

idx_tup_fetch bigint

Количество «живых» строк, отобранных при сканированиях по индексу

n_tup_ins bigint

Количество вставленных строк

n_tup_upd bigint

Количество изменённых строк (включая изменения по схеме HOT)

n_tup_del bigint

Количество удалённых строк

n_tup_hot_upd bigint

Количество строк, обновлённых в режиме HOT (т. е. без отдельного изменения индекса)

n_live_tup bigint

Оценочное количество «живых» строк

n_dead_tup bigint

Оценочное количество «мёртвых» строк

n_mod_since_analyze bigint

Оценочное число строк, изменённых в этой таблице с момента последнего сбора статистики

n_ins_since_vacuum bigint

Примерное число строк, вставленных в эту таблицу с момента последней очистки

last_vacuum timestamp with time zone

Время последней очистки этой таблицы вручную (VACUUM FULL не учитывается)

last_autovacuum timestamp with time zone

Время последней очистки таблицы фоновым процессом автоочистки

last_analyze timestamp with time zone

Время последнего выполнения сбора статистики для этой таблицы вручную

last_autoanalyze timestamp with time zone

Время последнего выполнения сбора статистики для этой таблицы фоновым процессом автоочистки

vacuum_count bigint

Сколько раз очистка этой таблицы была выполнена вручную (VACUUM FULL не учитывается)

autovacuum_count bigint

Сколько раз очистка этой таблицы была выполнена фоновым процессом автоочистки

analyze_count bigint

Сколько раз сбор статистики для этой таблицы был выполнен вручную

autoanalyze_count bigint

Сколько раз сбор статистики для этой таблицы был выполнен фоновым процессом автоочистки


28.2.16. pg_stat_all_indexes

Представление pg_stat_all_indexes для каждого индекса в текущей базе данных будет содержать по одной строке со статистикой по обращениям к этому индексу. Представления pg_stat_user_indexes и pg_stat_sys_indexes содержат ту же самую информацию, но отфильтрованную так, чтобы показывать только пользовательские и системные индексы соответственно.

Таблица 28.26. Представление pg_stat_all_indexes

Тип столбца

Описание

relid oid

OID таблицы для индекса

indexrelid oid

OID индекса

schemaname name

Имя схемы, в которой расположен индекс

relname name

Имя таблицы для индекса

indexrelname name

Имя индекса

idx_scan bigint

Количество произведённых сканирований по этому индексу

idx_tup_read bigint

Количество элементов индекса, возвращённых при сканированиях по этому индексу

idx_tup_fetch bigint

Количество живых строк таблицы, отобранных при простых сканированиях по этому индексу


Индексы могут использоваться при простом сканировании по индексу, при сканировании «битовой карты» индекса и в работе оптимизатора. Результаты сканирования битовых карт разных индексов могут объединяться логическим умножением или сложением, поэтому когда применяются битовые карты, сложно связать выборки отдельных строк с определёнными индексами. Поэтому при сканировании битовых карт увеличиваются счётчики pg_stat_all_indexes.idx_tup_read для задействованных индексов и счётчик pg_stat_all_tables.idx_tup_fetch для каждой таблицы, а pg_stat_all_indexes.idx_tup_fetch не меняется. Оптимизатор тоже обращается к индексам для проверки переданных констант, значения которых оказываются вне диапазона, записанного в статистике оптимизатора, так как эта статистика может быть неактуальной.

Примечание

Значения счётчиков idx_tup_read и idx_tup_fetch могут различаться, даже если сканирование с использованием битовой карты не используется, поскольку idx_tup_read подсчитывает полученные из индекса элементы, а idx_tup_fetch — количество «живых» строк, выбранных из таблицы. Различие будет меньше, если «мёртвые» или ещё не зафиксированные строки будут извлекаться с использованием индекса или если для получения строк таблицы будет использоваться сканирование только по индексу.

28.2.17. pg_statio_all_tables

Представление pg_statio_all_tables для каждой таблицы (включая таблицы TOAST) в текущей базе данных будет содержать по одной строке со статистикой по операциям ввода/вывода для этой таблицы. Представления pg_statio_user_tables и pg_statio_sys_tables содержат ту же самую информацию, но отфильтрованную так, чтобы показывать только пользовательские или системные таблицы соответственно.

Таблица 28.27. Представление pg_statio_all_tables

Тип столбца

Описание

relid oid

OID таблицы

schemaname name

Имя схемы, в которой расположена эта таблица

relname name

Имя таблицы

heap_blks_read bigint

Количество дисковых блоков, прочитанных из этой таблицы

heap_blks_hit bigint

Число попаданий в буфер для этой таблицы

idx_blks_read bigint

Количество дисковых блоков, прочитанных из всех индексов этой таблицы

idx_blks_hit bigint

Число попаданий в буфер для всех индексов по этой таблице

toast_blks_read bigint

Количество прочитанных дисковых блоков TOAST (если есть) для этой таблицы

toast_blks_hit bigint

Число попаданий в буфер в таблице TOAST для этой таблицы (если такие есть)

tidx_blks_read bigint

Количество прочитанных дисковых блоков из индекса по TOAST (если есть) для этой таблицы

tidx_blks_hit bigint

Число попаданий в буфер для индекса по TOAST (если есть) для этой таблицы


28.2.18. pg_statio_all_indexes

Представление pg_statio_all_indexes для каждого индекса в текущей базе данных будет содержать по одной строке со статистикой по операциям ввода/вывода для этого индекса. Представления pg_statio_user_indexes и pg_statio_sys_indexes содержат ту же самую информацию, но отфильтрованную так, чтобы показывать только пользовательские или системные индексы соответственно.

Таблица 28.28. Представление pg_statio_all_indexes

Тип столбца

Описание

relid oid

OID таблицы для индекса

indexrelid oid

OID индекса

schemaname name

Имя схемы, в которой расположен индекс

relname name

Имя таблицы для индекса

indexrelname name

Имя индекса

idx_blks_read bigint

Количество дисковых блоков, прочитанных из этого индекса

idx_blks_hit bigint

Число попаданий в буфер для этого индекса


28.2.19. pg_statio_all_sequences

Представление pg_statio_all_sequences для каждой последовательности в текущей базе данных будет содержать по одной строке со статистикой по операциям ввода/вывода для этой последовательности.

Таблица 28.29. Представление pg_statio_all_sequences

Тип столбца

Описание

relid oid

OID последовательности

schemaname name

Имя схемы, в которой расположена эта последовательность

relname name

Имя последовательности

blks_read bigint

Количество дисковых блоков, прочитанных из этой последовательности

blks_hit bigint

Число попаданий в буфер в этой последовательности


28.2.20. pg_stat_user_functions

Представление pg_stat_user_functions для каждой отслеживаемой функции будет содержать по одной строке со статистикой по выполнениям этой функции. Отслеживаемые функции определяются параметром track_functions.

Таблица 28.30. Представление pg_stat_user_functions

Тип столбца

Описание

funcid oid

OID функции

schemaname name

Имя схемы, в которой расположена функция

funcname name

Имя функции

calls bigint

Сколько раз вызывалась функция

total_time double precision

Общее время, потраченное на выполнение этой функции и всех других функций, вызванных ею, в миллисекундах

self_time double precision

Общее время, потраченное на выполнение самой функции, без учёта других функций, которые были ею вызваны, в миллисекундах


28.2.21. pg_stat_slru

PostgreSQL обращается к некоторой информации на диске через кеши, работающие по принципу SLRU (simple least-recently-used, простое вытеснение давно не используемых). Представление pg_stat_slru содержит по одной строке для каждого SLRU-кеша и даёт статистику по обращениям к его страницам.

Таблица 28.31. Представление pg_stat_slru

Тип столбца

Описание

name text

Имя SLRU-кеша

blks_zeroed bigint

Количество блоков, обнулённых при инициализации

blks_hit bigint

Количество случаев, когда дисковые блоки обнаруживались в SLRU-кеше, так что чтение с диска не потребовалось (здесь учитываются только случаи обнаружения в этом кеше, а не в файловом кеше ОС)

blks_read bigint

Количество дисковых блоков, прочитанных через этот SLRU-кеш

blks_written bigint

Количество дисковых блоков, записанных из этого SLRU-кеша

blks_exists bigint

Количество блоков, проверенных на предмет наличия в этом SLRU-кеше

flushes bigint

Количество операций сброса «грязных» данных для этого SLRU-кеша

truncates bigint

Количество операций усечения для этого SLRU-кеша

stats_reset timestamp with time zone

Последнее время сброса этих статистических данных


28.2.22. Статистические функции

Статистическую информацию можно просматривать и другими способами. Для этого можно написать запросы, использующие те же функции доступа к статистике, что лежат в основе описанных выше стандартных представлений. За более подробной информацией, например, об именах этих функций, обратитесь к определениям этих стандартных представлений. (Например, в psql можно выполнить \d+ pg_stat_activity.) В качестве аргумента функции, предоставляющие доступ к статистике на уровне базы, принимают OID базы данных, по которой должна быть выдана информация. Функции, которые работают на уровне таблиц и индексов, принимают в качестве аргумента OID таблицы или индекса. Аргументом для функции, предоставляющей статистику на уровне функций, является OID функции. Обратите внимание, что с помощью этих функций можно получить информацию по таблицам, индексам и функциям исключительно в текущей базе данных.

Дополнительные функции, связанные со сбором статистики, перечислены в Таблице 28.32.

Таблица 28.32. Дополнительные статистические функции

Функция

Описание

pg_backend_pid () → integer

Выдаёт идентификатор серверного процесса, обслуживающего текущий сеанс.

pg_stat_get_activity ( integer ) → setof record

Возвращает запись с информацией о серверном процессе с заданным ID или по одной строке для каждого активного серверного процесса, если был указан NULL. Возвращаемые поля являются подмножеством столбцов представления pg_stat_activity.

pg_stat_get_snapshot_timestamp () → timestamp with time zone

Возвращает время текущего снимка статистики.

pg_stat_get_xact_blocks_fetched ( oid ) → bigint

Возвращает количество запросов на чтение блоков для таблицы или индекса в текущей транзакции. Это число минус pg_stat_get_xact_blocks_hit даёт количество обращений к ядру функцией read(); количество реальных физических операций чтения обычно меньше благодаря буферизации на уровне ядра.

pg_stat_get_xact_blocks_hit ( oid ) → bigint

Возвращает количество запросов на чтение блоков, уже обнаруженных в кеше, для таблицы или индекса в текущей транзакции (не вызывает обращение к ядру функцией read()).

pg_stat_clear_snapshot () → void

Сбрасывает текущий снимок статистики.

pg_stat_reset () → void

Обнуляет все статистические счётчики в текущей базе данных.

По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.

pg_stat_reset_shared ( text ) → void

Обнуляет некоторые статистические счётчики на уровне кластера, в зависимости от аргумента. Если значение аргумента — bgwriter, обнуляются все счётчики в представлении pg_stat_bgwriter, если archiver — все счётчики в представлении pg_stat_archiver, а если wal — все счётчики в представлении pg_stat_wal.

По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.

pg_stat_reset_single_table_counters ( oid ) → void

Обнуляет статистику по отдельной таблице или индексу в текущей базе данных.

По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.

pg_stat_reset_single_function_counters ( oid ) → void

Обнуляет статистику для отдельной функции в текущей базе данных.

По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.

pg_stat_reset_slru ( text ) → void

Обнуляет статистику для отдельного SLRU-кеша или для всех SLRU-кешей в кластере. Если в аргументе передаётся NULL, обнуляются все счётчики, показанные в представлении pg_stat_slru, для всех SLRU-кешей. Также в аргументе можно передать текстовое значение CommitTs, MultiXactMember, MultiXactOffset, Notify, Serial, Subtrans или Xact, чтобы сбросить счётчики только для указанного кеша. Если в аргументе передаётся other (на самом деле это может быть любая нераспознанная строка), обнулены будут все счётчики для всех кешей, кроме перечисленных поимённо выше.

По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.

pg_stat_reset_replication_slot ( text ) → void

Сбрасывает статистику указанного в аргументе слота репликации. Если в аргументе передаётся NULL, сбрасывает статистику для всех слотов репликации.

По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.


Предупреждение

Функция pg_stat_reset() также сбрасывает счётчики, на основании которых процесс автоочистки принимает решение о запуске очистки или анализа. В результате сброса процесс автоочистки может не выполнить необходимые действия, что чревато раздуванием таблиц, потерей актуальности статистики и тому подобными проблемами. Поэтому после сброса счётчиков рекомендуется выполнить ANALYZE на уровне базы.

Функция pg_stat_get_activity, на которой основано представление pg_stat_activity, возвращает набор строк, содержащих всю доступную информацию о каждом серверном процессе. Иногда более удобным оказывается получение только части этой информации. В таких случаях можно использовать набор более старых функций, дающих доступ к статистике на уровне серверных процессов; эти функции описаны в Таблице 28.33. Эти функции используют идентификатор серверного процесса, значение которого варьируется от единицы до числа активных в настоящий момент серверных процессов. Функция pg_stat_get_backend_idset генерирует по одной строке для каждого активного серверного процесса, что необходимо для вызова этих функций. Например, для того, чтобы отобразить значения PID и текущие запросы всех серверных процессов:

SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
       pg_stat_get_backend_activity(s.backendid) AS query
    FROM (SELECT pg_stat_get_backend_idset() AS backendid) AS s;

Таблица 28.33. Статистические функции на уровне серверных процессов

Функция

Описание

pg_stat_get_backend_idset () → setof integer

Выдаёт идентификаторы активных в настоящий момент серверных процессов (от 1 до числа активных процессов).

pg_stat_get_backend_activity ( integer ) → text

Выдаёт текст последнего запроса этого серверного процесса.

pg_stat_get_backend_activity_start ( integer ) → timestamp with time zone

Выдаёт время начала выполнения последнего запроса в рамках данного процесса.

pg_stat_get_backend_client_addr ( integer ) → inet

Выдаёт IP-адрес клиента, подключённого к этому серверному процессу.

pg_stat_get_backend_client_port ( integer ) → integer

Выдаёт номер TCP-порта, который клиент использует для взаимодействия с сервером.

pg_stat_get_backend_dbid ( integer ) → oid

Выдаёт OID базы данных, к которой подключён этот серверный процесс.

pg_stat_get_backend_pid ( integer ) → integer

Выдаёт идентификатор (PID) этого серверного процесса.

pg_stat_get_backend_start ( integer ) → timestamp with time zone

Выдаёт время, когда был запущен данный процесс.

pg_stat_get_backend_userid ( integer ) → oid

Выдаёт OID пользователя, подключённого к этому серверному процессу.

pg_stat_get_backend_wait_event_type ( integer ) → text

Выдаёт имя типа ожидаемого события, если серверный процесс сейчас находится в состоянии ожидания, или NULL в противном случае. За подробностями обратитесь к Таблице 28.4.

pg_stat_get_backend_wait_event ( integer ) → text

Выдаёт имя ожидаемого события, если серверный процесс сейчас находится в состоянии ожидания, или NULL в противном случае. См. также Таблица 28.5Таблица 28.13.

pg_stat_get_backend_xact_start ( integer ) → timestamp with time zone

Выдаёт время начала текущей транзакции в данном процессе.