Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit4533de3

Browse files
committed
Fix documentation for pg_stat_recovery_prefetch.
The table was in the wrong section and using an older type of link, asreported by Sirisha, and also using an older table layout, as I noticedwhile trying to figure out how and when it might have got out of sync.Defect in commit5dc0418.Author: sirisha chamarthi <sirichamarthi22@gmail.com>Author: Thomas Munro <thomas.munro@gmail.com>Discussion:https://postgr.es/m/CAKrAKeVk-LRHMdyT6x_p33eF6dCorM2jed5h_eHdRdv0reSYTA@mail.gmail.com
1 parentaeebb8b commit4533de3

File tree

1 file changed

+126
-67
lines changed

1 file changed

+126
-67
lines changed

‎doc/src/sgml/monitoring.sgml

Lines changed: 126 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -336,7 +336,8 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
336336
<row>
337337
<entry><structname>pg_stat_recovery_prefetch</structname><indexterm><primary>pg_stat_recovery_prefetch</primary></indexterm></entry>
338338
<entry>Only one row, showing statistics about blocks prefetched during recovery.
339-
See <xref linkend="pg-stat-recovery-prefetch-view"/> for details.
339+
See <link linkend="monitoring-pg-stat-recovery-prefetch">
340+
<structname>pg_stat_recovery_prefetch</structname></link> for details.
340341
</entry>
341342
</row>
342343

@@ -2977,89 +2978,147 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
29772978

29782979
</sect2>
29792980

2980-
<sect2 id="monitoring-pg-stat-subscription">
2981-
<title><structname>pg_stat_subscription</structname></title>
2981+
<sect2 id="monitoring-pg-stat-recovery-prefetch">
2982+
<title><structname>pg_stat_recovery_prefetch</structname></title>
29822983

29832984
<indexterm>
2984-
<primary>pg_stat_subscription</primary>
2985+
<primary>pg_stat_recovery_prefetch</primary>
29852986
</indexterm>
29862987

29872988
<para>
2988-
The <structname>pg_stat_subscription</structname> view will contain one
2989-
row per subscription for main worker (with null PID if the worker is
2990-
not running), and additional rows for workers handling the initial data
2991-
copy of the subscribed tables.
2989+
The <structname>pg_stat_recovery_prefetch</structname> view will contain
2990+
only one row. The columns <structfield>wal_distance</structfield>,
2991+
<structfield>block_distance</structfield> and
2992+
<structfield>io_depth</structfield> show current values, and the
2993+
other columns show cumulative counters that can be reset
2994+
with the <function>pg_stat_reset_shared</function> function.
29922995
</para>
29932996

29942997
<table id="pg-stat-recovery-prefetch-view" xreflabel="pg_stat_recovery_prefetch">
29952998
<title><structname>pg_stat_recovery_prefetch</structname> View</title>
2996-
<tgroup cols="3">
2999+
<tgroup cols="1">
29973000
<thead>
2998-
<row>
2999-
<entry>Column</entry>
3000-
<entry>Type</entry>
3001-
<entry>Description</entry>
3001+
<row>
3002+
<entry role="catalog_table_entry"><para role="column_definition">
3003+
Column Type
3004+
</para>
3005+
<para>
3006+
Description
3007+
</para></entry>
30023008
</row>
30033009
</thead>
30043010

3005-
<tbody>
3006-
<row>
3007-
<entry><structfield>prefetch</structfield></entry>
3008-
<entry><type>bigint</type></entry>
3009-
<entry>Number of blocks prefetched because they were not in the buffer pool</entry>
3010-
</row>
3011-
<row>
3012-
<entry><structfield>hit</structfield></entry>
3013-
<entry><type>bigint</type></entry>
3014-
<entry>Number of blocks not prefetched because they were already in the buffer pool</entry>
3015-
</row>
3016-
<row>
3017-
<entry><structfield>skip_init</structfield></entry>
3018-
<entry><type>bigint</type></entry>
3019-
<entry>Number of blocks not prefetched because they would be zero-initialized</entry>
3020-
</row>
3021-
<row>
3022-
<entry><structfield>skip_new</structfield></entry>
3023-
<entry><type>bigint</type></entry>
3024-
<entry>Number of blocks not prefetched because they didn't exist yet</entry>
3025-
</row>
3026-
<row>
3027-
<entry><structfield>skip_fpw</structfield></entry>
3028-
<entry><type>bigint</type></entry>
3029-
<entry>Number of blocks not prefetched because a full page image was included in the WAL</entry>
3030-
</row>
3031-
<row>
3032-
<entry><structfield>skip_rep</structfield></entry>
3033-
<entry><type>bigint</type></entry>
3034-
<entry>Number of blocks not prefetched because they were already recently prefetched</entry>
3035-
</row>
3036-
<row>
3037-
<entry><structfield>wal_distance</structfield></entry>
3038-
<entry><type>integer</type></entry>
3039-
<entry>How many bytes ahead the prefetcher is looking</entry>
3040-
</row>
3041-
<row>
3042-
<entry><structfield>block_distance</structfield></entry>
3043-
<entry><type>integer</type></entry>
3044-
<entry>How many blocks ahead the prefetcher is looking</entry>
3045-
</row>
3046-
<row>
3047-
<entry><structfield>io_depth</structfield></entry>
3048-
<entry><type>integer</type></entry>
3049-
<entry>How many prefetches have been initiated but are not yet known to have completed</entry>
3050-
</row>
3011+
<tbody>
3012+
<row>
3013+
<entry role="catalog_table_entry">
3014+
<para role="column_definition">
3015+
<structfield>prefetch</structfield> <type>bigint</type>
3016+
</para>
3017+
<para>
3018+
Number of blocks prefetched because they were not in the buffer pool
3019+
</para>
3020+
</entry>
3021+
</row>
3022+
3023+
<row>
3024+
<entry role="catalog_table_entry">
3025+
<para role="column_definition">
3026+
<structfield>hit</structfield> <type>bigint</type>
3027+
</para>
3028+
<para>
3029+
Number of blocks not prefetched because they were already in the buffer pool
3030+
</para>
3031+
</entry>
3032+
</row>
3033+
3034+
<row>
3035+
<entry role="catalog_table_entry">
3036+
<para role="column_definition">
3037+
<structfield>skip_init</structfield> <type>bigint</type>
3038+
</para>
3039+
<para>
3040+
Number of blocks not prefetched because they would be zero-initialized
3041+
</para>
3042+
</entry>
3043+
</row>
3044+
3045+
<row>
3046+
<entry role="catalog_table_entry">
3047+
<para role="column_definition">
3048+
<structfield>skip_new</structfield> <type>bigint</type>
3049+
</para>
3050+
<para>
3051+
Number of blocks not prefetched because they didn't exist yet
3052+
</para>
3053+
</entry>
3054+
</row>
3055+
3056+
<row>
3057+
<entry role="catalog_table_entry">
3058+
<para role="column_definition">
3059+
<structfield>skip_fpw</structfield> <type>bigint</type>
3060+
</para>
3061+
<para>
3062+
Number of blocks not prefetched because a full page image was included in the WAL
3063+
</para>
3064+
</entry>
3065+
</row>
3066+
3067+
<row>
3068+
<entry role="catalog_table_entry">
3069+
<para role="column_definition">
3070+
<structfield>skip_rep</structfield> <type>bigint</type>
3071+
</para>
3072+
<para>
3073+
Number of blocks not prefetched because they were already recently prefetched
3074+
</para>
3075+
</entry>
3076+
</row>
3077+
3078+
<row>
3079+
<entry role="catalog_table_entry">
3080+
<para role="column_definition">
3081+
<structfield>wal_distance</structfield> <type>int</type>
3082+
</para>
3083+
<para>
3084+
How many bytes ahead the prefetcher is looking
3085+
</para>
3086+
</entry>
3087+
</row>
3088+
3089+
<row>
3090+
<entry role="catalog_table_entry">
3091+
<para role="column_definition">
3092+
<structfield>block_distance</structfield> <type>int</type>
3093+
</para>
3094+
<para>
3095+
How many blocks ahead the prefetcher is looking
3096+
</para>
3097+
</entry>
3098+
</row>
3099+
3100+
<row>
3101+
<entry role="catalog_table_entry">
3102+
<para role="column_definition">
3103+
<structfield>io_depth</structfield> <type>int</type>
3104+
</para>
3105+
<para>
3106+
How many prefetches have been initiated but are not yet known to have completed
3107+
</para>
3108+
</entry>
3109+
</row>
30513110
</tbody>
30523111
</tgroup>
30533112
</table>
30543113

3055-
<para>
3056-
The <structname>pg_stat_recovery_prefetch</structname> view will contain
3057-
only one row. The columns <structfield>wal_distance</structfield>,
3058-
<structfield>block_distance</structfield> and
3059-
<structfield>io_depth</structfield> show current values, and the
3060-
other columns show cumulative counters that can be reset
3061-
with the <function>pg_stat_reset_shared</function> function.
3062-
</para>
3114+
</sect2>
3115+
3116+
<sect2 id="monitoring-pg-stat-subscription">
3117+
<title><structname>pg_stat_subscription</structname></title>
3118+
3119+
<indexterm>
3120+
<primary>pg_stat_subscription</primary>
3121+
</indexterm>
30633122

30643123
<table id="pg-stat-subscription" xreflabel="pg_stat_subscription">
30653124
<title><structname>pg_stat_subscription</structname> View</title>

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp