Skip to content

Add native maintenance timing and visibility-map statistics #2104

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Alena0704 wants to merge 16 commits into
base: main
Choose a base branch
from
Draft

Add native maintenance timing and visibility-map statistics #2104

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
b251aef
Track per-relation cumulative time spent in [auto]vacuum and [auto]an…
michaelpq Jan 28, 2025
463bf6e
Add is_analyze parameter to vacuum_delay_point().
nathan-bossart Feb 11, 2025
1439570
Measure cost-based vacuum delay for progress reporting.
nathan-bossart Feb 11, 2025
4919bf9
Measure cost-based vacuum delay
nathan-bossart Feb 11, 2025
7fd7baf
Measure append-optimized vacuum active-phase time
Alena0704 Sep 20, 2026
0737b53
Accumulate vacuum timing for indexes and databases
Alena0704 Oct 1, 2026
ced04c7
Count vacuums that enter wraparound failsafe mode
Alena0704 Oct 1, 2026
489a764
Count vacuums interrupted by errors
Alena0704 Oct 1, 2026
2d59d69
Track table VM stability.
Alena0704 Mar 30, 2026
1e86b04
Report core vacuum timing for append-optimized tables
Alena0704 Oct 1, 2026
f7c350d
Document cost-based VACUUM delay timing
Alena0704 Oct 7, 2026
e6dd6a6
Add relallfrozen to pg_class
melanieplageman Mar 3, 2025
aa98a08
Report AO active-phase time to cumulative statistics
Alena0704 Oct 7, 2026
653679f
Expose maintenance timing and visibility-map statistics in catalogs
Alena0704 Oct 7, 2026
d8c19f5
Fetch both visibility-map counts in one segment query
Alena0704 Oct 9, 2026
3011f96
Test native VACUUM cluster timing without the extension
Alena0704 Oct 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions contrib/bloom/blvacuum.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ blbulkdelete(IndexVacuumInfo *info, IndexBulkDeleteResult *stats,
*itupPtr,
*itupEnd;

vacuum_delay_point();
vacuum_delay_point(false);

buffer = ReadBufferExtended(index, MAIN_FORKNUM, blkno,
RBM_NORMAL, info->strategy);
Expand Down Expand Up @@ -191,7 +191,7 @@ blvacuumcleanup(IndexVacuumInfo *info, IndexBulkDeleteResult *stats)
Buffer buffer;
Page page;

vacuum_delay_point();
vacuum_delay_point(false);

buffer = ReadBufferExtended(index, MAIN_FORKNUM, blkno,
RBM_NORMAL, info->strategy);
Expand Down
2 changes: 1 addition & 1 deletion contrib/file_fdw/file_fdw.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1197,7 +1197,7 @@ file_acquire_sample_rows(Relation onerel, int elevel,
for (;;)
{
/* Check for user-requested abort or sleep */
vacuum_delay_point();
vacuum_delay_point(true);

/* Fetch next row */
MemoryContextReset(tupcontext);
Expand Down
20 changes: 20 additions & 0 deletions doc/src/sgml/catalogs.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2061,6 +2061,26 @@ SCRAM-SHA-256$<replaceable>&lt;iteration count&gt;</replaceable>:<replaceable>&l
</para></entry>
</row>

<row>
<entry role="catalog_table_entry"><para role="column_definition">
<structfield>relallfrozen</structfield> <type>int4</type>
</para>
<para>
Number of pages that are marked all-frozen in the table's visibility
map. This is only an estimate and can be used along with
<structfield>relallvisible</structfield> for scheduling vacuums and
tuning <link linkend="runtime-config-vacuum-freezing">vacuum's freezing
behavior</link>.

It is updated by
<link linkend="sql-vacuum"><command>VACUUM</command></link>,
<link linkend="sql-analyze"><command>ANALYZE</command></link>,
and a few DDL commands such as
<link linkend="sql-createindex"><command>CREATE INDEX</command></link>.
</para></entry>
</row>


<row>
<entry role="catalog_table_entry"><para role="column_definition">
<structfield>reltoastrelid</structfield> <type>oid</type>
Expand Down
24 changes: 24 additions & 0 deletions doc/src/sgml/config.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8155,6 +8155,30 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
</listitem>
</varlistentry>

<varlistentry id="guc-track-cost-delay-timing" xreflabel="track_cost_delay_timing">
<term><varname>track_cost_delay_timing</varname> (<type>boolean</type>)
<indexterm>
<primary><varname>track_cost_delay_timing</varname> configuration parameter</primary>
</indexterm>
</term>
<listitem>
<para>
Enables timing of cost-based vacuum delay (see
<xref linkend="runtime-config-resource-vacuum-cost"/>). This parameter
is off by default, as it will repeatedly query the operating system for
the current time, which may cause significant overhead on some
platforms. You can use the <xref linkend="pgtesttiming"/> tool to
measure the overhead of timing on your system. Cost-based vacuum delay
timing information is displayed in
<link linkend="vacuum-progress-reporting"><structname>pg_stat_progress_vacuum</structname></link>
and
<link linkend="analyze-progress-reporting"><structname>pg_stat_progress_analyze</structname></link>.
Only superusers and users with the appropriate <literal>SET</literal>
privilege can change this setting.
</para>
</listitem>
</varlistentry>

<varlistentry id="guc-track-io-timing" xreflabel="track_io_timing">
<term><varname>track_io_timing</varname> (<type>boolean</type>)
<indexterm>
Expand Down
Loading
Loading