Skip to content

Commit

Permalink
Queue settings docs completed
Browse files Browse the repository at this point in the history
  • Loading branch information
fedys committed Oct 26, 2023
1 parent 2359ba6 commit e7afbed
Show file tree
Hide file tree
Showing 3 changed files with 24 additions and 3 deletions.
Binary file added docs/configuration/images/queue-failures.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
27 changes: 24 additions & 3 deletions docs/configuration/settings.rst
Original file line number Diff line number Diff line change
Expand Up @@ -536,20 +536,41 @@ See `https://symfony.com/doc/5.4/messenger.html#amazon-sqs <https://symfony.com/
How to consume messages from the queue
======================================

TBD
To start consuming the messages from the queue, you need to run the following Symfony command.

.. code-block::
php bin/console messenger:consume email
If you don't use Kubernetes in your environment, use a process manager like Supervisor or systemd to keep your worker(s) running. More on this at
`https://symfony.com/doc/5.4/messenger.html#consuming-messages-running-the-worker <https://symfony.com/doc/5.4/messenger.html#consuming-messages-running-the-worker>`_

Advanced setting
================

Retry strategy
--------------

TBD
When the processing of a message fails, the message is sent back to the queue for another try. You can adjust this behaviour in this section.
See `https://symfony.com/doc/5.4/messenger.html#retries-failures <https://symfony.com/doc/5.4/messenger.html#retries-failures>`_ for more details.

The screenshot below shows the default values.

.. image:: images/queue-retry-strategy.png
:width: 600
:alt: Retry strategy defaults

Queue for failures
------------------

TBD
If a message fails all its retries, it's discarded by default. To avoid this happening, you can optionally configure a queue for failures.
For more details see the documentation on `https://symfony.com/doc/5.4/messenger.html#saving-retrying-failed-messages <https://symfony.com/doc/5.4/messenger.html#saving-retrying-failed-messages>`_.

The screenshot below shows the example of configuring the failure queue using the Doctrine transport.

.. image:: images/queue-failures.png
:width: 600
:alt: Example of failure configuration

Notification settings
*********************
Expand Down

0 comments on commit e7afbed

Please sign in to comment.