RabbitMQ
AMQP message broker with exchanges and queues; transient unless queues and messages are declared durable.
- Provider
- default
- Kind
- Queue
- Category
- Messaging
- Official docs
- https://www.rabbitmq.com/docs
| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| backoff | enum | none | fixed | exponential | exponential-jitter | no | — | inherited |
| deadLetterQueue | boolean | — | no | false | ▸ false |
| delivery | enum | at-most-once | at-least-once | exactly-once | yes | — | ▸ at-least-once |
| instances | integer | — | no | — | inherited |
| managed | boolean | — | no | false | inherited |
| maxAttempts | integer | — | no | — | inherited |
| ordering | enum | none | per-key | global | no | none | ▸ none |
| persistence | boolean | — | no | true | ▸ false |
| quorumQueue | boolean | — | no | false | inherited |
| replay | boolean | — | no | false | ▸ false |
| retentionDays | integer | — | no | — | inherited |
| role | enum | work | dlq | retry | offline-mailbox | frontier | no | work | inherited |
Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.
A queue that receives asynchronous traffic and has no dead-letter queue either drops poison messages or retries them forever. Neither outcome leaves anything for a human to investigate.
- — all of these hold:
- — the node's `deadLetterQueue` is false
- — the node has at least one asynchronous incoming edge
A retry queue is where poison messages end up. With no dead-letter queue they are retried forever or dropped in silence, and nobody ever looks at the failed payment.
- — all of these hold:
- — the node's `role` is "retry"
- — the node's `deadLetterQueue` is false
Retrying a transient failure at full speed turns one slow dependency into a retry storm. A retry queue backs off, preferably exponentially and with jitter.
- — all of these hold:
- — the node's `role` is "retry"
- — any of these hold:
- — the node's `backoff` has no value
- — the node's `backoff` is "none"
nodes:
- { id: "rabbitmq", component: "rabbitmq" }# yaml-language-server: $schema=../../schema/component.schema.json # RabbitMQ: AMQP broker. Queues are non-durable and messages transient unless declared otherwise, # so persistence defaults false. Dead-lettering requires an explicit x-dead-letter-exchange. schemaVersion: "1" type: "component" id: "rabbitmq" kind: "queue" provider: "default" docs: "https://www.rabbitmq.com/docs" defaults: delivery: "at-least-once" ordering: "none" deadLetterQueue: false replay: false persistence: false properties: quorumQueue: type: "boolean" default: false