From f5d656b2ebda42b032284aa145d7320caf8b926d Mon Sep 17 00:00:00 2001 From: tanghy Date: Fri, 30 Apr 2021 11:55:38 +0900 Subject: [PATCH] pg_stat_prefetch_recovery_doc diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 886e626be8..78dc526960 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -340,7 +340,8 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser pg_stat_prefetch_recoverypg_stat_prefetch_recovery Only one row, showing statistics about blocks prefetched during recovery. - See for details. + See + pg_stat_prefetch_recovery for details. @@ -2935,90 +2936,137 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i - - <structname>pg_stat_subscription</structname> + + <structname>pg_stat_prefetch_recovery</structname> - pg_stat_subscription + pg_stat_prefetch_recovery - The pg_stat_subscription view will contain one - row per subscription for main worker (with null PID if the worker is - not running), and additional rows for workers handling the initial data - copy of the subscribed tables. + The pg_stat_prefetch_recovery view will contain only + one row. It is filled with nulls if recovery is not running or WAL + prefetching is not enabled. See + for more information. The counters in this view are reset whenever the + , + or + setting is changed and + the server configuration is reloaded. - +
<structname>pg_stat_prefetch_recovery</structname> View - + - - Column - Type - Description + + + Column Type + + + Description + - - - prefetch - bigint - Number of blocks prefetched because they were not in the buffer pool - - - skip_hit - bigint - Number of blocks not prefetched because they were already in the buffer pool - - - skip_new - bigint - Number of blocks not prefetched because they were new (usually relation extension) - - - skip_fpw - bigint - Number of blocks not prefetched because a full page image was included in the WAL and was set to off - - - skip_seq - bigint - Number of blocks not prefetched because of repeated access - - - distance - integer - How far ahead of recovery the prefetcher is currently reading, in bytes - - - queue_depth - integer - How many prefetches have been initiated but are not yet known to have completed - - - avg_distance - float4 - How far ahead of recovery the prefetcher is on average, while recovery is not idle - - - avg_queue_depth - float4 - Average number of prefetches in flight while recovery is not idle - + + + + prefetch bigint + + + Number of blocks prefetched because they were not in the buffer pool + + + + + + skip_hit bigint + + + Number of blocks not prefetched because they were already in the buffer pool + + + + + + skip_new bigint + + + Number of blocks not prefetched because they were new (usually relation extension) + + + + + + skip_fpw bigint + + + Number of blocks not prefetched because a full page image was included in the WAL and was set to off + + + + + + skip_seq bigint + + + Number of blocks not prefetched because of repeated access + + + + + + distance integer + + + How far ahead of recovery the prefetcher is currently reading, in bytes + + + + + + queue_depth integer + + + How many prefetches have been initiated but are not yet known to have completed + + + + + + avg_distance float4 + + + How far ahead of recovery the prefetcher is on average, while recovery is not idle + + + + + + avg_queue_depth float4 + + + Average number of prefetches in flight while recovery is not idle + +
+ + + + <structname>pg_stat_subscription</structname> + + + pg_stat_subscription + + - The pg_stat_prefetch_recovery view will contain only - one row. It is filled with nulls if recovery is not running or WAL - prefetching is not enabled. See - for more information. The counters in this view are reset whenever the - , - or - setting is changed and - the server configuration is reloaded. + The pg_stat_subscription view will contain one + row per subscription for main worker (with null PID if the worker is + not running), and additional rows for workers handling the initial data + copy of the subscribed tables. -- 2.30.0.windows.2