diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index d83e99da49..48ffe87241 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -3051,10 +3051,7 @@ description | Waiting for a newly initialized WAL file to reach durable storage
num_timed bigint
- Number of scheduled checkpoints due to timeout.
- Note that checkpoints may be skipped if the server has been idle
- since the last one, and this value counts both completed and
- skipped checkpoints
+ Number of scheduled checkpoints due to timeout
@@ -3063,7 +3060,7 @@ description | Waiting for a newly initialized WAL file to reach durable storage
num_requested bigint
- Number of backend requested checkpoints
+ Number of requested checkpoints
@@ -3146,6 +3143,18 @@ description | Waiting for a newly initialized WAL file to reach durable storage
+
+ Checkpoints may be skipped if the server has been idle since the last one.
+ num_timed and
+ num_requested count both completed and skipped
+ checkpoints, while num_done tracks only
+ the completed ones. Similarly, restartpoints may be skipped
+ if the last replayed checkpoint record is already the last restartpoint.
+ restartpoints_timed and
+ restartpoints_req count both completed and
+ skipped restartpoints, while restartpoints_done
+ tracks only the completed ones.
+