Skip to content

Commit b094063

Browse files
committed
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/[email protected]
1 parent 15c1a9d commit b094063

File tree

2 files changed

+33
-32
lines changed

2 files changed

+33
-32
lines changed

doc/src/sgml/config.sgml

+28-28
Original file line numberDiff line numberDiff line change
@@ -6812,6 +6812,34 @@ local0.* /var/log/postgresql
68126812
</listitem>
68136813
</varlistentry>
68146814

6815+
<varlistentry id="guc-log-autovacuum-min-duration" xreflabel="log_autovacuum_min_duration">
6816+
<term><varname>log_autovacuum_min_duration</varname> (<type>integer</type>)
6817+
<indexterm>
6818+
<primary><varname>log_autovacuum_min_duration</varname></primary>
6819+
<secondary>configuration parameter</secondary>
6820+
</indexterm>
6821+
</term>
6822+
<listitem>
6823+
<para>
6824+
Causes each action executed by autovacuum to be logged if it ran for at
6825+
least the specified amount of time. Setting this to zero logs
6826+
all autovacuum actions. <literal>-1</literal> (the default) disables
6827+
logging autovacuum actions.
6828+
If this value is specified without units, it is taken as milliseconds.
6829+
For example, if you set this to
6830+
<literal>250ms</literal> then all automatic vacuums and analyzes that run
6831+
250ms or longer will be logged. In addition, when this parameter is
6832+
set to any value other than <literal>-1</literal>, a message will be
6833+
logged if an autovacuum action is skipped due to a conflicting lock or a
6834+
concurrently dropped relation. Enabling this parameter can be helpful
6835+
in tracking autovacuum activity. This parameter can only be set in
6836+
the <filename>postgresql.conf</filename> file or on the server command line;
6837+
but the setting can be overridden for individual tables by
6838+
changing table storage parameters.
6839+
</para>
6840+
</listitem>
6841+
</varlistentry>
6842+
68156843
<varlistentry id="guc-log-checkpoints" xreflabel="log_checkpoints">
68166844
<term><varname>log_checkpoints</varname> (<type>boolean</type>)
68176845
<indexterm>
@@ -7827,34 +7855,6 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
78277855
</listitem>
78287856
</varlistentry>
78297857

7830-
<varlistentry id="guc-log-autovacuum-min-duration" xreflabel="log_autovacuum_min_duration">
7831-
<term><varname>log_autovacuum_min_duration</varname> (<type>integer</type>)
7832-
<indexterm>
7833-
<primary><varname>log_autovacuum_min_duration</varname></primary>
7834-
<secondary>configuration parameter</secondary>
7835-
</indexterm>
7836-
</term>
7837-
<listitem>
7838-
<para>
7839-
Causes each action executed by autovacuum to be logged if it ran for at
7840-
least the specified amount of time. Setting this to zero logs
7841-
all autovacuum actions. <literal>-1</literal> (the default) disables
7842-
logging autovacuum actions.
7843-
If this value is specified without units, it is taken as milliseconds.
7844-
For example, if you set this to
7845-
<literal>250ms</literal> then all automatic vacuums and analyzes that run
7846-
250ms or longer will be logged. In addition, when this parameter is
7847-
set to any value other than <literal>-1</literal>, a message will be
7848-
logged if an autovacuum action is skipped due to a conflicting lock or a
7849-
concurrently dropped relation. Enabling this parameter can be helpful
7850-
in tracking autovacuum activity. This parameter can only be set in
7851-
the <filename>postgresql.conf</filename> file or on the server command line;
7852-
but the setting can be overridden for individual tables by
7853-
changing table storage parameters.
7854-
</para>
7855-
</listitem>
7856-
</varlistentry>
7857-
78587858
<varlistentry id="guc-autovacuum-max-workers" xreflabel="autovacuum_max_workers">
78597859
<term><varname>autovacuum_max_workers</varname> (<type>integer</type>)
78607860
<indexterm>

src/backend/utils/misc/postgresql.conf.sample

+5-4
Original file line numberDiff line numberDiff line change
@@ -531,6 +531,11 @@
531531
#debug_print_rewritten = off
532532
#debug_print_plan = off
533533
#debug_pretty_print = on
534+
#log_autovacuum_min_duration = -1 # log autovacuum activity;
535+
# -1 disables, 0 logs all actions and
536+
# their durations, > 0 logs only
537+
# actions running at least this number
538+
# of milliseconds.
534539
#log_checkpoints = off
535540
#log_connections = off
536541
#log_disconnections = off
@@ -616,10 +621,6 @@
616621

617622
#autovacuum = on # Enable autovacuum subprocess? 'on'
618623
# requires track_counts to also be on.
619-
#log_autovacuum_min_duration = -1 # -1 disables, 0 logs all actions and
620-
# their durations, > 0 logs only
621-
# actions running at least this number
622-
# of milliseconds.
623624
#autovacuum_max_workers = 3 # max number of autovacuum subprocesses
624625
# (change requires restart)
625626
#autovacuum_naptime = 1min # time between autovacuum runs

0 commit comments

Comments
 (0)