diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index d46e6a3bbc0..33945297d7d 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -5319,8 +5319,11 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
bigint
- Returns the number of buffers fetched for table or index, in the current
- transaction.
+ Returns the number of block read requests for table or index, in the
+ current transaction. This number minus
+ pg_stat_get_xact_blocks_hit gives the number of
+ kernel read() calls; the number of actual
+ physical reads is usually lower due to kernel-level buffering.
@@ -5333,8 +5336,9 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
bigint
- Returns the number of buffer hits for table or index, in the current
- transaction.
+ Returns the number of block read requests for table or index, in the
+ current transaction, found in cache (not triggering kernel
+ read() calls).