pgsql: doc: Add more details about pg_stat_get_xact_blocks_{fetched,hit

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: doc: Add more details about pg_stat_get_xact_blocks_{fetched,hit
Date: 2023-04-04 23:00:45
Message-ID: E1pjpds-001OUN-DU@gemulon.postgresql.org
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-committers

doc: Add more details about pg_stat_get_xact_blocks_{fetched,hit}

The explanation describing the dependency to system read() calls for
these two functions has been removed in ddfc2d9. And after more
discussion about d69c404, we have concluded that adding more details
makes them easier to understand.

While on it, use the term "block read requests" (maybe found in cache)
rather than "buffers fetched" and "buffer hits".

Per discussion with Melanie Plageman, Kyotaro Horiguchi, Bertrand
Drouvot and myself.

Discussion: https://postgr.es/m/CAAKRu_ZmdiScT4q83OAbfmR5AH-L5zWya3SXjaxiJvhCob-e2A@mail.gmail.com
Backpatch-through: 11

Branch
------
REL_12_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/1372166bac300f9d394fbfde7b7ff0ecebfa7e48

Modified Files
--------------
doc/src/sgml/monitoring.sgml | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Andres Freund 2023-04-05 00:03:24 pgsql: sequences: Lock buffer before initializing page
Previous Message Jeff Davis 2023-04-04 22:44:35 pgsql: Fix MSVC warning introduced in ea1db8ae70.