Move log_autovacuum_min_duration into its correct sections

This GUC has already been classified as LOGGING_WHAT, but its location
in postgresql.conf.sample and the documentation did not reflect that, so
fix those inconsistencies.

Author: Justin Pryzby
Discussion: https://postgr.es/m/20210404012546[email protected]

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 5bdb8650cc2839700044dc4610a1fa7b2be451fb..f749fe9ce7b465fd70f8f22cdbffefae869cc654 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -6812,6 +6812,34 @@ local0.*    /var/log/postgresql
       
      
 
+     
+      log_autovacuum_min_duration (integer)
+      
+       log_autovacuum_min_duration
+       configuration parameter
+      
+      
+      
+       
+        Causes each action executed by autovacuum to be logged if it ran for at
+        least the specified amount of time.  Setting this to zero logs
+        all autovacuum actions. -1 (the default) disables
+        logging autovacuum actions.
+        If this value is specified without units, it is taken as milliseconds.
+        For example, if you set this to
+        250ms then all automatic vacuums and analyzes that run
+        250ms or longer will be logged.  In addition, when this parameter is
+        set to any value other than -1, a message will be
+        logged if an autovacuum action is skipped due to a conflicting lock or a
+        concurrently dropped relation.  Enabling this parameter can be helpful
+        in tracking autovacuum activity.  This parameter can only be set in
+        the postgresql.conf file or on the server command line;
+        but the setting can be overridden for individual tables by
+        changing table storage parameters.
+       
+      
+     
+
      
       log_checkpoints (boolean)
       
@@ -7827,34 +7855,6 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
       
      
 
-     
-      log_autovacuum_min_duration (integer)
-      
-       log_autovacuum_min_duration
-       configuration parameter
-      
-      
-      
-       
-        Causes each action executed by autovacuum to be logged if it ran for at
-        least the specified amount of time.  Setting this to zero logs
-        all autovacuum actions. -1 (the default) disables
-        logging autovacuum actions.
-        If this value is specified without units, it is taken as milliseconds.
-        For example, if you set this to
-        250ms then all automatic vacuums and analyzes that run
-        250ms or longer will be logged.  In addition, when this parameter is
-        set to any value other than -1, a message will be
-        logged if an autovacuum action is skipped due to a conflicting lock or a
-        concurrently dropped relation.  Enabling this parameter can be helpful
-        in tracking autovacuum activity.  This parameter can only be set in
-        the postgresql.conf file or on the server command line;
-        but the setting can be overridden for individual tables by
-        changing table storage parameters.
-       
-      
-     
-
      
       autovacuum_max_workers (integer)
       

diff --git a/src/backend/utils/misc/postgresql.conf.sample b/src/backend/utils/misc/postgresql.conf.sample
index 9830cfe382e6ea2a0c9957e96660cb801daefb6e..2f6dd014a81ed52131eab25a3202a86fd7e2e5e3 100644 (file)
--- a/src/backend/utils/misc/postgresql.conf.sample
+++ b/src/backend/utils/misc/postgresql.conf.sample
@@ -531,6 +531,11 @@
 #debug_print_rewritten = off
 #debug_print_plan = off
 #debug_pretty_print = on
+#log_autovacuum_min_duration = -1  # log autovacuum activity;
+                   # -1 disables, 0 logs all actions and
+                   # their durations, > 0 logs only
+                   # actions running at least this number
+                   # of milliseconds.
 #log_checkpoints = off
 #log_connections = off
 #log_disconnections = off
@@ -616,10 +621,6 @@
 
 #autovacuum = on           # Enable autovacuum subprocess?  'on'
                    # requires track_counts to also be on.
-#log_autovacuum_min_duration = -1  # -1 disables, 0 logs all actions and
-                   # their durations, > 0 logs only
-                   # actions running at least this number
-                   # of milliseconds.
 #autovacuum_max_workers = 3        # max number of autovacuum subprocesses
                    # (change requires restart)
 #autovacuum_naptime = 1min     # time between autovacuum runs