{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-unobservable-failure",
  "id": "unobservable-failure",
  "kind": "anti-pattern",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-enforcement-core",
    "json": "https://banes-lab.com/json/records/layer/enforcement-core",
    "label": "Enforcement Core",
    "markdown": "https://banes-lab.com/records/layer/enforcement-core.md",
    "ref": "layer:enforcement-core"
  },
  "name": "Unobservable Failure",
  "ref": "architecture:unobservable-failure",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-error-boundaries",
          "json": "https://banes-lab.com/json/records/architecture/error-boundaries",
          "label": "Error Boundaries",
          "markdown": "https://banes-lab.com/records/architecture/error-boundaries.md",
          "ref": "architecture:error-boundaries"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-structured-log",
          "json": "https://banes-lab.com/json/records/lexicon/structured-log",
          "label": "Structured Log",
          "markdown": "https://banes-lab.com/records/lexicon/structured-log.md",
          "ref": "lexicon:structured-log"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-metrics",
          "json": "https://banes-lab.com/json/records/lexicon/metrics",
          "label": "Metrics",
          "markdown": "https://banes-lab.com/records/lexicon/metrics.md",
          "ref": "lexicon:metrics"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-alert-on-critical-failure",
          "json": "https://banes-lab.com/json/records/lexicon/alert-on-critical-failure",
          "label": "Alert on Critical Failure",
          "markdown": "https://banes-lab.com/records/lexicon/alert-on-critical-failure.md",
          "ref": "lexicon:alert-on-critical-failure"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-trace-span",
          "json": "https://banes-lab.com/json/records/lexicon/trace-span",
          "label": "Trace Span",
          "markdown": "https://banes-lab.com/records/lexicon/trace-span.md",
          "ref": "lexicon:trace-span"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-audit-logging",
          "json": "https://banes-lab.com/json/records/architecture/audit-logging",
          "label": "Audit Logging",
          "markdown": "https://banes-lab.com/records/architecture/audit-logging.md",
          "ref": "architecture:audit-logging"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-discouraged",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-discouraged",
          "label": "discouraged",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-discouraged.md",
          "ref": "vocabulary:severity-discouraged"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-anti-patterns",
          "json": "https://banes-lab.com/json/records/architecture-category/anti-patterns",
          "label": "Anti-patterns",
          "markdown": "https://banes-lab.com/records/architecture-category/anti-patterns.md",
          "ref": "architecture-category:anti-patterns"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#force-contract-compatibility",
          "json": "https://banes-lab.com/json/records/force/contract-compatibility",
          "label": "Contract compatibility",
          "markdown": "https://banes-lab.com/records/force/contract-compatibility.md",
          "ref": "force:contract-compatibility"
        }
      ],
      "relation": "force"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/anatomy/governance#file-governance-rules-eslint-no-swallowed-failure-eslint-rule-ts",
          "json": "https://banes-lab.com/json/source/governance/rules/eslint/no-swallowed-failure.eslint.rule.ts",
          "label": "rules/eslint/no-swallowed-failure.eslint.rule.ts",
          "markdown": "https://banes-lab.com/source/governance/rules/eslint/no-swallowed-failure.eslint.rule.ts.md",
          "ref": "anatomy:file-governance-rules-eslint-no-swallowed-failure-eslint-rule-ts"
        },
        {
          "href": "https://banes-lab.com/anatomy/governance#file-governance-rules-eslint-require-signal-guard-eslint-rule-ts",
          "json": "https://banes-lab.com/json/source/governance/rules/eslint/require-signal-guard.eslint.rule.ts",
          "label": "rules/eslint/require-signal-guard.eslint.rule.ts",
          "markdown": "https://banes-lab.com/source/governance/rules/eslint/require-signal-guard.eslint.rule.ts.md",
          "ref": "anatomy:file-governance-rules-eslint-require-signal-guard-eslint-rule-ts"
        }
      ],
      "relation": "detected-by"
    },
    {
      "links": [
        {
          "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": "negated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-logging",
          "json": "https://banes-lab.com/json/records/architecture/logging",
          "label": "Logging",
          "markdown": "https://banes-lab.com/records/architecture/logging.md",
          "ref": "architecture:logging"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-alerting",
          "json": "https://banes-lab.com/json/records/architecture/alerting",
          "label": "Alerting",
          "markdown": "https://banes-lab.com/records/architecture/alerting.md",
          "ref": "architecture:alerting"
        }
      ],
      "relation": "violates"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/software-architecture/decay#seven-controls-seven-classes",
          "json": "https://banes-lab.com/json/software-architecture/decay/seven-controls-seven-classes",
          "label": "Seven controls, seven classes",
          "markdown": "https://banes-lab.com/software-architecture/decay/seven-controls-seven-classes.md",
          "ref": "chapter:/software-architecture/decay#seven-controls-seven-classes"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-anti-patterns",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-anti-patterns",
          "label": "Anti-patterns",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md",
          "ref": "chapter:/ontology#architecture-category-anti-patterns"
        },
        {
          "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-core-vocabulary",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-vocabulary",
          "label": "Core Vocabulary",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-vocabulary"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-observability-auditability-traceability",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-observability-auditability-traceability",
          "label": "Observability / Auditability / Traceability",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-observability-auditability-traceability.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-observability-auditability-traceability"
        },
        {
          "href": "https://banes-lab.com/ontology/reasoning#the-failure-shapes",
          "json": "https://banes-lab.com/json/ontology/reasoning/the-failure-shapes",
          "label": "Failure shapes",
          "markdown": "https://banes-lab.com/ontology/reasoning/the-failure-shapes.md",
          "ref": "chapter:/ontology/reasoning#the-failure-shapes"
        },
        {
          "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-forces",
          "json": "https://banes-lab.com/json/ontology/schema/the-forces",
          "label": "The forces",
          "markdown": "https://banes-lab.com/ontology/schema/the-forces.md",
          "ref": "chapter:/ontology/schema#the-forces"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A defect in which an operation can fail without leaving a log, metric, trace or error contract.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-unversioned-breaking-change",
      "json": "https://banes-lab.com/json/records/architecture/unversioned-breaking-change",
      "label": "Unversioned Breaking Change",
      "markdown": "https://banes-lab.com/records/architecture/unversioned-breaking-change.md",
      "ref": "architecture:unversioned-breaking-change"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-unowned-risk",
      "json": "https://banes-lab.com/json/records/architecture/unowned-risk",
      "label": "Unowned Risk",
      "markdown": "https://banes-lab.com/records/architecture/unowned-risk.md",
      "ref": "architecture:unowned-risk"
    }
  },
  "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": [
    "Opaque System"
  ],
  "exemplar": {
    "after": "try { await ship(foo); } catch (error) { logger.error(\"foo.ship.failed\", error); metrics.increment(\"foo.ship.failure\"); throw new ShipFailedError(foo.id); }",
    "before": "try { await ship(foo); } catch { }",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": "Permit operations to fail without structured logs, metrics, alerts, traces, audit records, or user-visible error contracts.",
  "scope": [
    "contract_compatibility"
  ],
  "severity": "discouraged"
}