aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2022-10-17 15:07:03 -0400
committerBruce Momjian <bruce@momjian.us>2022-10-17 15:07:03 -0400
commit4d070469c19f85043293789c570dbe8fb41ab1bb (patch)
treebde28ff1bc5415cc96fce8a4d92e1f093db41eea
parent8272749e8ca1dbbcb5f8cf5632ec26a573ac3111 (diff)
downloadpostgresql-4d070469c19f85043293789c570dbe8fb41ab1bb.tar.gz
postgresql-4d070469c19f85043293789c570dbe8fb41ab1bb.zip
doc: warn pg_stat_reset() can cause vacuum/analyze problems
The fix is to run ANALYZE. Discussion: https://postgr.es/m/YzRr+ys98UzVQJvK@momjian.us, https://postgr.es/m/flat/CAKJS1f8DTbCHf9gedU0He6ARsd58E6qOhEHM1caomqj_r9MOiQ%40mail.gmail.com, https://postgr.es/m/CAKJS1f80o98hcfSk8j%3DfdN09S7Sjz%2BvuzhEwbyQqvHJb_sZw0g%40mail.gmail.com Backpatch-through: 10
-rw-r--r--doc/src/sgml/monitoring.sgml11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index 60a2026b0b0..e5d622d5147 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -5510,6 +5510,17 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
</tgroup>
</table>
+ <warning>
+ <para>
+ Using <function>pg_stat_reset()</function> also resets counters that
+ autovacuum uses to determine when to trigger a vacuum or an analyze.
+ Resetting these counters can cause autovacuum to not perform necessary
+ work, which can cause problems such as table bloat or out-dated
+ table statistics. A database-wide <command>ANALYZE</command> is
+ recommended after the statistics have been reset.
+ </para>
+ </warning>
+
<para>
<function>pg_stat_get_activity</function>, the underlying function of
the <structname>pg_stat_activity</structname> view, returns a set of records