{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-dead-letter-queue",
  "id": "dead-letter-queue",
  "kind": "pattern",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-execution-core",
    "json": "https://banes-lab.com/json/records/layer/execution-core",
    "label": "Execution Core",
    "markdown": "https://banes-lab.com/records/layer/execution-core.md",
    "ref": "layer:execution-core"
  },
  "name": "Dead-Letter Queue",
  "ref": "architecture:dead-letter-queue",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-message-queue",
          "json": "https://banes-lab.com/json/records/architecture/message-queue",
          "label": "Message Queue",
          "markdown": "https://banes-lab.com/records/architecture/message-queue.md",
          "ref": "architecture:message-queue"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-fault-isolation",
          "json": "https://banes-lab.com/json/records/lexicon/fault-isolation",
          "label": "Fault Isolation",
          "markdown": "https://banes-lab.com/records/lexicon/fault-isolation.md",
          "ref": "lexicon:fault-isolation"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-observability",
          "json": "https://banes-lab.com/json/records/architecture/observability",
          "label": "Observability",
          "markdown": "https://banes-lab.com/records/architecture/observability.md",
          "ref": "architecture:observability"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-poison-message-quarantine",
          "json": "https://banes-lab.com/json/records/lexicon/poison-message-quarantine",
          "label": "Poison-Message Quarantine",
          "markdown": "https://banes-lab.com/records/lexicon/poison-message-quarantine.md",
          "ref": "lexicon:poison-message-quarantine"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-reprocessing-after-fix",
          "json": "https://banes-lab.com/json/records/lexicon/reprocessing-after-fix",
          "label": "Reprocessing After Fix",
          "markdown": "https://banes-lab.com/records/lexicon/reprocessing-after-fix.md",
          "ref": "lexicon:reprocessing-after-fix"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-infinite-redelivery-loop",
          "json": "https://banes-lab.com/json/records/lexicon/infinite-redelivery-loop",
          "label": "Infinite Redelivery Loop",
          "markdown": "https://banes-lab.com/records/lexicon/infinite-redelivery-loop.md",
          "ref": "lexicon:infinite-redelivery-loop"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-operational-overhead",
          "json": "https://banes-lab.com/json/records/lexicon/operational-overhead",
          "label": "Operational Overhead",
          "markdown": "https://banes-lab.com/records/lexicon/operational-overhead.md",
          "ref": "lexicon:operational-overhead"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-dead-letter-queue-operational-overhead",
          "json": "https://banes-lab.com/json/records/tension/dead-letter-queue-operational-overhead",
          "label": "Dead-Letter Queue / Operational Overhead",
          "markdown": "https://banes-lab.com/records/tension/dead-letter-queue-operational-overhead.md",
          "ref": "tension:dead-letter-queue-operational-overhead"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-infinite-redelivery-loop",
          "json": "https://banes-lab.com/json/records/lexicon/infinite-redelivery-loop",
          "label": "Infinite Redelivery Loop",
          "markdown": "https://banes-lab.com/records/lexicon/infinite-redelivery-loop.md",
          "ref": "lexicon:infinite-redelivery-loop"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-contextual",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-contextual",
          "label": "contextual",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-contextual.md",
          "ref": "vocabulary:severity-contextual"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-event-messaging-asynchronous-architecture",
          "json": "https://banes-lab.com/json/records/architecture-category/event-messaging-asynchronous-architecture",
          "label": "Event / Messaging / Asynchronous Architecture",
          "markdown": "https://banes-lab.com/records/architecture-category/event-messaging-asynchronous-architecture.md",
          "ref": "architecture-category:event-messaging-asynchronous-architecture"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-event-messaging-asynchronous-architecture",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-event-messaging-asynchronous-architecture",
          "label": "Event / Messaging / Asynchronous Architecture",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-event-messaging-asynchronous-architecture.md",
          "ref": "chapter:/ontology#architecture-category-event-messaging-asynchronous-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-observability-auditability-traceability",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-observability-auditability-traceability",
          "label": "Observability / Auditability / Traceability",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-observability-auditability-traceability.md",
          "ref": "chapter:/ontology#architecture-category-observability-auditability-traceability"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-event-messaging-async",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-event-messaging-async",
          "label": "Event Messaging Async",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-event-messaging-async.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-event-messaging-async"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-quality-attributes",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-quality-attributes",
          "label": "Quality Attributes",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-quality-attributes.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-quality-attributes"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A design pattern that moves a message which keeps failing into a separate queue, where it can be inspected and reprocessed.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-idempotent-consumer",
      "json": "https://banes-lab.com/json/records/architecture/idempotent-consumer",
      "label": "Idempotent Consumer",
      "markdown": "https://banes-lab.com/records/architecture/idempotent-consumer.md",
      "ref": "architecture:idempotent-consumer"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-append-only-log",
      "json": "https://banes-lab.com/json/records/architecture/append-only-log",
      "label": "Append-Only Log",
      "markdown": "https://banes-lab.com/records/architecture/append-only-log.md",
      "ref": "architecture:append-only-log"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [
    "DLQ"
  ],
  "exemplar": {
    "after": "worker.consume(fooQueue, async message => {\n  try {\n    await processFoo(message);\n  } catch (error) {\n    if (message.attempts >= 5) return fooDeadLetterQueue.send(message, error);\n    throw error;\n  }\n});",
    "before": "worker.consume(fooQueue, async message => {\n  await processFoo(message);\n});",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "service",
    "messaging",
    "resilience"
  ],
  "severity": "contextual"
}