Skip to content

Commit 2cf6546

Browse files
samimseihCommitfest Bot
authored andcommitted
Clarify when aborted rows are tracked for tuple related counters.
It is not obvious from the statistics collector documentation that tuple-related counters are incremented even when a transaction aborts, except for the n_mod_since_analyze counter, which only counts committed rows. Update the documentation to clarify this behavior.
1 parent 99139c4 commit 2cf6546

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

doc/src/sgml/monitoring.sgml

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -283,6 +283,10 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser
283283
stated above; instead they update continuously throughout the transaction.
284284
</para>
285285

286+
<para>
287+
An aborted transaction will also increment tuple-related counters, unless otherwise noted.
288+
</para>
289+
286290
<para>
287291
Some of the information in the dynamic statistics views shown in <xref
288292
linkend="monitoring-stats-dynamic-views-table"/> is security restricted.
@@ -3963,7 +3967,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
39633967
<structfield>n_live_tup</structfield> <type>bigint</type>
39643968
</para>
39653969
<para>
3966-
Estimated number of live rows
3970+
Estimated number of live rows (updated by committed transactions, or by
3971+
<command>VACUUM</command> and <command>VACUUM FULL</command>)
39673972
</para></entry>
39683973
</row>
39693974

@@ -3972,7 +3977,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
39723977
<structfield>n_dead_tup</structfield> <type>bigint</type>
39733978
</para>
39743979
<para>
3975-
Estimated number of dead rows
3980+
Estimated number of dead rows (updated either by committed or aborted
3981+
transactions, or by <command>VACUUM</command> and <command>VACUUM FULL</command>)
39763982
</para></entry>
39773983
</row>
39783984

@@ -3981,7 +3987,8 @@ description | Waiting for a newly initialized WAL file to reach durable storage
39813987
<structfield>n_mod_since_analyze</structfield> <type>bigint</type>
39823988
</para>
39833989
<para>
3984-
Estimated number of rows modified since this table was last analyzed
3990+
Estimated number of rows modified (by committed transactions) since this table
3991+
was last analyzed
39853992
</para></entry>
39863993
</row>
39873994

0 commit comments

Comments
 (0)