From 3b1505d8f6dedb3d1feb5d56ea1ad74a93dcb8a5 Mon Sep 17 00:00:00 2001
From: Kirill Kotov <k.kotov@codd.tech>
Date: Sat, 15 Feb 2025 12:38:18 +0300
Subject: [PATCH] Messenger: Add consumer name documentation

---
 messenger.rst | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index e4f4abf60eb..c62436eb1e9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1768,7 +1768,21 @@ under the transport in ``messenger.yaml``:
     The Redis consumer group name
 
 ``consumer`` (default: ``consumer``)
-    Consumer name used in Redis
+    Consumer name used in Redis. Allows to set explicit consumer name identifier.
+    Recommended for environments with multiple workers to prevent duplicate message processing.
+    Typically set via environment variable:
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    redis:
+                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
+                        options:
+                            consumer: '%env(MESSENGER_CONSUMER_NAME)%'
+
 
 ``auto_setup`` (default: ``true``)
     Whether to create the Redis group automatically