diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index 65da082ed9..fd0ffbb1e0 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -5735,8 +5735,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.
@@ -5749,8 +5752,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).