Distributor error handling

Component: Distributor
NuGet Package NServiceBus.Distributor.MSMQ (5.x)
Target NServiceBus Version: 5.x

NServiceBus provides error handling and has Immediate Retries and Delayed Retries.

When using the distributor the behavior of retries and the related message flow is different between major versions.

Immediate Retries

Immediate Retries are always performed on the worker.

Delayed Retries

The behavior of Delayed Retries is different between major versions.

Delayed Retries has two configurable items TimeIncrease and NumberOfRetries.

The message will be retried on any available worker. Message processing is not sticky to the worker.

The Delayed Retries policy NumberOfRetries setting its is applied on both the distributor and workers, and the TimeIncrease setting is applied on the distributor.

When an error occurs the Delayed Retries policy is invoked immediately by the fault manager. The message will not be forwarded to the retries queue which is was the previous behavior.

When the retry limit is reached the message is forwarded immediately to the error queue or else forwarded to the .retries queue and scheduled for retry. If the Delayed Retries policy output is that it needs to be retried then the message is forwarded to the .retries queue.

Best practice

Due to the behavioral differences between major versions it is advised to have the SecondLevelRetriesConfig exactly the same on both the distributor and the workers even though it could be that settings are ignored.

It is assumed that NumberOfRetries and TimeIncrease are the same on the distributor and the workers.

If settings are managed in XML configuration all changes in the distributor configuration need to be replicated to all nodes.

Samples

  • Scale out
    All samples for scaling out NServiceBus endpoints.

Related Articles


Last modified