Merge pull request #64113 from zdover23/wip-doc-2025-06-23-backport-64103-to-squid

squid: doc/radosgw: improve "pubsub_push_pending" info

Reviewed-by: Yuval Lifshitz <ylifshit@ibm.com>
Reviewed-by: Anthony D'Atri <anthony.datri@gmail.com>

diff --cc doc/radosgw/notifications.rst
index c4c03bd3b47aaebfaf5e8a25360636cf2716d4fd,e0afd0db1b602496368b6af5c9fd5e3ffa1d1bca..c665d291a01d5cc5fb0ae3dee605679dbd892564
--- 1/doc/radosgw/notifications.rst
--- 2/doc/radosgw/notifications.rst
+++ b/doc/radosgw/notifications.rst
@@@ -125,12 -125,14 +125,15 @@@ Dump (in JSON format) all pending bucke
  Notification Performance Statistics
  -----------------------------------
  
 -- ``pubsub_event_triggered``: a running counter of events that have at least one topic associated with them
 -- ``pubsub_event_lost``: a running counter of events that had topics associated with them, but that were not pushed to any of the endpoints
 +- ``persistent_topic_size``: queue size in bytes. 
 +- ``persistent_topic_len``: shows how many notifications are currently waiting
 +  in the queue
  - ``pubsub_push_ok``: a running counter, for all notifications, of events successfully pushed to their endpoints
  - ``pubsub_push_fail``: a running counter, for all notifications, of events that failed to be pushed to their endpoints
- - ``pubsub_push_pending``: the gauge value of events pushed to an endpoint but not acked or nacked yet
+ - ``pubsub_push_pending``: the gauge value of events pushed to an endpoint but
+   not acked or nacked yet. This does not include the notifications waiting in
+   the persistent queue. Only the notifications that are in flight in both
+   persistent and non-persistent cases are counted.
  
  .. note::