Apache ActiveMQ
JMS broker (Classic or Artemis) with persistent journal and automatic dead-letter queue.
| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| backoff | enum | none | fixed | exponential | exponential-jitter | no | — | inherited |
| deadLetterQueue | boolean | — | no | false | ▸ true |
| 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 | ▸ true |
| replay | boolean | — | no | false | ▸ false |
| retentionDays | integer | — | no | — | inherited |
| role | enum | work | dlq | retry | offline-mailbox | frontier | no | work | inherited |
| variant | enum | classic | artemis | no | classic | 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: "activemq", component: "activemq" }# yaml-language-server: $schema=../../schema/component.schema.json # Apache ActiveMQ (Classic or Artemis): JMS broker, persistent store (KahaDB / journal) on by default, # expired and poison messages land in ActiveMQ.DLQ automatically. schemaVersion: "1" type: "component" id: "activemq" kind: "queue" provider: "default" docs: "https://activemq.apache.org/components/artemis/documentation/" defaults: delivery: "at-least-once" ordering: "none" deadLetterQueue: true replay: false persistence: true properties: variant: type: "enum" values: ["classic", "artemis"] default: "classic"