From 079aae330424f4cafe807915a608fecf33418aad Mon Sep 17 00:00:00 2001
From: alterego655 <824662526@qq.com>
Date: Thu, 22 Jan 2026 11:16:19 +0800
Subject: [PATCH v6 1/2] Doc: document all pg_stat_wal_receiver status values
List all possible status values for the pg_stat_wal_receiver view
using itemizedlist markup for better readability. The status values
were previously undocumented.
Note that the "stopped" state is normally not visible because the
view returns no row when the WAL receiver is not running, but it is
included for completeness.
---
doc/src/sgml/monitoring.sgml | 44 ++++++++++++++++++++++++++++++++++--
1 file changed, 42 insertions(+), 2 deletions(-)
diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index 817fd9f4ca7..e36d330fe4f 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -1737,8 +1737,48 @@ description | Waiting for a newly initialized WAL file to reach durable storage
status text
- Activity status of the WAL receiver process
-
+ Activity status of the WAL receiver process.
+ Possible values are:
+
+
+
+
+ stopped: WAL receiver process is not running.
+ This state is normally not visible because the view returns no row
+ when the WAL receiver is not running.
+
+
+
+
+ starting: WAL receiver process has been launched
+ but is not yet initialized.
+
+
+
+
+ streaming: WAL receiver is streaming WAL data.
+
+
+
+
+ waiting: WAL receiver has stopped streaming and
+ is waiting for new instructions from the startup process.
+
+
+
+
+ restarting: WAL receiver has been asked to
+ restart streaming.
+
+
+
+
+ stopping: WAL receiver has been requested to
+ stop.
+
+
+
+
--
2.51.0