From 71e65a1185b787909d76186ea7593d2ed3922dad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 11:18:16 +0100
Subject: [PATCH] [Messenger] Mention the WorkerMessageRetriedEvent

---
 messenger.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index e4d1179da8a..f0e2d742450 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -716,6 +716,15 @@ this is configurable for each transport:
             ],
         ]);
 
+.. tip::
+
+    Symfony triggers a :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
+    when a message is retried so you can run your own logic.
+
+    .. versionadded:: 5.2
+
+        The ``WorkerMessageRetriedEvent`` class was introduced in Symfony 5.2.
+
 Avoiding Retrying
 ~~~~~~~~~~~~~~~~~