projects / postgresql.git / commitdiff
summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 45e7e8c)
doc: Mention cost-based delays for total_[auto]{vacuum,analyze}_time
authorMichael Paquier <michael@paquier.xyz>
Wed, 30 Apr 2025 23:52:19 +0000 (08:52 +0900)
committerMichael Paquier <michael@paquier.xyz>
Wed, 30 Apr 2025 23:52:19 +0000 (08:52 +0900)
30a6ed0ce4b has added four attributes to pg_stat_all_tables to track the
cumulative time spent in [auto]vacuum and [auto]analyze.  It was not
mentioned that the vacuum cost-based delays are included in these
numbers, which could be confusing now that the delays are included in
the vacuum progress view (bb8dff9995f2).

This commit adds an extra note about this matter.

Reported-by: Magnus Hagander <magnus@hagander.net>
Author: Bertrand Drouvot <bertranddrouvot.pg@gmail.com>
Discussion: https://postgr.es/m/CABUevEz9v1ZNToPyD98JnWDGZgG=SmPZKkSNzU9hXQ-nGTQF0g@mail.gmail.com

doc/src/sgml/monitoring.sgml patch | blob | blame | history

diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index 02b89b01e38c231cc0c15dc45be3997747f5c50f..4265a22d4de3508638fcfe7b17e9cf7aab3fb027 100644 (file)
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -4066,7 +4066,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
        <structfield>total_vacuum_time</structfield> <type>double precision</type>
       </para>
       <para>
-       Total time this table has been manually vacuumed, in milliseconds
+       Total time this table has been manually vacuumed, in milliseconds.
+       (This includes the time spent sleeping due to cost-based delays.)
       </para></entry>
      </row>
 
@@ -4076,7 +4077,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
       </para>
       <para>
        Total time this table has been vacuumed by the autovacuum daemon,
-       in milliseconds
+       in milliseconds. (This includes the time spent sleeping due to
+       cost-based delays.)
       </para></entry>
      </row>
 
@@ -4085,7 +4087,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
        <structfield>total_analyze_time</structfield> <type>double precision</type>
       </para>
       <para>
-       Total time this table has been manually analyzed, in milliseconds
+       Total time this table has been manually analyzed, in milliseconds.
+       (This includes the time spent sleeping due to cost-based delays.)
       </para></entry>
      </row>
 
@@ -4095,7 +4098,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
       </para>
       <para>
        Total time this table has been analyzed by the autovacuum daemon,
-       in milliseconds
+       in milliseconds. (This includes the time spent sleeping due to
+       cost-based delays.)
       </para></entry>
      </row>
     </tbody>
This is the main PostgreSQL git repository.