{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-retry-pattern",
  "id": "retry-pattern",
  "kind": "pattern",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-correctness-core",
    "json": "https://banes-lab.com/json/records/layer/correctness-core",
    "label": "Correctness Core",
    "markdown": "https://banes-lab.com/records/layer/correctness-core.md",
    "ref": "layer:correctness-core"
  },
  "name": "Retry Pattern",
  "ref": "architecture:retry-pattern",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-idempotency",
          "json": "https://banes-lab.com/json/records/architecture/idempotency",
          "label": "Idempotency",
          "markdown": "https://banes-lab.com/records/architecture/idempotency.md",
          "ref": "architecture:idempotency"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-timeout",
          "json": "https://banes-lab.com/json/records/lexicon/timeout",
          "label": "Timeout",
          "markdown": "https://banes-lab.com/records/lexicon/timeout.md",
          "ref": "lexicon:timeout"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-backoff",
          "json": "https://banes-lab.com/json/records/lexicon/backoff",
          "label": "Backoff",
          "markdown": "https://banes-lab.com/records/lexicon/backoff.md",
          "ref": "lexicon:backoff"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-fault-tolerance",
          "json": "https://banes-lab.com/json/records/architecture/fault-tolerance",
          "label": "Fault Tolerance",
          "markdown": "https://banes-lab.com/records/architecture/fault-tolerance.md",
          "ref": "architecture:fault-tolerance"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-transient-failure-recovery",
          "json": "https://banes-lab.com/json/records/lexicon/transient-failure-recovery",
          "label": "Transient Failure Recovery",
          "markdown": "https://banes-lab.com/records/lexicon/transient-failure-recovery.md",
          "ref": "lexicon:transient-failure-recovery"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-non-idempotent-operation",
          "json": "https://banes-lab.com/json/records/lexicon/non-idempotent-operation",
          "label": "Non-Idempotent Operation",
          "markdown": "https://banes-lab.com/records/lexicon/non-idempotent-operation.md",
          "ref": "lexicon:non-idempotent-operation"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-load-amplification",
          "json": "https://banes-lab.com/json/records/lexicon/load-amplification",
          "label": "Load Amplification",
          "markdown": "https://banes-lab.com/records/lexicon/load-amplification.md",
          "ref": "lexicon:load-amplification"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-load-amplification-retry-pattern",
          "json": "https://banes-lab.com/json/records/tension/load-amplification-retry-pattern",
          "label": "Retry Pattern / Load Amplification",
          "markdown": "https://banes-lab.com/records/tension/load-amplification-retry-pattern.md",
          "ref": "tension:load-amplification-retry-pattern"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-unbounded-retry",
          "json": "https://banes-lab.com/json/records/lexicon/unbounded-retry",
          "label": "Unbounded Retry",
          "markdown": "https://banes-lab.com/records/lexicon/unbounded-retry.md",
          "ref": "lexicon:unbounded-retry"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-retry-storm",
          "json": "https://banes-lab.com/json/records/architecture/retry-storm",
          "label": "Retry Storm",
          "markdown": "https://banes-lab.com/records/architecture/retry-storm.md",
          "ref": "architecture:retry-storm"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-backoff",
          "json": "https://banes-lab.com/json/records/lexicon/backoff",
          "label": "Backoff",
          "markdown": "https://banes-lab.com/records/lexicon/backoff.md",
          "ref": "lexicon:backoff"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-idempotency-key",
          "json": "https://banes-lab.com/json/records/lexicon/idempotency-key",
          "label": "Idempotency Key",
          "markdown": "https://banes-lab.com/records/lexicon/idempotency-key.md",
          "ref": "lexicon:idempotency-key"
        }
      ],
      "relation": "refactored-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-error-handling-resilience",
          "json": "https://banes-lab.com/json/records/architecture-category/error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/records/architecture-category/error-handling-resilience.md",
          "ref": "architecture-category:error-handling-resilience"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-eventual-consistency",
          "json": "https://banes-lab.com/json/records/architecture/eventual-consistency",
          "label": "Eventual Consistency",
          "markdown": "https://banes-lab.com/records/architecture/eventual-consistency.md",
          "ref": "architecture:eventual-consistency"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-resilience",
          "json": "https://banes-lab.com/json/records/architecture/resilience",
          "label": "Resilience",
          "markdown": "https://banes-lab.com/records/architecture/resilience.md",
          "ref": "architecture:resilience"
        }
      ],
      "relation": "refactors"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/pag/keywords#keyword-ontology",
          "json": "https://banes-lab.com/json/pag/keywords/keyword-ontology",
          "label": "Keywords",
          "markdown": "https://banes-lab.com/pag/keywords/keyword-ontology.md",
          "ref": "chapter:/pag/keywords#keyword-ontology"
        },
        {
          "href": "https://banes-lab.com/disciplined-methodology/verify#a-report-not-a-checkbox",
          "json": "https://banes-lab.com/json/disciplined-methodology/verify/a-report-not-a-checkbox",
          "label": "A report, not a checkbox",
          "markdown": "https://banes-lab.com/disciplined-methodology/verify/a-report-not-a-checkbox.md",
          "ref": "chapter:/disciplined-methodology/verify#a-report-not-a-checkbox"
        },
        {
          "href": "https://banes-lab.com/software-architecture/principles#computation-and-resource",
          "json": "https://banes-lab.com/json/software-architecture/principles/computation-and-resource",
          "label": "Computation and resource",
          "markdown": "https://banes-lab.com/software-architecture/principles/computation-and-resource.md",
          "ref": "chapter:/software-architecture/principles#computation-and-resource"
        },
        {
          "href": "https://banes-lab.com/software-architecture/scale#scale-follows-determinism",
          "json": "https://banes-lab.com/json/software-architecture/scale/scale-follows-determinism",
          "label": "Scale follows determinism",
          "markdown": "https://banes-lab.com/software-architecture/scale/scale-follows-determinism.md",
          "ref": "chapter:/software-architecture/scale#scale-follows-determinism"
        },
        {
          "href": "https://banes-lab.com/software-architecture/glossary#architectural-principles",
          "json": "https://banes-lab.com/json/software-architecture/glossary/architectural-principles",
          "label": "Architectural rules and principles",
          "markdown": "https://banes-lab.com/software-architecture/glossary/architectural-principles.md",
          "ref": "chapter:/software-architecture/glossary#architectural-principles"
        },
        {
          "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-error-handling-resilience",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-error-handling-resilience.md",
          "ref": "chapter:/ontology#architecture-category-error-handling-resilience"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-transactions-state-concurrency",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-transactions-state-concurrency",
          "label": "Transactions / State / Concurrency",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-transactions-state-concurrency.md",
          "ref": "chapter:/ontology#architecture-category-transactions-state-concurrency"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-error-handling-resilience",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-error-handling-resilience.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-error-handling-resilience"
        },
        {
          "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 repeats an idempotent call after a transient failure, a bounded number of times with backoff.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-timeout-pattern",
      "json": "https://banes-lab.com/json/records/architecture/timeout-pattern",
      "label": "Timeout Pattern",
      "markdown": "https://banes-lab.com/records/architecture/timeout-pattern.md",
      "ref": "architecture:timeout-pattern"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-fallback-pattern",
      "json": "https://banes-lab.com/json/records/architecture/fallback-pattern",
      "label": "Fallback Pattern",
      "markdown": "https://banes-lab.com/records/architecture/fallback-pattern.md",
      "ref": "architecture:fallback-pattern"
    }
  },
  "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": [
    "Retry"
  ],
  "exemplar": {
    "after": "await retry.withBackoff(\n  () => remoteFoo.save(foo),\n  { attempts: 3, retryIf: isTransientError, jitter: true },\n);",
    "before": "await remoteFoo.save(foo);",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "network",
    "IO",
    "message handling"
  ],
  "severity": "contextual"
}