doc: Add more details about pg_stat_get_xact_blocks_{fetched,hit}
authorMichael Paquier <michael@paquier.xyz>
Tue, 4 Apr 2023 22:59:49 +0000 (07:59 +0900)
committerMichael Paquier <michael@paquier.xyz>
Tue, 4 Apr 2023 22:59:49 +0000 (07:59 +0900)
commitb135a94db7743ffbceabf62c87be2b8f32a91465
treee0800c33f5f60396ee66853e82c5fffe47036bf4
parent6e369817367cc3a9d0db368383a4430733883142
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
doc/src/sgml/monitoring.sgml