PostgreSQL : Документация: 17: 27.2. Система накопительной статистики : Компания Postgres Professional

RU
EN
RU EN

27.2. Система накопительной статистики
Пред.	Наверх	Глава 27. Мониторинг работы СУБД	Начало	След.

27.2. Система накопительной статистики #

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

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

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

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

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

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

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

Параметр track_io_timing включает мониторинг времени чтения, записи и расширения блоков, а также времени их синхронизации с файловой системой.

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

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

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

27.2.2. Просмотр статистики #

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

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

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

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

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

Таблица 27.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_recovery_prefetch`	Только одна строка со статистикой блоков, предварительно выбранных во время восстановления. Подробности в `pg_stat_recovery_prefetch`.
`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`. См. Подраздел 27.4.1.
`pg_stat_progress_create_index`	По одной строке с текущим состоянием для каждого обслуживающего процесса, в котором выполняется `CREATE INDEX` или `REINDEX`. См. Подраздел 27.4.4.
`pg_stat_progress_vacuum`	По одной строке с текущим состоянием для каждого обслуживающего процесса (включая рабочие процессы автоочистки), в котором работает `VACUUM`. См. Подраздел 27.4.5.
`pg_stat_progress_cluster`	По одной строке с текущим состоянием для каждого обслуживающего процесса, в котором выполняется `CLUSTER` или `VACUUM FULL`. См. Подраздел 27.4.2.
`pg_stat_progress_basebackup`	По одной строке с текущим состоянием для каждого передающего WAL процесса, транслирующего базовую копию. См. Подраздел 27.4.6.
`pg_stat_progress_copy`	По одной строке с текущим состоянием для каждого обслуживающего процесса, в котором выполняется `COPY`. См. Подраздел 27.4.3.

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

Имя представления	Описание
`pg_stat_archiver`	Только одна строка со статистикой работы процесса архивации WAL. Подробности в `pg_stat_archiver`.
`pg_stat_bgwriter`	Только одна строка со статистикой работы фонового процесса записи. Подробности в `pg_stat_bgwriter`.
`pg_stat_checkpointer`	Только одна строка со статистикой работы процесса контрольных точек. Подробности в `pg_stat_checkpointer`.
`pg_stat_database`	Одна строка для каждой базы данных со статистикой на уровне базы. Подробности в `pg_stat_database`.
`pg_stat_database_conflicts`	По одной строке на каждую базу данных со статистикой по отменам запросов, выполненным вследствие конфликта с процессами восстановления на ведомых серверах. Подробности в `pg_stat_database_conflicts`.
`pg_stat_io`	Одна строка для каждой комбинации типа обслуживающего процесса, контекста и целевого объекта, содержащая статистику ввода-вывода для всего кластера. За подробностями обратитесь к `pg_stat_io`.
`pg_stat_replication_slots`	По одной строке со статистикой по использованию слота репликации для каждого такого слота. Подробности в `pg_stat_replication_slots`.
`pg_stat_slru`	Одна строка со статистикой работы для каждого SLRU-кеша. Подробности в `pg_stat_slru`.
`pg_stat_subscription_stats`	Одна строка для каждой подписки, показывающая статистику ошибок. Подробности в `pg_stat_subscription_stats`.
`pg_stat_wal`	Только одна строка со статистикой работы WAL. Подробности в `pg_stat_wal`.
`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_stat_user_functions`	По одной строке для каждой отслеживаемой функции со статистикой по выполнениям этой функции. Подробности в `pg_stat_user_functions`.
`pg_stat_xact_user_functions`	Аналогично `pg_stat_user_functions`, однако подсчитываются только вызовы функций, выполненные в текущей транзакции (которые ещё не были включены в `pg_stat_user_functions`).
`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_statio_ и pg_stat_io полезны для определения эффективности кеша буфера. Их можно использовать для расчёта процента попадания в кеш. Обратите внимание: в статистике ввода-вывода PostgreSQL фиксируется большинство случаев вызова ядра для выполнения ввода-вывода, но не разграничиваются случаи, когда обращение к данным, которые необходимо получить с диска или данным, которые уже находятся в кеше страниц ядра. Пользователям рекомендуется использовать статистические представления PostgreSQL в сочетании с утилитами операционной системы для получения более полной картины производительности ввода-вывода в базе данных.

27.2.3. `pg_stat_activity` #

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

Таблица 27.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. См. Таблицу 27.4.
`wait_event` `text` Имя ожидаемого события, если обслуживающий процесс находится в состоянии ожидания, а в противном случае — NULL. См. также Таблица 27.5 – Таблица 27.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` Идентификатор транзакции верхнего уровня данного серверного процесса, если есть; см. Раздел 66.1.
`backend_xmin` `xid` Текущая граница `xmin` для серверного процесса.
`query_id` `bigint` Идентификатор последнего запроса этого серверного процесса. Если `state` имеет значение `active`, то в этом поле отображается идентификатор запроса, выполняемого в данный момент. Если процесс находится в любом другом состоянии, то в этом поле отображается идентификатор последнего выполненного запроса. По умолчанию идентификаторы запросов не вычисляются, поэтому данное поле будет иметь значение NULL, если не включён параметр compute_query_id или если не загружен сторонний модуль, вычисляющий идентификаторы запросов.
`query` `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`, `standalone backend`, `startup`, `walreceiver`, `walsender`, `walwriter` и `walsummarizer`. Кроме того, фоновые рабочие процессы, регистрируемые расширениями, могут иметь дополнительные типы.

Тип столбца

Описание

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. См. Таблицу 27.4.

wait_event text

Имя ожидаемого события, если обслуживающий процесс находится в состоянии ожидания, а в противном случае — NULL. См. также Таблица 27.5 – Таблица 27.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

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

backend_xmin xid

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

query_id bigint

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

query 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, standalone backend, startup, walreceiver, walsender, walwriter и walsummarizer. Кроме того, фоновые рабочие процессы, регистрируемые расширениями, могут иметь дополнительные типы.

Примечание

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

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

Тип события ожидания	Описание
`Activity`	Серверный процесс простаивает. Это состояние показывает, что процесс ожидает активности в основном цикле обработки. В `wait_event` обозначается конкретное место ожидания; см. Таблицу 27.5.
`BufferPin`	Серверный процесс ожидает исключительного доступа к буферу данных. Ожидание закрепления буфера может растягиваться, если другой процесс удерживает открытый курсор, который до этого читал данные из целевого буфера. См. Таблицу 27.6.
`Client`	Серверный процесс ожидает в сокете некоторую активность пользовательского приложения. То есть сервер ждёт, что произойдёт какое-то событие, не зависящее от его внутренних процессов. В `wait_event` обозначается конкретное место ожидания; см. Таблицу 27.7.
`Extension`	Серверный процесс ожидает условия, возникающего в модуле расширения. См. Таблицу 27.8.
`InjectionPoint`	Серверный процесс ожидает, пока точка внедрения достигнет заданного в тесте результата. За подробностями обратитесь к Подразделу 36.10.13. Этот тип не имеет предопределённых точек ожидания.
`IO`	Серверный процесс ожидает завершения операции ввода/вывода. В `wait_event` обозначается конкретное место ожидания; см. Таблицу 27.9.
`IPC`	Серверный процесс ожидает взаимодействия с другим процессом. В `wait_event` обозначается конкретное место ожидания; см. Таблицу 27.10.
`Lock`	Серверный процесс ожидает тяжёлую блокировку. Тяжёлые блокировки, также называемые блокировками менеджера блокировок или просто блокировками, в основном защищают объекты уровня SQL, такие как таблицы. Однако они также применяются для взаимоисключающего выполнения некоторых внутренних операций, например, расширения отношений. Тип ожидаемой блокировки показывается в `wait_event`; см. Таблицу 27.11.
`LWLock`	Серверный процесс ожидает лёгкую блокировку. В большинстве своём такие блокировки защищают определённые структуры данных в общей памяти. В `wait_event` будет содержаться имя, отражающее цель получения лёгкой блокировки. (Некоторые блокировки имеют особые имена; другие объединяются в группы блокировок с похожим предназначением.) См. Таблицу 27.12.
`Timeout`	Серверный процесс ожидает истечения определённого времени. В `wait_event` обозначается конкретное место ожидания; см. Таблицу 27.13.

Таблица 27.5. Wait Events of Type Activity

`Activity` Wait Event	Description
`ArchiverMain`	Waiting in main loop of archiver process.
`AutovacuumMain`	Waiting in main loop of autovacuum launcher process.
`BgwriterHibernate`	Waiting in background writer process, hibernating.
`BgwriterMain`	Waiting in main loop of background writer process.
`CheckpointerMain`	Waiting in main loop of checkpointer process.
`LogicalApplyMain`	Waiting in main loop of logical replication apply process.
`LogicalLauncherMain`	Waiting in main loop of logical replication launcher process.
`LogicalParallelApplyMain`	Waiting in main loop of logical replication parallel apply process.
`RecoveryWalStream`	Waiting in main loop of startup process for WAL to arrive, during streaming recovery.
`ReplicationSlotsyncMain`	Waiting in main loop of slot sync worker.
`ReplicationSlotsyncShutdown`	Waiting for slot sync worker to shut down.
`SysloggerMain`	Waiting in main loop of syslogger process.
`WalReceiverMain`	Waiting in main loop of WAL receiver process.
`WalSenderMain`	Waiting in main loop of WAL sender process.
`WalSummarizerWal`	Waiting in WAL summarizer for more WAL to be generated.
`WalWriterMain`	Waiting in main loop of WAL writer process.

Таблица 27.6. Wait Events of Type Bufferpin

`BufferPin` Wait Event	Description
`BufferPin`	Waiting to acquire an exclusive pin on a buffer.

Таблица 27.7. Wait Events of Type Client

`Client` Wait Event	Description
`ClientRead`	Waiting to read data from the client.
`ClientWrite`	Waiting to write data to the client.
`GssOpenServer`	Waiting to read data from the client while establishing a GSSAPI session.
`LibpqwalreceiverConnect`	Waiting in WAL receiver to establish connection to remote server.
`LibpqwalreceiverReceive`	Waiting in WAL receiver to receive data from remote server.
`SslOpenServer`	Waiting for SSL while attempting connection.
`WaitForStandbyConfirmation`	Waiting for WAL to be received and flushed by the physical standby.
`WalSenderWaitForWal`	Waiting for WAL to be flushed in WAL sender process.
`WalSenderWriteData`	Waiting for any activity when processing replies from WAL receiver in WAL sender process.

Таблица 27.8. Wait Events of Type Extension

`Extension` Wait Event	Description
`Extension`	Waiting in an extension.

Таблица 27.9. Wait Events of Type Io

`IO` Wait Event	Description
`BasebackupRead`	Waiting for base backup to read from a file.
`BasebackupSync`	Waiting for data written by a base backup to reach durable storage.
`BasebackupWrite`	Waiting for base backup to write to a file.
`BuffileRead`	Waiting for a read from a buffered file.
`BuffileTruncate`	Waiting for a buffered file to be truncated.
`BuffileWrite`	Waiting for a write to a buffered file.
`ControlFileRead`	Waiting for a read from the `pg_control` file.
`ControlFileSync`	Waiting for the `pg_control` file to reach durable storage.
`ControlFileSyncUpdate`	Waiting for an update to the `pg_control` file to reach durable storage.
`ControlFileWrite`	Waiting for a write to the `pg_control` file.
`ControlFileWriteUpdate`	Waiting for a write to update the `pg_control` file.
`CopyFileRead`	Waiting for a read during a file copy operation.
`CopyFileWrite`	Waiting for a write during a file copy operation.
`DataFileExtend`	Waiting for a relation data file to be extended.
`DataFileFlush`	Waiting for a relation data file to reach durable storage.
`DataFileImmediateSync`	Waiting for an immediate synchronization of a relation data file to durable storage.
`DataFilePrefetch`	Waiting for an asynchronous prefetch from a relation data file.
`DataFileRead`	Waiting for a read from a relation data file.
`DataFileSync`	Waiting for changes to a relation data file to reach durable storage.
`DataFileTruncate`	Waiting for a relation data file to be truncated.
`DataFileWrite`	Waiting for a write to a relation data file.
`DsmAllocate`	Waiting for a dynamic shared memory segment to be allocated.
`DsmFillZeroWrite`	Waiting to fill a dynamic shared memory backing file with zeroes.
`LockFileAddtodatadirRead`	Waiting for a read while adding a line to the data directory lock file.
`LockFileAddtodatadirSync`	Waiting for data to reach durable storage while adding a line to the data directory lock file.
`LockFileAddtodatadirWrite`	Waiting for a write while adding a line to the data directory lock file.
`LockFileCreateRead`	Waiting to read while creating the data directory lock file.
`LockFileCreateSync`	Waiting for data to reach durable storage while creating the data directory lock file.
`LockFileCreateWrite`	Waiting for a write while creating the data directory lock file.
`LockFileRecheckdatadirRead`	Waiting for a read during recheck of the data directory lock file.
`LogicalRewriteCheckpointSync`	Waiting for logical rewrite mappings to reach durable storage during a checkpoint.
`LogicalRewriteMappingSync`	Waiting for mapping data to reach durable storage during a logical rewrite.
`LogicalRewriteMappingWrite`	Waiting for a write of mapping data during a logical rewrite.
`LogicalRewriteSync`	Waiting for logical rewrite mappings to reach durable storage.
`LogicalRewriteTruncate`	Waiting for truncate of mapping data during a logical rewrite.
`LogicalRewriteWrite`	Waiting for a write of logical rewrite mappings.
`RelationMapRead`	Waiting for a read of the relation map file.
`RelationMapReplace`	Waiting for durable replacement of a relation map file.
`RelationMapWrite`	Waiting for a write to the relation map file.
`ReorderBufferRead`	Waiting for a read during reorder buffer management.
`ReorderBufferWrite`	Waiting for a write during reorder buffer management.
`ReorderLogicalMappingRead`	Waiting for a read of a logical mapping during reorder buffer management.
`ReplicationSlotRead`	Waiting for a read from a replication slot control file.
`ReplicationSlotRestoreSync`	Waiting for a replication slot control file to reach durable storage while restoring it to memory.
`ReplicationSlotSync`	Waiting for a replication slot control file to reach durable storage.
`ReplicationSlotWrite`	Waiting for a write to a replication slot control file.
`SlruFlushSync`	Waiting for SLRU data to reach durable storage during a checkpoint or database shutdown.
`SlruRead`	Waiting for a read of an SLRU page.
`SlruSync`	Waiting for SLRU data to reach durable storage following a page write.
`SlruWrite`	Waiting for a write of an SLRU page.
`SnapbuildRead`	Waiting for a read of a serialized historical catalog snapshot.
`SnapbuildSync`	Waiting for a serialized historical catalog snapshot to reach durable storage.
`SnapbuildWrite`	Waiting for a write of a serialized historical catalog snapshot.
`TimelineHistoryFileSync`	Waiting for a timeline history file received via streaming replication to reach durable storage.
`TimelineHistoryFileWrite`	Waiting for a write of a timeline history file received via streaming replication.
`TimelineHistoryRead`	Waiting for a read of a timeline history file.
`TimelineHistorySync`	Waiting for a newly created timeline history file to reach durable storage.
`TimelineHistoryWrite`	Waiting for a write of a newly created timeline history file.
`TwophaseFileRead`	Waiting for a read of a two phase state file.
`TwophaseFileSync`	Waiting for a two phase state file to reach durable storage.
`TwophaseFileWrite`	Waiting for a write of a two phase state file.
`VersionFileSync`	Waiting for the version file to reach durable storage while creating a database.
`VersionFileWrite`	Waiting for the version file to be written while creating a database.
`WalsenderTimelineHistoryRead`	Waiting for a read from a timeline history file during a walsender timeline command.
`WalBootstrapSync`	Waiting for WAL to reach durable storage during bootstrapping.
`WalBootstrapWrite`	Waiting for a write of a WAL page during bootstrapping.
`WalCopyRead`	Waiting for a read when creating a new WAL segment by copying an existing one.
`WalCopySync`	Waiting for a new WAL segment created by copying an existing one to reach durable storage.
`WalCopyWrite`	Waiting for a write when creating a new WAL segment by copying an existing one.
`WalInitSync`	Waiting for a newly initialized WAL file to reach durable storage.
`WalInitWrite`	Waiting for a write while initializing a new WAL file.
`WalRead`	Waiting for a read from a WAL file.
`WalSummaryRead`	Waiting for a read from a WAL summary file.
`WalSummaryWrite`	Waiting for a write to a WAL summary file.
`WalSync`	Waiting for a WAL file to reach durable storage.
`WalSyncMethodAssign`	Waiting for data to reach durable storage while assigning a new WAL sync method.
`WalWrite`	Waiting for a write to a WAL file.

Таблица 27.10. Wait Events of Type Ipc

`IPC` Wait Event	Description
`AppendReady`	Waiting for subplan nodes of an `Append` plan node to be ready.
`ArchiveCleanupCommand`	Waiting for archive_cleanup_command to complete.
`ArchiveCommand`	Waiting for archive_command to complete.
`BackendTermination`	Waiting for the termination of another backend.
`BackupWaitWalArchive`	Waiting for WAL files required for a backup to be successfully archived.
`BgworkerShutdown`	Waiting for background worker to shut down.
`BgworkerStartup`	Waiting for background worker to start up.
`BtreePage`	Waiting for the page number needed to continue a parallel B-tree scan to become available.
`BufferIo`	Waiting for buffer I/O to complete.
`CheckpointDelayComplete`	Waiting for a backend that blocks a checkpoint from completing.
`CheckpointDelayStart`	Waiting for a backend that blocks a checkpoint from starting.
`CheckpointDone`	Waiting for a checkpoint to complete.
`CheckpointStart`	Waiting for a checkpoint to start.
`ExecuteGather`	Waiting for activity from a child process while executing a `Gather` plan node.
`HashBatchAllocate`	Waiting for an elected Parallel Hash participant to allocate a hash table.
`HashBatchElect`	Waiting to elect a Parallel Hash participant to allocate a hash table.
`HashBatchLoad`	Waiting for other Parallel Hash participants to finish loading a hash table.
`HashBuildAllocate`	Waiting for an elected Parallel Hash participant to allocate the initial hash table.
`HashBuildElect`	Waiting to elect a Parallel Hash participant to allocate the initial hash table.
`HashBuildHashInner`	Waiting for other Parallel Hash participants to finish hashing the inner relation.
`HashBuildHashOuter`	Waiting for other Parallel Hash participants to finish partitioning the outer relation.
`HashGrowBatchesDecide`	Waiting to elect a Parallel Hash participant to decide on future batch growth.
`HashGrowBatchesElect`	Waiting to elect a Parallel Hash participant to allocate more batches.
`HashGrowBatchesFinish`	Waiting for an elected Parallel Hash participant to decide on future batch growth.
`HashGrowBatchesReallocate`	Waiting for an elected Parallel Hash participant to allocate more batches.
`HashGrowBatchesRepartition`	Waiting for other Parallel Hash participants to finish repartitioning.
`HashGrowBucketsElect`	Waiting to elect a Parallel Hash participant to allocate more buckets.
`HashGrowBucketsReallocate`	Waiting for an elected Parallel Hash participant to finish allocating more buckets.
`HashGrowBucketsReinsert`	Waiting for other Parallel Hash participants to finish inserting tuples into new buckets.
`LogicalApplySendData`	Waiting for a logical replication leader apply process to send data to a parallel apply process.
`LogicalParallelApplyStateChange`	Waiting for a logical replication parallel apply process to change state.
`LogicalSyncData`	Waiting for a logical replication remote server to send data for initial table synchronization.
`LogicalSyncStateChange`	Waiting for a logical replication remote server to change state.
`MessageQueueInternal`	Waiting for another process to be attached to a shared message queue.
`MessageQueuePutMessage`	Waiting to write a protocol message to a shared message queue.
`MessageQueueReceive`	Waiting to receive bytes from a shared message queue.
`MessageQueueSend`	Waiting to send bytes to a shared message queue.
`MultixactCreation`	Waiting for a multixact creation to complete.
`ParallelBitmapScan`	Waiting for parallel bitmap scan to become initialized.
`ParallelCreateIndexScan`	Waiting for parallel `CREATE INDEX` workers to finish heap scan.
`ParallelFinish`	Waiting for parallel workers to finish computing.
`ProcarrayGroupUpdate`	Waiting for the group leader to clear the transaction ID at transaction end.
`ProcSignalBarrier`	Waiting for a barrier event to be processed by all backends.
`Promote`	Waiting for standby promotion.
`RecoveryConflictSnapshot`	Waiting for recovery conflict resolution for a vacuum cleanup.
`RecoveryConflictTablespace`	Waiting for recovery conflict resolution for dropping a tablespace.
`RecoveryEndCommand`	Waiting for recovery_end_command to complete.
`RecoveryPause`	Waiting for recovery to be resumed.
`ReplicationOriginDrop`	Waiting for a replication origin to become inactive so it can be dropped.
`ReplicationSlotDrop`	Waiting for a replication slot to become inactive so it can be dropped.
`RestoreCommand`	Waiting for restore_command to complete.
`SafeSnapshot`	Waiting to obtain a valid snapshot for a `READ ONLY DEFERRABLE` transaction.
`SyncRep`	Waiting for confirmation from a remote server during synchronous replication.
`WalReceiverExit`	Waiting for the WAL receiver to exit.
`WalReceiverWaitStart`	Waiting for startup process to send initial data for streaming replication.
`WalSummaryReady`	Waiting for a new WAL summary to be generated.
`XactGroupUpdate`	Waiting for the group leader to update transaction status at transaction end.

Таблица 27.11. Wait Events of Type Lock

`Lock` Wait Event	Description
`advisory`	Waiting to acquire an advisory user lock.
`applytransaction`	Waiting to acquire a lock on a remote transaction being applied by a logical replication subscriber.
`extend`	Waiting to extend a relation.
`frozenid`	Waiting to update `pg_database`.`datfrozenxid` and `pg_database`.`datminmxid`.
`object`	Waiting to acquire a lock on a non-relation database object.
`page`	Waiting to acquire a lock on a page of a relation.
`relation`	Waiting to acquire a lock on a relation.
`spectoken`	Waiting to acquire a speculative insertion lock.
`transactionid`	Waiting for a transaction to finish.
`tuple`	Waiting to acquire a lock on a tuple.
`userlock`	Waiting to acquire a user lock.
`virtualxid`	Waiting to acquire a virtual transaction ID lock; see Раздел 66.1.

Таблица 27.12. Wait Events of Type Lwlock

`LWLock` Wait Event	Description
`AddinShmemInit`	Waiting to manage an extension's space allocation in shared memory.
`AutoFile`	Waiting to update the `postgresql.auto.conf` file.
`Autovacuum`	Waiting to read or update the current state of autovacuum workers.
`AutovacuumSchedule`	Waiting to ensure that a table selected for autovacuum still needs vacuuming.
`BackgroundWorker`	Waiting to read or update background worker state.
`BtreeVacuum`	Waiting to read or update vacuum-related information for a B-tree index.
`BufferContent`	Waiting to access a data page in memory.
`BufferMapping`	Waiting to associate a data block with a buffer in the buffer pool.
`CheckpointerComm`	Waiting to manage fsync requests.
`CommitTs`	Waiting to read or update the last value set for a transaction commit timestamp.
`CommitTsBuffer`	Waiting for I/O on a commit timestamp SLRU buffer.
`CommitTsSLRU`	Waiting to access the commit timestamp SLRU cache.
`ControlFile`	Waiting to read or update the `pg_control` file or create a new WAL file.
`DSMRegistry`	Waiting to read or update the dynamic shared memory registry.
`DSMRegistryDSA`	Waiting to access dynamic shared memory registry's dynamic shared memory allocator.
`DSMRegistryHash`	Waiting to access dynamic shared memory registry's shared hash table.
`DynamicSharedMemoryControl`	Waiting to read or update dynamic shared memory allocation information.
`InjectionPoint`	Waiting to read or update information related to injection points.
`LockFastPath`	Waiting to read or update a process' fast-path lock information.
`LockManager`	Waiting to read or update information about «heavyweight» locks.
`LogicalRepLauncherDSA`	Waiting to access logical replication launcher's dynamic shared memory allocator.
`LogicalRepLauncherHash`	Waiting to access logical replication launcher's shared hash table.
`LogicalRepWorker`	Waiting to read or update the state of logical replication workers.
`MultiXactGen`	Waiting to read or update shared multixact state.
`MultiXactMemberBuffer`	Waiting for I/O on a multixact member SLRU buffer.
`MultiXactMemberSLRU`	Waiting to access the multixact member SLRU cache.
`MultiXactOffsetBuffer`	Waiting for I/O on a multixact offset SLRU buffer.
`MultiXactOffsetSLRU`	Waiting to access the multixact offset SLRU cache.
`MultiXactTruncation`	Waiting to read or truncate multixact information.
`NotifyBuffer`	Waiting for I/O on a `NOTIFY` message SLRU buffer.
`NotifyQueue`	Waiting to read or update `NOTIFY` messages.
`NotifyQueueTail`	Waiting to update limit on `NOTIFY` message storage.
`NotifySLRU`	Waiting to access the `NOTIFY` message SLRU cache.
`OidGen`	Waiting to allocate a new OID.
`ParallelAppend`	Waiting to choose the next subplan during Parallel Append plan execution.
`ParallelHashJoin`	Waiting to synchronize workers during Parallel Hash Join plan execution.
`ParallelQueryDSA`	Waiting for parallel query dynamic shared memory allocation.
`ParallelVacuumDSA`	Waiting for parallel vacuum dynamic shared memory allocation.
`PerSessionDSA`	Waiting for parallel query dynamic shared memory allocation.
`PerSessionRecordType`	Waiting to access a parallel query's information about composite types.
`PerSessionRecordTypmod`	Waiting to access a parallel query's information about type modifiers that identify anonymous record types.
`PerXactPredicateList`	Waiting to access the list of predicate locks held by the current serializable transaction during a parallel query.
`PgStatsData`	Waiting for shared memory stats data access.
`PgStatsDSA`	Waiting for stats dynamic shared memory allocator access.
`PgStatsHash`	Waiting for stats shared memory hash table access.
`PredicateLockManager`	Waiting to access predicate lock information used by serializable transactions.
`ProcArray`	Waiting to access the shared per-process data structures (typically, to get a snapshot or report a session's transaction ID).
`RelationMapping`	Waiting to read or update a `pg_filenode.map` file (used to track the filenode assignments of certain system catalogs).
`RelCacheInit`	Waiting to read or update a `pg_internal.init` relation cache initialization file.
`ReplicationOrigin`	Waiting to create, drop or use a replication origin.
`ReplicationOriginState`	Waiting to read or update the progress of one replication origin.
`ReplicationSlotAllocation`	Waiting to allocate or free a replication slot.
`ReplicationSlotControl`	Waiting to read or update replication slot state.
`ReplicationSlotIO`	Waiting for I/O on a replication slot.
`SerialBuffer`	Waiting for I/O on a serializable transaction conflict SLRU buffer.
`SerialControl`	Waiting to read or update shared `pg_serial` state.
`SerializableFinishedList`	Waiting to access the list of finished serializable transactions.
`SerializablePredicateList`	Waiting to access the list of predicate locks held by serializable transactions.
`SerializableXactHash`	Waiting to read or update information about serializable transactions.
`SerialSLRU`	Waiting to access the serializable transaction conflict SLRU cache.
`SharedTidBitmap`	Waiting to access a shared TID bitmap during a parallel bitmap index scan.
`SharedTupleStore`	Waiting to access a shared tuple store during parallel query.
`ShmemIndex`	Waiting to find or allocate space in shared memory.
`SInvalRead`	Waiting to retrieve messages from the shared catalog invalidation queue.
`SInvalWrite`	Waiting to add a message to the shared catalog invalidation queue.
`SubtransBuffer`	Waiting for I/O on a sub-transaction SLRU buffer.
`SubtransSLRU`	Waiting to access the sub-transaction SLRU cache.
`SyncRep`	Waiting to read or update information about the state of synchronous replication.
`SyncScan`	Waiting to select the starting location of a synchronized table scan.
`TablespaceCreate`	Waiting to create or drop a tablespace.
`TwoPhaseState`	Waiting to read or update the state of prepared transactions.
`WaitEventCustom`	Waiting to read or update custom wait events information.
`WALBufMapping`	Waiting to replace a page in WAL buffers.
`WALInsert`	Waiting to insert WAL data into a memory buffer.
`WALSummarizer`	Waiting to read or update WAL summarization state.
`WALWrite`	Waiting for WAL buffers to be written to disk.
`WrapLimitsVacuum`	Waiting to update limits on transaction id and multixact consumption.
`XactBuffer`	Waiting for I/O on a transaction status SLRU buffer.
`XactSLRU`	Waiting to access the transaction status SLRU cache.
`XactTruncation`	Waiting to execute `pg_xact_status` or update the oldest transaction ID available to it.
`XidGen`	Waiting to allocate a new transaction ID.

Таблица 27.13. Wait Events of Type Timeout

`Timeout` Wait Event	Description
`BaseBackupThrottle`	Waiting during base backup when throttling activity.
`CheckpointWriteDelay`	Waiting between writes while performing a checkpoint.
`PgSleep`	Waiting due to a call to `pg_sleep` or a sibling function.
`RecoveryApplyDelay`	Waiting to apply WAL during recovery because of a delay setting.
`RecoveryRetrieveRetryInterval`	Waiting during recovery when WAL data is not available from any source (`pg_wal`, archive or stream).
`RegisterSyncRequest`	Waiting while sending synchronization requests to the checkpointer, because the request queue is full.
`SpinDelay`	Waiting while acquiring a contended spinlock.
`VacuumDelay`	Waiting in a cost-based vacuum delay point.
`VacuumTruncate`	Waiting to acquire an exclusive lock to truncate off any empty pages at the end of a table vacuumed.
`WalSummarizerError`	Waiting after a WAL summarizer error.

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

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)

SELECT a.pid, a.wait_event, w.description
  FROM pg_stat_activity a JOIN
       pg_wait_events w ON (a.wait_event_type = w.type AND
                            a.wait_event = w.name)
  WHERE a.wait_event is NOT NULL and a.state = 'active';
-[ RECORD 1 ]------------------------------------------------------------------
pid         | 686674
wait_event  | WALInitSync
description | Waiting for a newly initialized WAL file to reach durable storage

Примечание

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

27.2.4. `pg_stat_replication` #

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

Таблица 27.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` Время отправки последнего ответного сообщения, полученного от ведомого сервера

Тип столбца

Описание

pid integer

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

usesysid oid

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

usename name

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

application_name text

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

client_addr inet

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

client_hostname text

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 или продолжать показывать последнее известное значение.

27.2.5. `pg_stat_replication_slots` #

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

Таблица 27.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` Последнее время сброса этих статистических данных

Тип столбца

Описание

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

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

27.2.6. `pg_stat_wal_receiver` #

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

Таблица 27.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 (секретные поля в ней скрыты).

Тип столбца

Описание

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 (секретные поля в ней скрыты).

27.2.7. `pg_stat_recovery_prefetch` #

Представление pg_stat_recovery_prefetch будет содержать только одну строку. В столбцах wal_distance, block_distance и io_depth показываются текущие значения, а в других столбцах — накопительные счётчики, которые можно сбросить функцией pg_stat_reset_shared.

Таблица 27.17. Представление pg_stat_recovery_prefetch

Тип столбца Описание
`stats_reset` `timestamp with time zone` Последнее время сброса этих статистических данных
`prefetch` `bigint` Количество блоков, выбранных предварительно ввиду их отсутствия в пуле буферов
`hit` `bigint` Количество блоков, не выбранных предварительно из-за того, что они уже находились в пуле буферов
`skip_init` `bigint` Количество блоков, не выбранных предварительно, потому что они должны инициализироваться нулями
`skip_new` `bigint` Количество блоков, не выбранных предварительно, потому что они не существовали
`skip_fpw` `bigint` Количество блоков, не выбранных предварительно, так как в WAL были записаны образы полных страниц
`skip_rep` `bigint` Количество блоков, не выбранных предварительно, потому что они были предвыбраны ранее
`wal_distance` `int` Объём WAL, просматриваемый для предвыборки блоков (в байтах)
`block_distance` `int` Количество блоков в процессе предвыборки
`io_depth` `int` Число инициированных операций предвыборки, которые ещё не считаются завершёнными

Тип столбца

Описание

stats_reset timestamp with time zone

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

prefetch bigint

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

hit bigint

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

skip_init bigint

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

skip_new bigint

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

skip_fpw bigint

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

skip_rep bigint

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

wal_distance int

Объём WAL, просматриваемый для предвыборки блоков (в байтах)

block_distance int

Количество блоков в процессе предвыборки

io_depth int

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

27.2.8. `pg_stat_subscription` #

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

Тип столбца Описание
`subid` `oid` OID подписки
`subname` `name` Имя подписки
`worker_type` `text` Тип рабочего процесса подписки. Возможные варианты: `apply`, `parallel apply` и `table synchronize`.
`pid` `integer` Идентификатор рабочего процесса, обслуживающего подписку
`leader_pid` `integer` Идентификатор ведущего рабочего процесса применения, если этот процесс является параллельным рабочим процессом применения; NULL, если этот процесс является ведущим процессом применения изменений или рабочим процессом синхронизации таблиц
`relid` `oid` OID отношения, которое синхронизирует рабочий процесс сейчас; NULL для ведущего и параллельных процессов применения изменений
`received_lsn` `pg_lsn` Последняя позиция в журнале предзаписи (начальное значение этого поля — 0); NULL для параллельных рабочих процессов применения
`last_msg_send_time` `timestamp with time zone` Время отправки последнего сообщения, полученного от изначального передатчика WAL; NULL для параллельных рабочих процессов применения изменений
`last_msg_receipt_time` `timestamp with time zone` Время поступления последнего сообщения, полученного от изначального передатчика WAL; NULL для параллельных рабочих процессов применения изменений
`latest_end_lsn` `pg_lsn` Последняя позиция в журнале предзаписи, сообщённая изначальному передатчику WAL; NULL для параллельных рабочих процессов применения изменений
`latest_end_time` `timestamp with time zone` Время последней позиции в журнале предзаписи, сообщённой изначальному передатчику WAL; NULL для параллельных рабочих процессов применения изменений

Тип столбца

Описание

subid oid

OID подписки

subname name

Имя подписки

worker_type text

Тип рабочего процесса подписки. Возможные варианты: apply, parallel apply и table synchronize.

pid integer

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

leader_pid integer

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

relid oid

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

received_lsn pg_lsn

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

last_msg_send_time timestamp with time zone

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

last_msg_receipt_time timestamp with time zone

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

latest_end_lsn pg_lsn

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

latest_end_time timestamp with time zone

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

27.2.9. `pg_stat_subscription_stats` #

Представление pg_stat_subscription_stats будет содержать одну строку для каждой подписки.

Таблица 27.19. Представление pg_stat_subscription_stats

Тип столбца Описание
`subid` `oid` OID подписки
`subname` `name` Имя подписки
`apply_error_count` `bigint` Число ошибок, возникших при применении изменений
`sync_error_count` `bigint` Число ошибок, возникших во время начальной синхронизации таблиц
`stats_reset` `timestamp with time zone` Последнее время сброса этих статистических данных

Тип столбца

Описание

subid oid

OID подписки

subname name

Имя подписки

apply_error_count bigint

Число ошибок, возникших при применении изменений

sync_error_count bigint

Число ошибок, возникших во время начальной синхронизации таблиц

stats_reset timestamp with time zone

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

27.2.10. `pg_stat_ssl` #

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

Таблица 27.20. Представление 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`.

Тип столбца

Описание

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.

27.2.11. `pg_stat_gssapi` #

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

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

Тип столбца Описание
`pid` `integer` Идентификатор (PID) обслуживающего процесса
`gss_authenticated` `boolean` True, если для этого подключения используется аутентификация GSSAPI
`principal` `text` Принципал, для которого было аутентифицировано это подключение, либо NULL, если клиент не передал сертификат или GSSAPI для этого подключения не используется. Это значение усекается, если оказывается длиннее `NAMEDATALEN` символов (64 символа в стандартной сборке).
`encrypted` `boolean` True, если для этого подключения используется шифрование GSSAPI
`credentials_delegated` `boolean` True, если для этого подключения были делегированы учётные данные GSSAPI.

Тип столбца

Описание

pid integer

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

gss_authenticated boolean

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

principal text

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

encrypted boolean

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

credentials_delegated boolean

True, если для этого подключения были делегированы учётные данные GSSAPI.

27.2.12. `pg_stat_archiver` #

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

Таблица 27.22. Представление 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` Последнее время сброса этих статистических данных

Тип столбца

Описание

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

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

Обычно файлы WAL архивируются в порядке от старых к новым, но это не гарантируется и не выполняется при особых обстоятельствах, например при повышении ведомого сервера или после восстановления после сбоя. Поэтому считать, что все файлы старше last_archived_wal также были успешно заархивированы, небезопасно.

27.2.13. `pg_stat_io` #

Представление pg_stat_io содержит по одной строке со статистикой ввода-вывода на уровне кластера для каждой комбинации типа обслуживающего процесса, целевого объекта ввода-вывода и контекста ввода-вывода. Комбинации, не имеющие смысла, исключаются.

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

Таблица 27.23. Представление pg_stat_io

Тип столбца Описание
`backend_type` `text` Тип обслуживающего процесса (например, фоновый рабочий процесс, рабочий процесс автоочистки). Чтобы узнать больше о `backend_type`, обратитесь к описанию представления `pg_stat_activity`. По некоторым типам обслуживающих процессов (`backend_type`) не накапливается статистика операций ввода-вывода, и она не включаются в представление.
`object` `text` Целевой объект операции ввода-вывода. Возможные значения: `relation`: постоянные отношения. `temp relation`: временные отношения.
`context` `text` Контекст операции ввода-вывода. Возможные значения: `normal`: используемый по умолчанию или стандартный контекст для операции ввода-вывода этого типа. Например, по умолчанию данные отношений считываются и записываются через общий буфер, то есть операции чтения и записи, выполняемые через буфер, будут учитываться с контекстом `normal`. `vacuum`: контекст для операций ввода-вывода, выполняемых за пределами общих буферов при очистке и анализе постоянных отношений. Операции очистки временных таблиц используют тот же пул локальных буферов, что и другие операции ввода-вывода с временными таблицами, поэтому учитываются с контекстом `normal`. `bulkread`: некоторые большие операции чтения, выполняемые за пределами общих буферов, например последовательное сканирование большой таблицы. `bulkwrite`: некоторые большие операции записи, выполняемые за пределами общих буферов, например `COPY`.
`reads` `bigint` Количество операций чтения, размер каждой указан в `op_bytes`.
`read_time` `double precision` Время, затраченное операциями чтения, в миллисекундах (если включён параметр track_io_timing; в противном случае 0).
`writes` `bigint` Количество операций записи, размер каждой указан в `op_bytes`.
`write_time` `double precision` Время, затраченное операциями записи, в миллисекундах (если включён параметр track_io_timing; в противном случае 0).
`writebacks` `bigint` Количество блоков размером `op_bytes`, запрошенных процессом для записи ядром в постоянное хранилище.
`writeback_time` `double precision` Время, затраченное на операции отложенной записи, в миллисекундах (если параметр track_io_timing включён, в противном случае 0). Сюда входит время, потраченное на постановку в очередь запросов на запись, и в принципе время, потраченное на запись «грязных» данных.
`extends` `bigint` Количество операций расширения отношений, размер каждой указан в `op_bytes`.
`extend_time` `double precision` Время, затраченное операциями расширения, в миллисекундах (если включён параметр track_io_timing; в противном случае 0).
`op_bytes` `bigint` Число байтов на единицу ввода-вывода, прочитанную, записанную или расширенную. Чтение, запись и расширение отношений выполняются в единицах `block_size`, рассчитанных из параметра `BLCKSZ`, задаваемого в процессе сборки и по умолчанию равного `8192`.
`hits` `bigint` Сколько раз нужный блок был найден в общем буфере.
`evictions` `bigint` Сколько раз блок был записан из общего или локального буфера, чтобы его можно было переиспользовать. В контексте `normal` подсчитывает количество вытеснений блока из буфера и замены другим блоком. В контекстах `bulkwrite`, `bulkread` и `vacuum` подсчитывает количество вытеснений блока из общего буфера, чтобы добавить общий буфер в отдельный кольцевой буфер с ограниченным размером для использования в массовой операции ввода-вывода.
`reuses` `bigint` Сколько раз существующий буфер в кольцевом буфере с ограниченным размером за пределами общих буферов был повторно использован как часть операции ввода-вывода в контекстах `bulkread`, `bulkwrite` или `vacuum`.
`fsyncs` `bigint` Количество вызовов `fsync`. Они отслеживаются только в контексте `normal`.
`fsync_time` `double precision` Время, затраченное операциями fsync, в миллисекундах (если включён параметр track_io_timing; в противном случае 0).
`stats_reset` `timestamp with time zone` Последнее время сброса этих статистических данных.

Тип столбца

Описание

backend_type text

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

object text

Целевой объект операции ввода-вывода. Возможные значения:

relation: постоянные отношения.
temp relation: временные отношения.

context text

Контекст операции ввода-вывода. Возможные значения:

normal: используемый по умолчанию или стандартный контекст для операции ввода-вывода этого типа. Например, по умолчанию данные отношений считываются и записываются через общий буфер, то есть операции чтения и записи, выполняемые через буфер, будут учитываться с контекстом normal.
vacuum: контекст для операций ввода-вывода, выполняемых за пределами общих буферов при очистке и анализе постоянных отношений. Операции очистки временных таблиц используют тот же пул локальных буферов, что и другие операции ввода-вывода с временными таблицами, поэтому учитываются с контекстом normal.
bulkread: некоторые большие операции чтения, выполняемые за пределами общих буферов, например последовательное сканирование большой таблицы.
bulkwrite: некоторые большие операции записи, выполняемые за пределами общих буферов, например COPY.

reads bigint

Количество операций чтения, размер каждой указан в op_bytes.

read_time double precision

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

writes bigint

Количество операций записи, размер каждой указан в op_bytes.

write_time double precision

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

writebacks bigint

Количество блоков размером op_bytes, запрошенных процессом для записи ядром в постоянное хранилище.

writeback_time double precision

Время, затраченное на операции отложенной записи, в миллисекундах (если параметр track_io_timing включён, в противном случае 0). Сюда входит время, потраченное на постановку в очередь запросов на запись, и в принципе время, потраченное на запись «грязных» данных.

extends bigint

Количество операций расширения отношений, размер каждой указан в op_bytes.

extend_time double precision

Время, затраченное операциями расширения, в миллисекундах (если включён параметр track_io_timing; в противном случае 0).

op_bytes bigint

Число байтов на единицу ввода-вывода, прочитанную, записанную или расширенную.

Чтение, запись и расширение отношений выполняются в единицах block_size, рассчитанных из параметра BLCKSZ, задаваемого в процессе сборки и по умолчанию равного 8192.

hits bigint

Сколько раз нужный блок был найден в общем буфере.

evictions bigint

Сколько раз блок был записан из общего или локального буфера, чтобы его можно было переиспользовать.

В контексте normal подсчитывает количество вытеснений блока из буфера и замены другим блоком. В контекстах bulkwrite, bulkread и vacuum подсчитывает количество вытеснений блока из общего буфера, чтобы добавить общий буфер в отдельный кольцевой буфер с ограниченным размером для использования в массовой операции ввода-вывода.

reuses bigint

Сколько раз существующий буфер в кольцевом буфере с ограниченным размером за пределами общих буферов был повторно использован как часть операции ввода-вывода в контекстах bulkread, bulkwrite или vacuum.

fsyncs bigint

Количество вызовов fsync. Они отслеживаются только в контексте normal.

fsync_time double precision

Время, затраченное операциями fsync, в миллисекундах (если включён параметр track_io_timing; в противном случае 0).

stats_reset timestamp with time zone

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

Некоторые типы обслуживающих процессов никогда не выполняют операции ввода-вывода с некоторыми объектами ввода-вывода и/или в некоторых контекстах ввода-вывода. Эти строки исключаются из представления. Например, процесс контрольной точки не обрабатывает временные таблицы, поэтому не будет строк для объектов типа checkpointer объектов temp relation.

Кроме того, некоторые операции ввода-вывода никогда не будут выполняться ни некоторыми типами обслуживающих процессов, ни с некоторыми объектами ввода-вывода и/или в некоторых контекстах ввода-вывода. Эти ячейки будут иметь значение NULL. Например, fsync временных таблиц не поддерживается, поэтому fsyncs будет иметь значение NULL для object temp relation. Кроме того, фоновый рабочий процесс записи не выполняет чтение, поэтому reads будет иметь значение NULL в строках для backend_type background writer.

pg_stat_io можно использовать для информирования о настройке базы данных. Например:

Большое количество вытеснений (evictions) в столбце может указывать на необходимость увеличения общих буферов.
Чтобы гарантировать сохранение данных в постоянном хранилище, клиентские процессы задействуют процесс контрольных точек. Большое количество fsyncs со стороны client backend может указывать на неправильную настройку общих буферов или процесса контрольных точек. Настройка этого процесса подробно описана в Разделе 28.5.
Обычно клиентские процессы должны иметь возможность задействовать вспомогательные процессы, такие как процесс контрольных точек и процесс фоновой записи, для записи как можно большего количества «грязных» данных. Большое количество записей со стороны клиентских обслуживающих процессов может указывать на неправильную настройку общих буферов или процесса контрольных точек. Настройка процесса контрольных точек подробно описана в Разделе 28.5.

Примечание

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

27.2.14. `pg_stat_bgwriter` #

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

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

Тип столбца Описание
`buffers_clean` `bigint` Количество буферов, записанных фоновым процессом записи
`maxwritten_clean` `bigint` Сколько раз фоновый процесс записи останавливал сброс грязных страниц на диск из-за того, что записал слишком много буферов
`buffers_alloc` `bigint` Количество выделенных буферов
`stats_reset` `timestamp with time zone` Последнее время сброса этих статистических данных

Тип столбца

Описание

buffers_clean bigint

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

maxwritten_clean bigint

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

buffers_alloc bigint

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

stats_reset timestamp with time zone

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

27.2.15. `pg_stat_checkpointer` #

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

Таблица 27.25. Представление pg_stat_checkpointer

Тип столбца Описание
`num_timed` `bigint` Количество запланированных из-за тайм-аута контрольных точек. Обратите внимание, что при бездействии сервера с момента последней контрольной точки, они могут пропускаться, и это значение учитывает как пройденные, так и пропущенные контрольные точки
`num_requested` `bigint` Количество запрошенных контрольных точек, которые уже были выполнены
`restartpoints_timed` `bigint` Количество запланированных точек перезапуска из-за тайм-аута или после неудачной попытки выполнить перезапуск
`restartpoints_req` `bigint` Количество запрошенных точек перезапуска
`restartpoints_done` `bigint` Количество точек перезапуска, которые уже были выполнены
`write_time` `double precision` Общее время, которое было затрачено на этап обработки контрольных точек и точек перезапуска, на котором файлы записываются на диск, в миллисекундах
`sync_time` `double precision` Общее время, которое было затрачено на этап обработки контрольных точек и точек перезапуска, на котором файлы синхронизируются с диском, в миллисекундах
`buffers_written` `bigint` Количество буферов, записанных при выполнении контрольных точек и точек перезапуска
`stats_reset` `timestamp with time zone` Последнее время сброса этих статистических данных

Тип столбца

Описание

num_timed bigint

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

num_requested bigint

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

restartpoints_timed bigint

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

restartpoints_req bigint

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

restartpoints_done bigint

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

write_time double precision

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

sync_time double precision

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

buffers_written bigint

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

stats_reset timestamp with time zone

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

27.2.16. `pg_stat_wal` #

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

Таблица 27.26. Представление 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` можно найти в Разделе 28.5.
`wal_sync` `bigint` Сколько раз файлы WAL сбрасывались на диск функцией `issue_xlog_fsync` (если параметр fsync включён (`on`) и wal_sync_method имеет значение `fdatasync`, `fsync` или `fsync_writethrough`, в противном случае будет выведен ноль). Более подробную информацию о внутренней функции WAL `issue_xlog_fsync` можно найти в Разделе 28.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` Последнее время сброса этих статистических данных

Тип столбца

Описание

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 можно найти в Разделе 28.5.

wal_sync bigint

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

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

27.2.17. `pg_stat_database` #

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

Таблица 27.27. Представление 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` Последнее время сброса этих статистических данных

Тип столбца

Описание

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

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

27.2.18. `pg_stat_database_conflicts` #

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

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

Тип столбца Описание
`datid` `oid` OID базы данных
`datname` `name` Имя базы данных
`confl_tablespace` `bigint` Количество запросов в этой базе данных, отменённых из-за того, что табличные пространства были удалены
`confl_lock` `bigint` Количество запросов в этой базе данных, отменённых по истечении времени ожидания блокировки
`confl_snapshot` `bigint` Количество запросов в этой базе данных, отменённых из-за устаревших снимков данных
`confl_bufferpin` `bigint` Количество запросов в этой базе данных, отменённых из-за прикреплённых страниц буфера
`confl_deadlock` `bigint` Количество запросов в этой базе данных, отменённых из-за взаимных блокировок
`confl_active_logicalslot` `bigint` Количество использований логических слотов в этой базе данных, отменённых из-за старых снимков или слишком низкого значения wal_level на ведущем сервере

Тип столбца

Описание

datid oid

OID базы данных

datname name

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

confl_tablespace bigint

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

confl_lock bigint

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

confl_snapshot bigint

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

confl_bufferpin bigint

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

confl_deadlock bigint

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

confl_active_logicalslot bigint

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

27.2.19. `pg_stat_all_tables` #

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

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

Тип столбца Описание
`relid` `oid` OID таблицы
`schemaname` `name` Имя схемы, в которой расположена эта таблица
`relname` `name` Имя таблицы
`seq_scan` `bigint` Количество последовательных чтений, произведённых в этой таблице
`last_seq_scan` `timestamp with time zone` Время последнего последовательного сканирования этой таблицы, исходя из времени последней остановки транзакции
`seq_tup_read` `bigint` Количество «живых» строк, прочитанных при последовательных чтениях
`idx_scan` `bigint` Количество сканирований по индексу, произведённых в этой таблице
`last_idx_scan` `timestamp with time zone` Время последнего последовательного сканирования индекса этой таблицы, исходя из времени последней остановки транзакции
`idx_tup_fetch` `bigint` Количество «живых» строк, отобранных при сканированиях по индексу
`n_tup_ins` `bigint` Общее количество вставленных строк
`n_tup_upd` `bigint` Общее количество изменённых строк. (Включая изменения строк, учитываемые в `n_tup_hot_upd` и `n_tup_newpage_upd`, а также остальные изменения, не относящиеся к HOT.)
`n_tup_del` `bigint` Общее количество удалённых строк
`n_tup_hot_upd` `bigint` Количество строк, изменённых по схеме HOT. Для таких изменений не требуются последующие версии в индексах.
`n_tup_newpage_upd` `bigint` Количество изменённых строк с переходом новой версии строки на новую страницу кучи, оставляющих после себя исходную версию с полем `t_ctid`, которое указывает на другую страницу кучи. Это всегда изменения, не относящиеся к 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` Сколько раз сбор статистики для этой таблицы был выполнен фоновым процессом автоочистки

Тип столбца

Описание

relid oid

OID таблицы

schemaname name

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

relname name

Имя таблицы

seq_scan bigint

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

last_seq_scan timestamp with time zone

Время последнего последовательного сканирования этой таблицы, исходя из времени последней остановки транзакции

seq_tup_read bigint

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

idx_scan bigint

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

last_idx_scan timestamp with time zone

Время последнего последовательного сканирования индекса этой таблицы, исходя из времени последней остановки транзакции

idx_tup_fetch bigint

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

n_tup_ins bigint

Общее количество вставленных строк

n_tup_upd bigint

Общее количество изменённых строк. (Включая изменения строк, учитываемые в n_tup_hot_upd и n_tup_newpage_upd, а также остальные изменения, не относящиеся к HOT.)

n_tup_del bigint

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

n_tup_hot_upd bigint

Количество строк, изменённых по схеме HOT. Для таких изменений не требуются последующие версии в индексах.

n_tup_newpage_upd bigint

Количество изменённых строк с переходом новой версии строки на новую страницу кучи, оставляющих после себя исходную версию с полем t_ctid, которое указывает на другую страницу кучи. Это всегда изменения, не относящиеся к 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

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

27.2.20. `pg_stat_all_indexes` #

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

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

Тип столбца Описание
`relid` `oid` OID таблицы для индекса
`indexrelid` `oid` OID индекса
`schemaname` `name` Имя схемы, в которой расположен индекс
`relname` `name` Имя таблицы для индекса
`indexrelname` `name` Имя индекса
`idx_scan` `bigint` Количество произведённых сканирований по этому индексу
`last_idx_scan` `timestamp with time zone` Время последнего сканирования этого индекса, исходя из времени последней остановки транзакции
`idx_tup_read` `bigint` Количество элементов индекса, возвращённых при сканированиях по этому индексу
`idx_tup_fetch` `bigint` Количество живых строк таблицы, отобранных при простых сканированиях по этому индексу

Тип столбца

Описание

relid oid

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

indexrelid oid

OID индекса

schemaname name

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

relname name

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

indexrelname name

Имя индекса

idx_scan bigint

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

last_idx_scan timestamp with time zone

Время последнего сканирования этого индекса, исходя из времени последней остановки транзакции

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 — количество «живых» строк, выбранных из таблицы. Различие будет меньше, если «мёртвые» или ещё не зафиксированные строки будут извлекаться с использованием индекса или если для получения строк таблицы будет использоваться сканирование только по индексу.

Примечание

Запросы, которые используют определённые конструкции SQL для поиска строк, соответствующих любому значению из списка или массива нескольких скалярных значений (см. Раздел 9.25), выполняют несколько «примитивных» сканирований индекса (до одного сканирования на скалярное значение) во время выполнения запроса. Каждое внутреннее примитивное сканирование индекса увеличивает значение pg_stat_all_indexes.idx_scan, поэтому возможно, что количество сканирований индекса значительно превысит общее количество сканирований узла-исполнителя.

27.2.21. `pg_statio_all_tables` #

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

Таблица 27.31. Представление 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 (если есть) для этой таблицы

Тип столбца

Описание

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 (если есть) для этой таблицы

27.2.22. `pg_statio_all_indexes` #

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

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

Тип столбца Описание
`relid` `oid` OID таблицы для индекса
`indexrelid` `oid` OID индекса
`schemaname` `name` Имя схемы, в которой расположен индекс
`relname` `name` Имя таблицы для индекса
`indexrelname` `name` Имя индекса
`idx_blks_read` `bigint` Количество дисковых блоков, прочитанных из этого индекса
`idx_blks_hit` `bigint` Число попаданий в буфер для этого индекса

Тип столбца

Описание

relid oid

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

indexrelid oid

OID индекса

schemaname name

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

relname name

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

indexrelname name

Имя индекса

idx_blks_read bigint

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

idx_blks_hit bigint

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

27.2.23. `pg_statio_all_sequences` #

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

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

Тип столбца Описание
`relid` `oid` OID последовательности
`schemaname` `name` Имя схемы, в которой расположена эта последовательность
`relname` `name` Имя последовательности
`blks_read` `bigint` Количество дисковых блоков, прочитанных из этой последовательности
`blks_hit` `bigint` Число попаданий в буфер в этой последовательности

Тип столбца

Описание

relid oid

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

schemaname name

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

relname name

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

blks_read bigint

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

blks_hit bigint

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

27.2.24. `pg_stat_user_functions` #

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

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

Тип столбца Описание
`funcid` `oid` OID функции
`schemaname` `name` Имя схемы, в которой расположена функция
`funcname` `name` Имя функции
`calls` `bigint` Сколько раз вызывалась функция
`total_time` `double precision` Общее время, потраченное на выполнение этой функции и всех других функций, вызванных ею, в миллисекундах
`self_time` `double precision` Общее время, потраченное на выполнение самой функции, без учёта других функций, которые были ею вызваны, в миллисекундах

Тип столбца

Описание

funcid oid

OID функции

schemaname name

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

funcname name

Имя функции

calls bigint

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

total_time double precision

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

self_time double precision

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

27.2.25. `pg_stat_slru` #

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

Для каждого SLRU-кеша, входящего в состав ядра сервера, существует параметр конфигурации, который управляет его размером, с добавленным суффиксом _buffers.

Таблица 27.35. Представление 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` Последнее время сброса этих статистических данных

Тип столбца

Описание

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

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

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

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

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

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

Функция Описание
`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` Возвращает метку времени текущего снимка статистики или NULL, если снимок статистики не был получен. Снимок создаётся при первом обращении к накопительной статистике в транзакции, если для параметра `stats_fetch_consistency` задано значение `snapshot`.
`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` ( [ `target` `text` `DEFAULT` `NULL` ] ) → `void` Сбрасывает некоторые счётчики статистики кластера до нуля, в зависимости от аргумента. Аргумент `target` может принимать следующие значения: `archiver`: Сбросить все счётчики, показанные в представлении `pg_stat_archiver`. `bgwriter`: Сбросить все счётчики, показанные в представлении `pg_stat_bgwriter`. `checkpointer`: Сбросить все счётчики, показанные в представлении `pg_stat_checkpointer`. `io`: Сбросить все счётчики, показанные в представлении `pg_stat_io`. `recovery_prefetch`: Сбросить все счётчики, показанные в представлении `pg_stat_recovery_prefetch`. `slru`: Сбросить все счётчики, показанные в представлении `pg_stat_slru`. `wal`: Сбросить все счётчики, показанные в представлении `pg_stat_wal`. `NULL` или не указан: сбрасываются все счётчики вышеуказанных представлений. По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.
`pg_stat_reset_single_table_counters` ( `oid` ) → `void` Обнуляет статистику по отдельной таблице или индексу в текущей базе данных, а также общую статистику для всех баз данных в кластере. По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.
`pg_stat_reset_single_function_counters` ( `oid` ) → `void` Обнуляет статистику для отдельной функции в текущей базе данных. По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.
`pg_stat_reset_slru` ( [ `target` `text` `DEFAULT` `NULL` ] ) → `void` Обнуляет статистику для отдельного SLRU-кеша или для всех SLRU-кешей в кластере. Если аргумент `target` равен `NULL` или не указан, обнуляются все счётчики, показанные в представлении `pg_stat_slru`, для всех SLRU-кешей. Также в аргументе можно передать текстовое значение `commit_timestamp`, `multixact_member`, `multixact_offset`, `notify`, `serializable`, `subtransaction` или `transaction`, чтобы сбросить счётчики только для указанного кеша. Если в аргументе передаётся `other` (на самом деле это может быть любая нераспознанная строка), обнулены будут все счётчики для всех кешей, кроме перечисленных поимённо выше. По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.
`pg_stat_reset_replication_slot` ( `text` ) → `void` Сбрасывает статистику указанного в аргументе слота репликации. Если в аргументе передаётся `NULL`, сбрасывает статистику для всех слотов репликации. По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.
`pg_stat_reset_subscription_stats` ( `oid` ) → `void` Обнуляет статистику для отдельной подписки, отображаемую в представлении `pg_stat_subscription_stats`. Если в аргументе передаётся `NULL`, сбрасывается статистика для всех подписок. По умолчанию доступ к этой функции имеют только суперпользователи, но право на её выполнение (EXECUTE) можно дать и другим пользователям.

Функция

Описание

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

Возвращает метку времени текущего снимка статистики или NULL, если снимок статистики не был получен. Снимок создаётся при первом обращении к накопительной статистике в транзакции, если для параметра stats_fetch_consistency задано значение snapshot.

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 ( [ target text DEFAULT NULL ] ) → void

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

archiver: Сбросить все счётчики, показанные в представлении pg_stat_archiver.
bgwriter: Сбросить все счётчики, показанные в представлении pg_stat_bgwriter.
checkpointer: Сбросить все счётчики, показанные в представлении pg_stat_checkpointer.
io: Сбросить все счётчики, показанные в представлении pg_stat_io.
recovery_prefetch: Сбросить все счётчики, показанные в представлении pg_stat_recovery_prefetch.
slru: Сбросить все счётчики, показанные в представлении pg_stat_slru.
wal: Сбросить все счётчики, показанные в представлении pg_stat_wal.
NULL или не указан: сбрасываются все счётчики вышеуказанных представлений.

pg_stat_reset_single_table_counters ( oid ) → void

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

pg_stat_reset_single_function_counters ( oid ) → void

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

pg_stat_reset_slru ( [ target text DEFAULT NULL ] ) → void

Обнуляет статистику для отдельного SLRU-кеша или для всех SLRU-кешей в кластере. Если аргумент target равен NULL или не указан, обнуляются все счётчики, показанные в представлении pg_stat_slru, для всех SLRU-кешей. Также в аргументе можно передать текстовое значение commit_timestamp, multixact_member, multixact_offset, notify, serializable, subtransaction или transaction, чтобы сбросить счётчики только для указанного кеша. Если в аргументе передаётся other (на самом деле это может быть любая нераспознанная строка), обнулены будут все счётчики для всех кешей, кроме перечисленных поимённо выше.

pg_stat_reset_replication_slot ( text ) → void

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

pg_stat_reset_subscription_stats ( oid ) → void

Обнуляет статистику для отдельной подписки, отображаемую в представлении pg_stat_subscription_stats. Если в аргументе передаётся NULL, сбрасывается статистика для всех подписок.

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

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

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

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

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

Функция Описание
`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_idset` () → `setof integer` Выдаёт идентификаторы активных в настоящий момент серверных процессов.
`pg_stat_get_backend_pid` ( `integer` ) → `integer` Выдаёт идентификатор (PID) этого серверного процесса.
`pg_stat_get_backend_start` ( `integer` ) → `timestamp with time zone` Выдаёт время, когда был запущен данный процесс.
`pg_stat_get_backend_subxact` ( `integer` ) → `record` Возвращает запись с информацией о подтранзакциях обслуживающего процесса с указанным идентификатором. Возвращаемые поля: `subxact_count`, которое представляет собой количество подтранзакций в кеше подтранзакций обслуживающего процесса, и `subxact_overflow`, который указывает, переполнен кеш подтранзакций обслуживающего процесса или нет.
`pg_stat_get_backend_userid` ( `integer` ) → `oid` Выдаёт OID пользователя, подключённого к этому серверному процессу.
`pg_stat_get_backend_wait_event` ( `integer` ) → `text` Выдаёт имя ожидаемого события, если серверный процесс сейчас находится в состоянии ожидания, или NULL в противном случае. См. также Таблица 27.5 – Таблица 27.13.
`pg_stat_get_backend_wait_event_type` ( `integer` ) → `text` Выдаёт имя типа ожидаемого события, если серверный процесс сейчас находится в состоянии ожидания, или NULL в противном случае. За подробностями обратитесь к Таблице 27.4.
`pg_stat_get_backend_xact_start` ( `integer` ) → `timestamp with time zone` Выдаёт время начала текущей транзакции в данном процессе.

Функция

Описание

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_idset () → setof integer

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

pg_stat_get_backend_pid ( integer ) → integer

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

pg_stat_get_backend_start ( integer ) → timestamp with time zone

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

pg_stat_get_backend_subxact ( integer ) → record

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

pg_stat_get_backend_userid ( integer ) → oid

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

pg_stat_get_backend_wait_event ( integer ) → text

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

pg_stat_get_backend_wait_event_type ( integer ) → text

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

pg_stat_get_backend_xact_start ( integer ) → timestamp with time zone

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

Пред.	Наверх	След.
27.1. Стандартные инструменты Unix	Начало	27.3. Просмотр информации о блокировках

Вход в личный кабинет

Восстановление пароля

Подтверждение аккаунта

Изменение пароля

27.2. Система накопительной статистики #

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

27.2.2. Просмотр статистики #

27.2.3. pg_stat_activity #

Примечание

Примечание

27.2.4. pg_stat_replication #

Примечание

27.2.5. pg_stat_replication_slots #

27.2.6. pg_stat_wal_receiver #

27.2.7. pg_stat_recovery_prefetch #

27.2.8. pg_stat_subscription #

27.2.9. pg_stat_subscription_stats #

27.2.10. pg_stat_ssl #

27.2.11. pg_stat_gssapi #

27.2.12. pg_stat_archiver #

27.2.13. pg_stat_io #

Примечание

27.2.14. pg_stat_bgwriter #

27.2.15. pg_stat_checkpointer #

27.2.16. pg_stat_wal #

27.2.17. pg_stat_database #

27.2.18. pg_stat_database_conflicts #

27.2.19. pg_stat_all_tables #

27.2.20. pg_stat_all_indexes #

Примечание

Примечание

27.2.21. pg_statio_all_tables #

27.2.22. pg_statio_all_indexes #

27.2.23. pg_statio_all_sequences #

27.2.24. pg_stat_user_functions #

27.2.25. pg_stat_slru #

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

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

27.2.3. `pg_stat_activity` #

27.2.4. `pg_stat_replication` #

27.2.5. `pg_stat_replication_slots` #

27.2.6. `pg_stat_wal_receiver` #

27.2.7. `pg_stat_recovery_prefetch` #

27.2.8. `pg_stat_subscription` #

27.2.9. `pg_stat_subscription_stats` #

27.2.10. `pg_stat_ssl` #

27.2.11. `pg_stat_gssapi` #

27.2.12. `pg_stat_archiver` #

27.2.13. `pg_stat_io` #

27.2.14. `pg_stat_bgwriter` #

27.2.15. `pg_stat_checkpointer` #

27.2.16. `pg_stat_wal` #

27.2.17. `pg_stat_database` #

27.2.18. `pg_stat_database_conflicts` #

27.2.19. `pg_stat_all_tables` #

27.2.20. `pg_stat_all_indexes` #

27.2.21. `pg_statio_all_tables` #

27.2.22. `pg_statio_all_indexes` #

27.2.23. `pg_statio_all_sequences` #

27.2.24. `pg_stat_user_functions` #

27.2.25. `pg_stat_slru` #