doc: Mention cost-based delays for total_[auto]{vacuum,analyze}_time

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 
Author: Bertrand Drouvot 
Discussion: https://postgr.es/m/CABUevEz9v1ZNToPyD98JnWDGZgG=SmPZKkSNzU9hXQ-nGTQF0g@mail.gmail.com

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
        total_vacuum_time double precision
       
       
-       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.)
       
      
 
@@ -4076,7 +4077,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
       
       
        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.)
       
      
 
@@ -4085,7 +4087,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
        total_analyze_time double precision
       
       
-       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.)
       
      
 
@@ -4095,7 +4098,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
       
       
        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.)