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


Примечание

Значения в столбцах 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 EventDescription
ArchiverMainWaiting in main loop of archiver process.
AutovacuumMainWaiting in main loop of autovacuum launcher process.
BgwriterHibernateWaiting in background writer process, hibernating.
BgwriterMainWaiting in main loop of background writer process.
CheckpointerMainWaiting in main loop of checkpointer process.
LogicalApplyMainWaiting in main loop of logical replication apply process.
LogicalLauncherMainWaiting in main loop of logical replication launcher process.
LogicalParallelApplyMainWaiting in main loop of logical replication parallel apply process.
RecoveryWalStreamWaiting in main loop of startup process for WAL to arrive, during streaming recovery.
ReplicationSlotsyncMainWaiting in main loop of slot sync worker.
ReplicationSlotsyncShutdownWaiting for slot sync worker to shut down.
SysloggerMainWaiting in main loop of syslogger process.
WalReceiverMainWaiting in main loop of WAL receiver process.
WalSenderMainWaiting in main loop of WAL sender process.
WalSummarizerWalWaiting in WAL summarizer for more WAL to be generated.
WalWriterMainWaiting in main loop of WAL writer process.

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

BufferPin Wait EventDescription
BufferPinWaiting to acquire an exclusive pin on a buffer.

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

Client Wait EventDescription
ClientReadWaiting to read data from the client.
ClientWriteWaiting to write data to the client.
GssOpenServerWaiting to read data from the client while establishing a GSSAPI session.
LibpqwalreceiverConnectWaiting in WAL receiver to establish connection to remote server.
LibpqwalreceiverReceiveWaiting in WAL receiver to receive data from remote server.
SslOpenServerWaiting for SSL while attempting connection.
WaitForStandbyConfirmationWaiting for WAL to be received and flushed by the physical standby.
WalSenderWaitForWalWaiting for WAL to be flushed in WAL sender process.
WalSenderWriteDataWaiting for any activity when processing replies from WAL receiver in WAL sender process.

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

Extension Wait EventDescription
ExtensionWaiting in an extension.

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

IO Wait EventDescription
BasebackupReadWaiting for base backup to read from a file.
BasebackupSyncWaiting for data written by a base backup to reach durable storage.
BasebackupWriteWaiting for base backup to write to a file.
BuffileReadWaiting for a read from a buffered file.
BuffileTruncateWaiting for a buffered file to be truncated.
BuffileWriteWaiting for a write to a buffered file.
ControlFileReadWaiting for a read from the pg_control file.
ControlFileSyncWaiting for the pg_control file to reach durable storage.
ControlFileSyncUpdateWaiting for an update to the pg_control file to reach durable storage.
ControlFileWriteWaiting for a write to the pg_control file.
ControlFileWriteUpdateWaiting for a write to update the pg_control file.
CopyFileReadWaiting for a read during a file copy operation.
CopyFileWriteWaiting for a write during a file copy operation.
DataFileExtendWaiting for a relation data file to be extended.
DataFileFlushWaiting for a relation data file to reach durable storage.
DataFileImmediateSyncWaiting for an immediate synchronization of a relation data file to durable storage.
DataFilePrefetchWaiting for an asynchronous prefetch from a relation data file.
DataFileReadWaiting for a read from a relation data file.
DataFileSyncWaiting for changes to a relation data file to reach durable storage.
DataFileTruncateWaiting for a relation data file to be truncated.
DataFileWriteWaiting for a write to a relation data file.
DsmAllocateWaiting for a dynamic shared memory segment to be allocated.
DsmFillZeroWriteWaiting to fill a dynamic shared memory backing file with zeroes.
LockFileAddtodatadirReadWaiting for a read while adding a line to the data directory lock file.
LockFileAddtodatadirSyncWaiting for data to reach durable storage while adding a line to the data directory lock file.
LockFileAddtodatadirWriteWaiting for a write while adding a line to the data directory lock file.
LockFileCreateReadWaiting to read while creating the data directory lock file.
LockFileCreateSyncWaiting for data to reach durable storage while creating the data directory lock file.
LockFileCreateWriteWaiting for a write while creating the data directory lock file.
LockFileRecheckdatadirReadWaiting for a read during recheck of the data directory lock file.
LogicalRewriteCheckpointSyncWaiting for logical rewrite mappings to reach durable storage during a checkpoint.
LogicalRewriteMappingSyncWaiting for mapping data to reach durable storage during a logical rewrite.
LogicalRewriteMappingWriteWaiting for a write of mapping data during a logical rewrite.
LogicalRewriteSyncWaiting for logical rewrite mappings to reach durable storage.
LogicalRewriteTruncateWaiting for truncate of mapping data during a logical rewrite.
LogicalRewriteWriteWaiting for a write of logical rewrite mappings.
RelationMapReadWaiting for a read of the relation map file.
RelationMapReplaceWaiting for durable replacement of a relation map file.
RelationMapWriteWaiting for a write to the relation map file.
ReorderBufferReadWaiting for a read during reorder buffer management.
ReorderBufferWriteWaiting for a write during reorder buffer management.
ReorderLogicalMappingReadWaiting for a read of a logical mapping during reorder buffer management.
ReplicationSlotReadWaiting for a read from a replication slot control file.
ReplicationSlotRestoreSyncWaiting for a replication slot control file to reach durable storage while restoring it to memory.
ReplicationSlotSyncWaiting for a replication slot control file to reach durable storage.
ReplicationSlotWriteWaiting for a write to a replication slot control file.
SlruFlushSyncWaiting for SLRU data to reach durable storage during a checkpoint or database shutdown.
SlruReadWaiting for a read of an SLRU page.
SlruSyncWaiting for SLRU data to reach durable storage following a page write.
SlruWriteWaiting for a write of an SLRU page.
SnapbuildReadWaiting for a read of a serialized historical catalog snapshot.
SnapbuildSyncWaiting for a serialized historical catalog snapshot to reach durable storage.
SnapbuildWriteWaiting for a write of a serialized historical catalog snapshot.
TimelineHistoryFileSyncWaiting for a timeline history file received via streaming replication to reach durable storage.
TimelineHistoryFileWriteWaiting for a write of a timeline history file received via streaming replication.
TimelineHistoryReadWaiting for a read of a timeline history file.
TimelineHistorySyncWaiting for a newly created timeline history file to reach durable storage.
TimelineHistoryWriteWaiting for a write of a newly created timeline history file.
TwophaseFileReadWaiting for a read of a two phase state file.
TwophaseFileSyncWaiting for a two phase state file to reach durable storage.
TwophaseFileWriteWaiting for a write of a two phase state file.
VersionFileSyncWaiting for the version file to reach durable storage while creating a database.
VersionFileWriteWaiting for the version file to be written while creating a database.
WalsenderTimelineHistoryReadWaiting for a read from a timeline history file during a walsender timeline command.
WalBootstrapSyncWaiting for WAL to reach durable storage during bootstrapping.
WalBootstrapWriteWaiting for a write of a WAL page during bootstrapping.
WalCopyReadWaiting for a read when creating a new WAL segment by copying an existing one.
WalCopySyncWaiting for a new WAL segment created by copying an existing one to reach durable storage.
WalCopyWriteWaiting for a write when creating a new WAL segment by copying an existing one.
WalInitSyncWaiting for a newly initialized WAL file to reach durable storage.
WalInitWriteWaiting for a write while initializing a new WAL file.
WalReadWaiting for a read from a WAL file.
WalSummaryReadWaiting for a read from a WAL summary file.
WalSummaryWriteWaiting for a write to a WAL summary file.
WalSyncWaiting for a WAL file to reach durable storage.
WalSyncMethodAssignWaiting for data to reach durable storage while assigning a new WAL sync method.
WalWriteWaiting for a write to a WAL file.

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

IPC Wait EventDescription
AppendReadyWaiting for subplan nodes of an Append plan node to be ready.
ArchiveCleanupCommandWaiting for archive_cleanup_command to complete.
ArchiveCommandWaiting for archive_command to complete.
BackendTerminationWaiting for the termination of another backend.
BackupWaitWalArchiveWaiting for WAL files required for a backup to be successfully archived.
BgworkerShutdownWaiting for background worker to shut down.
BgworkerStartupWaiting for background worker to start up.
BtreePageWaiting for the page number needed to continue a parallel B-tree scan to become available.
BufferIoWaiting for buffer I/O to complete.
CheckpointDelayCompleteWaiting for a backend that blocks a checkpoint from completing.
CheckpointDelayStartWaiting for a backend that blocks a checkpoint from starting.
CheckpointDoneWaiting for a checkpoint to complete.
CheckpointStartWaiting for a checkpoint to start.
ExecuteGatherWaiting for activity from a child process while executing a Gather plan node.
HashBatchAllocateWaiting for an elected Parallel Hash participant to allocate a hash table.
HashBatchElectWaiting to elect a Parallel Hash participant to allocate a hash table.
HashBatchLoadWaiting for other Parallel Hash participants to finish loading a hash table.
HashBuildAllocateWaiting for an elected Parallel Hash participant to allocate the initial hash table.
HashBuildElectWaiting to elect a Parallel Hash participant to allocate the initial hash table.
HashBuildHashInnerWaiting for other Parallel Hash participants to finish hashing the inner relation.
HashBuildHashOuterWaiting for other Parallel Hash participants to finish partitioning the outer relation.
HashGrowBatchesDecideWaiting to elect a Parallel Hash participant to decide on future batch growth.
HashGrowBatchesElectWaiting to elect a Parallel Hash participant to allocate more batches.
HashGrowBatchesFinishWaiting for an elected Parallel Hash participant to decide on future batch growth.
HashGrowBatchesReallocateWaiting for an elected Parallel Hash participant to allocate more batches.
HashGrowBatchesRepartitionWaiting for other Parallel Hash participants to finish repartitioning.
HashGrowBucketsElectWaiting to elect a Parallel Hash participant to allocate more buckets.
HashGrowBucketsReallocateWaiting for an elected Parallel Hash participant to finish allocating more buckets.
HashGrowBucketsReinsertWaiting for other Parallel Hash participants to finish inserting tuples into new buckets.
LogicalApplySendDataWaiting for a logical replication leader apply process to send data to a parallel apply process.
LogicalParallelApplyStateChangeWaiting for a logical replication parallel apply process to change state.
LogicalSyncDataWaiting for a logical replication remote server to send data for initial table synchronization.
LogicalSyncStateChangeWaiting for a logical replication remote server to change state.
MessageQueueInternalWaiting for another process to be attached to a shared message queue.
MessageQueuePutMessageWaiting to write a protocol message to a shared message queue.
MessageQueueReceiveWaiting to receive bytes from a shared message queue.
MessageQueueSendWaiting to send bytes to a shared message queue.
MultixactCreationWaiting for a multixact creation to complete.
ParallelBitmapScanWaiting for parallel bitmap scan to become initialized.
ParallelCreateIndexScanWaiting for parallel CREATE INDEX workers to finish heap scan.
ParallelFinishWaiting for parallel workers to finish computing.
ProcarrayGroupUpdateWaiting for the group leader to clear the transaction ID at transaction end.
ProcSignalBarrierWaiting for a barrier event to be processed by all backends.
PromoteWaiting for standby promotion.
RecoveryConflictSnapshotWaiting for recovery conflict resolution for a vacuum cleanup.
RecoveryConflictTablespaceWaiting for recovery conflict resolution for dropping a tablespace.
RecoveryEndCommandWaiting for recovery_end_command to complete.
RecoveryPauseWaiting for recovery to be resumed.
ReplicationOriginDropWaiting for a replication origin to become inactive so it can be dropped.
ReplicationSlotDropWaiting for a replication slot to become inactive so it can be dropped.
RestoreCommandWaiting for restore_command to complete.
SafeSnapshotWaiting to obtain a valid snapshot for a READ ONLY DEFERRABLE transaction.
SyncRepWaiting for confirmation from a remote server during synchronous replication.
WalReceiverExitWaiting for the WAL receiver to exit.
WalReceiverWaitStartWaiting for startup process to send initial data for streaming replication.
WalSummaryReadyWaiting for a new WAL summary to be generated.
XactGroupUpdateWaiting for the group leader to update transaction status at transaction end.

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

Lock Wait EventDescription
advisoryWaiting to acquire an advisory user lock.
applytransactionWaiting to acquire a lock on a remote transaction being applied by a logical replication subscriber.
extendWaiting to extend a relation.
frozenidWaiting to update pg_database.datfrozenxid and pg_database.datminmxid.
objectWaiting to acquire a lock on a non-relation database object.
pageWaiting to acquire a lock on a page of a relation.
relationWaiting to acquire a lock on a relation.
spectokenWaiting to acquire a speculative insertion lock.
transactionidWaiting for a transaction to finish.
tupleWaiting to acquire a lock on a tuple.
userlockWaiting to acquire a user lock.
virtualxidWaiting to acquire a virtual transaction ID lock; see Раздел 66.1.

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

LWLock Wait EventDescription
AddinShmemInitWaiting to manage an extension's space allocation in shared memory.
AutoFileWaiting to update the postgresql.auto.conf file.
AutovacuumWaiting to read or update the current state of autovacuum workers.
AutovacuumScheduleWaiting to ensure that a table selected for autovacuum still needs vacuuming.
BackgroundWorkerWaiting to read or update background worker state.
BtreeVacuumWaiting to read or update vacuum-related information for a B-tree index.
BufferContentWaiting to access a data page in memory.
BufferMappingWaiting to associate a data block with a buffer in the buffer pool.
CheckpointerCommWaiting to manage fsync requests.
CommitTsWaiting to read or update the last value set for a transaction commit timestamp.
CommitTsBufferWaiting for I/O on a commit timestamp SLRU buffer.
CommitTsSLRUWaiting to access the commit timestamp SLRU cache.
ControlFileWaiting to read or update the pg_control file or create a new WAL file.
DSMRegistryWaiting to read or update the dynamic shared memory registry.
DSMRegistryDSAWaiting to access dynamic shared memory registry's dynamic shared memory allocator.
DSMRegistryHashWaiting to access dynamic shared memory registry's shared hash table.
DynamicSharedMemoryControlWaiting to read or update dynamic shared memory allocation information.
InjectionPointWaiting to read or update information related to injection points.
LockFastPathWaiting to read or update a process' fast-path lock information.
LockManagerWaiting to read or update information about «heavyweight» locks.
LogicalRepLauncherDSAWaiting to access logical replication launcher's dynamic shared memory allocator.
LogicalRepLauncherHashWaiting to access logical replication launcher's shared hash table.
LogicalRepWorkerWaiting to read or update the state of logical replication workers.
MultiXactGenWaiting to read or update shared multixact state.
MultiXactMemberBufferWaiting for I/O on a multixact member SLRU buffer.
MultiXactMemberSLRUWaiting to access the multixact member SLRU cache.
MultiXactOffsetBufferWaiting for I/O on a multixact offset SLRU buffer.
MultiXactOffsetSLRUWaiting to access the multixact offset SLRU cache.
MultiXactTruncationWaiting to read or truncate multixact information.
NotifyBufferWaiting for I/O on a NOTIFY message SLRU buffer.
NotifyQueueWaiting to read or update NOTIFY messages.
NotifyQueueTailWaiting to update limit on NOTIFY message storage.
NotifySLRUWaiting to access the NOTIFY message SLRU cache.
OidGenWaiting to allocate a new OID.
ParallelAppendWaiting to choose the next subplan during Parallel Append plan execution.
ParallelHashJoinWaiting to synchronize workers during Parallel Hash Join plan execution.
ParallelQueryDSAWaiting for parallel query dynamic shared memory allocation.
ParallelVacuumDSAWaiting for parallel vacuum dynamic shared memory allocation.
PerSessionDSAWaiting for parallel query dynamic shared memory allocation.
PerSessionRecordTypeWaiting to access a parallel query's information about composite types.
PerSessionRecordTypmodWaiting to access a parallel query's information about type modifiers that identify anonymous record types.
PerXactPredicateListWaiting to access the list of predicate locks held by the current serializable transaction during a parallel query.
PgStatsDataWaiting for shared memory stats data access.
PgStatsDSAWaiting for stats dynamic shared memory allocator access.
PgStatsHashWaiting for stats shared memory hash table access.
PredicateLockManagerWaiting to access predicate lock information used by serializable transactions.
ProcArrayWaiting to access the shared per-process data structures (typically, to get a snapshot or report a session's transaction ID).
RelationMappingWaiting to read or update a pg_filenode.map file (used to track the filenode assignments of certain system catalogs).
RelCacheInitWaiting to read or update a pg_internal.init relation cache initialization file.
ReplicationOriginWaiting to create, drop or use a replication origin.
ReplicationOriginStateWaiting to read or update the progress of one replication origin.
ReplicationSlotAllocationWaiting to allocate or free a replication slot.
ReplicationSlotControlWaiting to read or update replication slot state.
ReplicationSlotIOWaiting for I/O on a replication slot.
SerialBufferWaiting for I/O on a serializable transaction conflict SLRU buffer.
SerialControlWaiting to read or update shared pg_serial state.
SerializableFinishedListWaiting to access the list of finished serializable transactions.
SerializablePredicateListWaiting to access the list of predicate locks held by serializable transactions.
SerializableXactHashWaiting to read or update information about serializable transactions.
SerialSLRUWaiting to access the serializable transaction conflict SLRU cache.
SharedTidBitmapWaiting to access a shared TID bitmap during a parallel bitmap index scan.
SharedTupleStoreWaiting to access a shared tuple store during parallel query.
ShmemIndexWaiting to find or allocate space in shared memory.
SInvalReadWaiting to retrieve messages from the shared catalog invalidation queue.
SInvalWriteWaiting to add a message to the shared catalog invalidation queue.
SubtransBufferWaiting for I/O on a sub-transaction SLRU buffer.
SubtransSLRUWaiting to access the sub-transaction SLRU cache.
SyncRepWaiting to read or update information about the state of synchronous replication.
SyncScanWaiting to select the starting location of a synchronized table scan.
TablespaceCreateWaiting to create or drop a tablespace.
TwoPhaseStateWaiting to read or update the state of prepared transactions.
WaitEventCustomWaiting to read or update custom wait events information.
WALBufMappingWaiting to replace a page in WAL buffers.
WALInsertWaiting to insert WAL data into a memory buffer.
WALSummarizerWaiting to read or update WAL summarization state.
WALWriteWaiting for WAL buffers to be written to disk.
WrapLimitsVacuumWaiting to update limits on transaction id and multixact consumption.
XactBufferWaiting for I/O on a transaction status SLRU buffer.
XactSLRUWaiting to access the transaction status SLRU cache.
XactTruncationWaiting to execute pg_xact_status or update the oldest transaction ID available to it.
XidGenWaiting to allocate a new transaction ID.

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

Timeout Wait EventDescription
BaseBackupThrottleWaiting during base backup when throttling activity.
CheckpointWriteDelayWaiting between writes while performing a checkpoint.
PgSleepWaiting due to a call to pg_sleep or a sibling function.
RecoveryApplyDelayWaiting to apply WAL during recovery because of a delay setting.
RecoveryRetrieveRetryIntervalWaiting during recovery when WAL data is not available from any source (pg_wal, archive or stream).
RegisterSyncRequestWaiting while sending synchronization requests to the checkpointer, because the request queue is full.
SpinDelayWaiting while acquiring a contended spinlock.
VacuumDelayWaiting in a cost-based vacuum delay point.
VacuumTruncateWaiting to acquire an exclusive lock to truncate off any empty pages at the end of a table vacuumed.
WalSummarizerErrorWaiting 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

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


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

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


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


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

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


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 для параллельных рабочих процессов применения изменений


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

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


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.


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.


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

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


Обычно файлы 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

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


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

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


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

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


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

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


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

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


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 на ведущем сервере


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

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


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

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


Индексы могут использоваться при простом сканировании по индексу, при сканировании «битовой карты» индекса и в работе оптимизатора. Результаты сканирования битовых карт разных индексов могут объединяться логическим умножением или сложением, поэтому когда применяются битовые карты, сложно связать выборки отдельных строк с определёнными индексами. Поэтому при сканировании битовых карт увеличиваются счётчики 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 (если есть) для этой таблицы


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

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


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

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


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

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


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

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


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_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

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