Getting Started

Managing Errors and Retries

Component: ServiceInsight

When a message fails during processing, NServiceBus will automatically retry it. If a message continues to fail it will be forwarded to the error queue and become visible within ServiceInsight.

The views in ServiceInsight show information about message processing failure with the message. No manual correlation of log files or accessing of remote servers is necessary to research the reasons for an error.

Status in the message list

The status of an errant message is illustrated in the message window. A message can have one of the statuses below.

An error in the message window

Successful processed message: A message that was successfully processed. Requires message auditing to be enabled. Success icon

Message failed one time: A message that was moved to the error queue only one time. Single error icon

Message failed multiple times: A message that has been retried at least once using tools like ServiceInsight or ServicePulse, and for which retries weren't able to process the message successfully. Multiple errors icon

Retry requested for message: A failed message, for which a retry was requested from ServiceInsight or ServicePulse. If a message remains with this status, there is no further information about that message, neither failure nor audit for a successful processing. Once the message is re-processed, the status will change to resolved successfully, failed once, or failed multiple times. Retry icon

Resolved successfully: The message was successfully processed after failure(s). Retry icon

Clock drift

If the status icon has an exclamation sign overlay (⚠) is shown when the calculated critical time is negative usually caused by clock drift. Clock drift can be migitated by frequently syncing against the same shared time source via NTP.

The flow diagram

The flow diagram highlights errors in red and provides details with access to the stack trace.

Error in the flow diagram

The sequence diagram

The sequence diagram highlights handlers with errors in red.

Error in the sequence diagram

Retrying a failed message

Once the underlying cause for message processing failure has been resolved, the failed message can be retried from ServiceInsight. Find the message to be retried and click Retry Message.

Last modified