From 5e4b0cb4bc22b0bdac1984e06d90391f5235ff6b Mon Sep 17 00:00:00 2001 From: Venkat Venkatakrishnan Date: Sat, 24 Jan 2026 21:30:52 -0500 Subject: [PATCH v1] docs: Add monitoring guidance to replication slot warning --- doc/src/sgml/high-availability.sgml | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) diff --git a/doc/src/sgml/high-availability.sgml b/doc/src/sgml/high-availability.sgml index c3f269e0364..3b3d732f76c 100644 --- a/doc/src/sgml/high-availability.sgml +++ b/doc/src/sgml/high-availability.sgml @@ -960,9 +960,32 @@ primary_conninfo = 'host=192.168.1.50 port=5432 user=foo password=foopass' Beware that replication slots can cause the server to retain so many WAL segments that they fill up the space allocated for - pg_wal. - can be used to limit the size - of WAL files retained by replication slots. + pg_wal. To prevent this condition, monitor + the following metrics in production environments: + + + + Disk space usage in the pg_wal directory + + + + + Replication lag using the pg_stat_replication + view, particularly the write_lag, + flush_lag, and + replay_lag columns + + + + + Slot status using the pg_replication_slots + view, checking the active and + restart_lsn values + + + + The parameter can be + used to limit the amount of WAL retained by replication slots. -- 2.39.3 (Apple Git-146)