Dead-letter queue

Wat is een dead-letter queue?

Een dead-letter queue, vaak afgekort als DLQ, is een aparte wachtrij voor berichten die niet verwerkt konden worden. Het hoofdproces blijft doorwerken, terwijl het probleembericht apart wordt gezet voor onderzoek.

Stel dat een orderbericht uit je webshop naar het ERP moet. Eén bericht bevat een onbekende btw-code. Zonder DLQ kan de hele stroom vastlopen. Met een DLQ verhuist alleen dat bericht naar een zijspoor, en de rest gaat verder.

Een DLQ is dus een veiligheidsnet voor event- en queue-gebaseerde automatisering.

Wanneer komt een bericht in een DLQ terecht?

• Na te veel mislukte pogingen
  De retry policy heeft het maximum bereikt.

• Door ongeldige inhoud
  Het bericht mist verplichte velden of bevat waarden die het doelsysteem weigert.

• Door verlopen berichten
  Een bericht is te oud geworden om nog zinvol te verwerken.

• Door expliciete afwijzing
  De consumer beslist dat dit bericht niet verwerkt mag worden.

Hoe gebruik je een dead-letter queue?

Een DLQ is pas nuttig als iemand ze opvolgt. Je wil monitoring op het aantal berichten, alerts bij nieuwe fouten en een manier om berichten te bekijken, te corrigeren en opnieuw aan te bieden.

Een goed DLQ-proces bewaart ook de foutreden. "Verwerking mislukt" helpt weinig. "Onbekende productcode P-1234" stuurt iemand meteen naar het juiste masterdata-probleem.

Bij kritieke processen hoort een eigenaar. Als facturen in de DLQ belanden, moet finance of operations weten wie de queue bekijkt en binnen welke tijd.

DLQ versus gewone foutlog

Een foutlog vertelt dat er iets misliep. Een dead-letter queue bewaart het bericht zelf, zodat je het later opnieuw kan verwerken. Dat verschil is groot.

Bij een log moet je vaak de oorspronkelijke data opnieuw zoeken. Bij een DLQ ligt het mislukte bericht klaar, samen met context. Dat maakt herstel sneller en veiliger.

Waar moet je op letten bij een DLQ?

Laat ze niet vollopen
Een DLQ zonder opvolging wordt een kerkhof van vergeten fouten. Meet leeftijd en aantal berichten.

Herprobeer niet blind
Als de oorzaak niet opgelost is, stuur je hetzelfde bericht opnieuw naar dezelfde fout.

Bescherm gevoelige inhoud
Berichten kunnen persoonsgegevens of commerciële data bevatten. Geef niet zomaar iedereen toegang tot de DLQ.

FAQ over dead-letter queues

1. Moet elke queue een DLQ hebben?
Voor bedrijfskritieke verwerking wel. Voor tijdelijke of vrijblijvende events kan logging soms volstaan.

2. Is een DLQ een oplossing voor slechte data?
Nee. Ze maakt slechte data zichtbaar en beheersbaar, maar de bronfout moet nog altijd opgelost worden.