From: Yuval Lifshitz Date: Wed, 14 Aug 2024 11:02:09 +0000 (+0000) Subject: doc/rgw/notification: persistent notification queue full behavior X-Git-Tag: v18.2.5~457^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=ce38b9cb97aaed3f1d47f58952b645526446060c;p=ceph.git doc/rgw/notification: persistent notification queue full behavior Fixes: https://tracker.ceph.com/issues/50610 Signed-off-by: Yuval Lifshitz (cherry picked from commit d12ba11741dc749bcce315bf467078595fa95b24) --- diff --git a/doc/radosgw/notifications.rst b/doc/radosgw/notifications.rst index c93f34b3fac54..98a567a8035f3 100644 --- a/doc/radosgw/notifications.rst +++ b/doc/radosgw/notifications.rst @@ -57,9 +57,15 @@ Asynchronous Notifications ~~~~~~~~~~~~~~~~~~~~~~~~~~ Notifications can be sent asynchronously. They are committed into persistent -storage and then asynchronously sent to the topic's configured endpoint. In -this case, the only latency added to the original operation is the latency +storage and then asynchronously sent to the topic's configured endpoint. +The notification will be committed to persistent storage only if the triggering +operation was successful. +In this case, the only latency added to the original operation is the latency added when the notification is committed to persistent storage. +If the endpoint of the topic to which the notification is sent is not available for a long +period of time, the persistent storage allocated for this topic will eventually fill up. +When this happens the triggering operations will fail with ``503 Service Unavailable``, +which tells the client that it may retry later. .. note:: If the notification fails with an error, cannot be delivered, or times out, it is retried until it is successfully acknowledged.