Skip to content

Publish unacked messages to Dead Letter Exchange

This sample demonstrates how WSO2 Micro Integrator can ensure guaranteed delivery of messages by using the Dead Letter Exchange (DLX) of RabbitMQ.

As shown below, a proxy service in the Micro Integrator consumes messages from the RabbitMQ broker and sends it to the endpoint. If the message delivery fails, the Micro Integrator will route the message to the dead letter exchange of RabbitMQ.

Synapse configurations

See the instructions on how to build and run this example.

<?xml version="1.0" encoding="UTF-8"?>
<proxy xmlns=""
      <log level="custom">
          <property expression="$body" name="Message Received"/>
      <call blocking="true">
            <http uri-template="http://localhost:8280/orders"/>
      <log level="custom">
          <property name="Status" value="The message process successfully"/>
      <log level="custom">
          <property name="Status" value="Could not process the message"/>
      <property name="SET_ROLLBACK_ONLY" scope="axis2" value="true"/>
   <parameter name="rabbitmq.queue.autodeclare">false</parameter>
   <parameter name="">orders-exchange</parameter>
   <parameter name="">false</parameter>
   <parameter name="">orders</parameter>
   <parameter name="rabbitmq.connection.factory">AMQPConnectionFactory</parameter>

Build and run

  1. Make sure you have a RabbitMQ broker instance running.
  2. Create an exchange with the name orders-exchange.
  3. Create another exchange orders-error-exchange with a queue bound to it (orders-error).
  4. Create queue orders (bound by orders-exchange with routing key orders ) and configure a dead letter exchange for it (orders-error-exchange).
  5. Set up WSO2 Integration Studio.
  6. Create an integration project with an ESB Configs module and an Composite Exporter.
  7. Create the proxy service with the configurations given above.
  8. Enable the RabbitMQ sender and receiver in the Micro-Integrator from the deployment.toml. Refer the configuring RabbitMQ documentation for more information.
  9. Deploy the artifacts in your Micro Integrator.
  10. Make the http://localhost:8280/orders endpoint unavailable temporarily.
  11. Publish a message to the orders queue.
  12. You will see that the failed message has been moved to the dead-letter-exchange.