From: Fujii Masao Date: Wed, 18 Sep 2024 17:14:10 +0000 (+0900) Subject: docs: Improve the description of num_timed column in pg_stat_checkpointer. X-Git-Tag: REL_18_BETA1~1890 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=a7c39db5eb342dd491dacf39546486c6a539ea43;p=thirdparty%2Fpostgresql.git docs: Improve the description of num_timed column in pg_stat_checkpointer. The previous documentation stated that num_timed reflects the number of scheduled checkpoints performed. However, checkpoints may be skipped if the server has been idle, and num_timed counts both skipped and completed checkpoints. This commit clarifies the description to make it clear that the counter includes both skipped and completed checkpoints. Back-patch to v17 where pg_stat_checkpointer was added. Author: Fujii Masao Reviewed-by: Alexander Korotkov Discussion: https://postgr.es/m/9ea77f40-818d-4841-9dee-158ac8f6e690@oss.nttdata.com --- diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 933de6fe07f..a2fda4677d7 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -3051,7 +3051,10 @@ description | Waiting for a newly initialized WAL file to reach durable storage num_timed bigint - Number of scheduled checkpoints that have been performed + 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