Any time a message is placed on a DLQ, you must take any necessary action to recover processing. Failure to do so will result in a loss of data and/or Vault functionality. While the severity of the functionality affected by a message placed on a DLQ will vary, note that even for less critical issues you must recover from DLQ messages within the timeframe of your Kafka retention period, which defaults to 7 days. Failure to do so will result in the message on the DLQ being permanently deleted, meaning recovery of the data / functionality may no longer be possible.

When a message is detected on a DLQ Kafka topic:

Consume the message from the DLQ, including the headers. As mentioned above the headers contain the error message. If displaying the Kafka message in full, take care to ensure viewers have the appropriate authorisation to view the data.

Consult the DLQ documentation for the affected component in the corresponding API section of the Documentation Hub. If the relevant documentation does not provide sufficient information for the DLQ in question, contact Thought Machine support, following the process in your Service Procedure Manual.

If the specific error is documented for the affected DLQ, follow the recovery instructions.

If the error is not documented for the affected DLQ, contact Thought Machine support, following the process in your Service Procedure Manual.