x-death

Métadonnée AMQP 0-9-1 servant à détecter les poison messages.

Définition

Lorsqu'un message est dead-lettered, RabbitMQ enrichit son en-tête d'un tableau x-death contenant, par couple file/raison, un count, la reason (rejected, expired, maxlen), la file d'origine et un horodatage. Un consommateur lit ce compteur pour décider d'abandonner un message après N rejets — mécanisme de détection des poison messages côté courtier.

Origine

Défini par l'extension de dead-lettering de RabbitMQ au protocole AMQP 0-9-1 (documentation officielle « Dead Letter Exchanges »). Le concept équivalent côté JMS est l'en-tête JMSXDeliveryCount de la spécification Jakarta Messaging.

Exemple en contexte

x-death: [{count: 3, reason: 'rejected', queue: 'invoices', exchange: '', time: ...}]

Termes liés

• Poison message — ce que x-death aide à repérer.
• DLQ — file alimentée lors d'un dead-lettering.