A message is added to the Dead Letter Queue

Summary

When Anthology Finance & HCM is integrated with an external system, an alert email is sent from the Azure Monitor that has the following alert description:

A message is added to the Dead Letter Queue (DLQ). Use the ‘Service Bus Explorer’ tool to identify and resolve the error.

Cause

This alert is sent when a new message is added to the Dead Letter Queue (DLQ).

Resolution

Use the Service Bus Explorer tool to view the dead letter queues. Service Bus Explorer is an open source tool to manage the Azure Service Bus. For more information, refer to Service Bus Explore on GitHub and Using Service Bus Explorer.

Resolve the issue using the following steps:

• Connect to the Azure Service Bus namespace
• View the Dead Letter Queue and resolve the issue

Connect to the Azure Service Bus namespace

1. Open the Service Bus Explorer tool.

2. Select File > Connect.

   The Connect to a Service Bus Namespace dialog box is displayed.

   

3. In the Service Bus Namespace field, select Enter connection string.

4. In the Connection String field, specify the connection string generated for the Service Bus Namespace on the Azure portal. To obtain the connection string for the Service Bus Namespace, perform the following steps:

   1. In the Azure Portal, navigate to the Resource group under which the service bus namespace is created and select the service bus namespace name.

   2. On the service bus namespace page, in the left pane, select Settings > Shared access policies, and select the RootManageSharedAccessKey policy.

      

   3. On the SAS Policy: RootManageSharedAccessKey page, if the keys are not already generated, select the Manage check box to generate the keys and connection strings.

      

   4. Copy the value from the Primary Connection String field.

5. In the Enter the key for the Service Bus namespace dialog, select OK.

   The Service Bus Namespace is connected, and the queues within the namespace are listed.

   

View the Dead Letter Queue and resolve the issue

1. In the Service Bus Explorer, connect to the service bus namespace for which the alert is triggered.

   

2. Select a queue and select the Deadletter button.

3. In the Retrieve messages from deadletter queue dialog, select Ok.

   

   The deadletter messages are displayed on the Deadletter tab.

   

4. Double-click a dead letter message to view the Repair and Resubmit Message dialog.

   

   The dead letter message is removed from the list in the Deadletter tab.

5. In the Repair and Resubmit Message dialog, perform the following steps:

   1. In the Message text field, make the required corrections to the message.

   2. Select the Remove message from DLQ check box.

   3. Select Submit.

   4. In the Select a target Queue or topic dialog, select Ok.