{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-observability",
  "id": "observability",
  "kind": "quality-attribute",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-observability",
    "json": "https://banes-lab.com/json/records/layer/observability",
    "label": "Observability",
    "markdown": "https://banes-lab.com/records/layer/observability.md",
    "ref": "layer:observability"
  },
  "name": "Observability",
  "ref": "architecture:observability",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-logs",
          "json": "https://banes-lab.com/json/records/lexicon/logs",
          "label": "Logs",
          "markdown": "https://banes-lab.com/records/lexicon/logs.md",
          "ref": "lexicon:logs"
        },
        {
          "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-traces",
          "json": "https://banes-lab.com/json/records/lexicon/traces",
          "label": "Traces",
          "markdown": "https://banes-lab.com/records/lexicon/traces.md",
          "ref": "lexicon:traces"
        }
      ],
      "relation": "requires"
    },
    {
      "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"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-debuggability",
          "json": "https://banes-lab.com/json/records/lexicon/debuggability",
          "label": "Debuggability",
          "markdown": "https://banes-lab.com/records/lexicon/debuggability.md",
          "ref": "lexicon:debuggability"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-incident-diagnosis",
          "json": "https://banes-lab.com/json/records/lexicon/incident-diagnosis",
          "label": "Incident Diagnosis",
          "markdown": "https://banes-lab.com/records/lexicon/incident-diagnosis.md",
          "ref": "lexicon:incident-diagnosis"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-unobservable-failure",
          "json": "https://banes-lab.com/json/records/architecture/unobservable-failure",
          "label": "Unobservable Failure",
          "markdown": "https://banes-lab.com/records/architecture/unobservable-failure.md",
          "ref": "architecture:unobservable-failure"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-cost-noise",
          "json": "https://banes-lab.com/json/records/lexicon/cost-noise",
          "label": "Cost/Noise",
          "markdown": "https://banes-lab.com/records/lexicon/cost-noise.md",
          "ref": "lexicon:cost-noise"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-information-hiding",
          "json": "https://banes-lab.com/json/records/architecture/information-hiding",
          "label": "Information Hiding",
          "markdown": "https://banes-lab.com/records/architecture/information-hiding.md",
          "ref": "architecture:information-hiding"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#tension-information-hiding-observability",
          "json": "https://banes-lab.com/json/records/tension/information-hiding-observability",
          "label": "Information Hiding / Observability",
          "markdown": "https://banes-lab.com/records/tension/information-hiding-observability.md",
          "ref": "tension:information-hiding-observability"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-cost-noise-observability",
          "json": "https://banes-lab.com/json/records/tension/cost-noise-observability",
          "label": "Observability / Cost/Noise",
          "markdown": "https://banes-lab.com/records/tension/cost-noise-observability.md",
          "ref": "tension:cost-noise-observability"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-observability",
          "json": "https://banes-lab.com/json/records/algorithms/observability",
          "label": "Observability",
          "markdown": "https://banes-lab.com/records/algorithms/observability.md",
          "ref": "algorithms:observability"
        }
      ],
      "relation": "contracts"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-blind-operation",
          "json": "https://banes-lab.com/json/records/lexicon/blind-operation",
          "label": "Blind Operation",
          "markdown": "https://banes-lab.com/records/lexicon/blind-operation.md",
          "ref": "lexicon:blind-operation"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "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#architecture-distributed-tracing",
          "json": "https://banes-lab.com/json/records/architecture/distributed-tracing",
          "label": "Distributed Tracing",
          "markdown": "https://banes-lab.com/records/architecture/distributed-tracing.md",
          "ref": "architecture:distributed-tracing"
        }
      ],
      "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-observability-auditability-traceability",
          "json": "https://banes-lab.com/json/records/architecture-category/observability-auditability-traceability",
          "label": "Observability / Auditability / Traceability",
          "markdown": "https://banes-lab.com/records/architecture-category/observability-auditability-traceability.md",
          "ref": "architecture-category:observability-auditability-traceability"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-centralized-logging",
          "json": "https://banes-lab.com/json/records/architecture/centralized-logging",
          "label": "Centralized Logging",
          "markdown": "https://banes-lab.com/records/architecture/centralized-logging.md",
          "ref": "architecture:centralized-logging"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-dead-letter-queue",
          "json": "https://banes-lab.com/json/records/architecture/dead-letter-queue",
          "label": "Dead-Letter Queue",
          "markdown": "https://banes-lab.com/records/architecture/dead-letter-queue.md",
          "ref": "architecture:dead-letter-queue"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-fail-fast",
          "json": "https://banes-lab.com/json/records/architecture/fail-fast",
          "label": "Fail Fast",
          "markdown": "https://banes-lab.com/records/architecture/fail-fast.md",
          "ref": "architecture:fail-fast"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-model-drift-monitoring",
          "json": "https://banes-lab.com/json/records/architecture/model-drift-monitoring",
          "label": "Model Drift Monitoring",
          "markdown": "https://banes-lab.com/records/architecture/model-drift-monitoring.md",
          "ref": "architecture:model-drift-monitoring"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-slo-sli",
          "json": "https://banes-lab.com/json/records/architecture/slo-sli",
          "label": "SLO/SLI",
          "markdown": "https://banes-lab.com/records/architecture/slo-sli.md",
          "ref": "architecture:slo-sli"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-dashboards",
          "json": "https://banes-lab.com/json/records/architecture/dashboards",
          "label": "Dashboards",
          "markdown": "https://banes-lab.com/records/architecture/dashboards.md",
          "ref": "architecture:dashboards"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-error-handling",
          "json": "https://banes-lab.com/json/records/architecture/error-handling",
          "label": "Error Handling",
          "markdown": "https://banes-lab.com/records/architecture/error-handling.md",
          "ref": "architecture:error-handling"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-self-healing-architecture",
          "json": "https://banes-lab.com/json/records/architecture/self-healing-architecture",
          "label": "Self-Healing Architecture",
          "markdown": "https://banes-lab.com/records/architecture/self-healing-architecture.md",
          "ref": "architecture:self-healing-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-canary-deployment",
          "json": "https://banes-lab.com/json/records/architecture/canary-deployment",
          "label": "Canary Deployment",
          "markdown": "https://banes-lab.com/records/architecture/canary-deployment.md",
          "ref": "architecture:canary-deployment"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-chaos-engineering",
          "json": "https://banes-lab.com/json/records/architecture/chaos-engineering",
          "label": "Chaos Engineering",
          "markdown": "https://banes-lab.com/records/architecture/chaos-engineering.md",
          "ref": "architecture:chaos-engineering"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/disciplined-methodology/build#tools-live-in-the-tree",
          "json": "https://banes-lab.com/json/disciplined-methodology/build/tools-live-in-the-tree",
          "label": "Tools live in the tree",
          "markdown": "https://banes-lab.com/disciplined-methodology/build/tools-live-in-the-tree.md",
          "ref": "chapter:/disciplined-methodology/build#tools-live-in-the-tree"
        },
        {
          "href": "https://banes-lab.com/software-architecture#a-system-is-a-graph",
          "json": "https://banes-lab.com/json/software-architecture/model/a-system-is-a-graph",
          "label": "A system is a graph",
          "markdown": "https://banes-lab.com/software-architecture/model/a-system-is-a-graph.md",
          "ref": "chapter:/software-architecture#a-system-is-a-graph"
        },
        {
          "href": "https://banes-lab.com/software-architecture/principles#the-structural-domain",
          "json": "https://banes-lab.com/json/software-architecture/principles/the-structural-domain",
          "label": "The structural domain",
          "markdown": "https://banes-lab.com/software-architecture/principles/the-structural-domain.md",
          "ref": "chapter:/software-architecture/principles#the-structural-domain"
        },
        {
          "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-control-coordination-centralization",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-control-coordination-centralization",
          "label": "Control / Coordination / Centralization",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-control-coordination-centralization.md",
          "ref": "chapter:/ontology#architecture-category-control-coordination-centralization"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology#architecture-category-correctness-determinism-verification"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-core-modular-design",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-core-modular-design.md",
          "ref": "chapter:/ontology#architecture-category-core-modular-design"
        },
        {
          "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-model-architecture",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-model-architecture",
          "label": "Model Architecture",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-model-architecture.md",
          "ref": "chapter:/ontology#architecture-category-model-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#architecture-category-self-healing-recovery-deployment-safety",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-self-healing-recovery-deployment-safety",
          "label": "Self-Healing / Recovery / Deployment Safety",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-self-healing-recovery-deployment-safety.md",
          "ref": "chapter:/ontology#architecture-category-self-healing-recovery-deployment-safety"
        },
        {
          "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/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/algorithms#algorithms-domain-architectural-clusters",
          "json": "https://banes-lab.com/json/ontology/algorithms/algorithms-domain-architectural-clusters",
          "label": "Architectural Clusters",
          "markdown": "https://banes-lab.com/ontology/algorithms/algorithms-domain-architectural-clusters.md",
          "ref": "chapter:/ontology/algorithms#algorithms-domain-architectural-clusters"
        },
        {
          "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": "The degree to which a system's internal behavior in production can be inferred from the logs, metrics and traces it emits.",
  "siblings": {
    "next": {
      "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"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-agentic-architecture",
      "json": "https://banes-lab.com/json/records/architecture/agentic-architecture",
      "label": "Agentic Architecture",
      "markdown": "https://banes-lab.com/records/architecture/agentic-architecture.md",
      "ref": "architecture:agentic-architecture"
    }
  },
  "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": [],
  "exemplar": {
    "after": "async function processFoo(foo: Foo, telemetry: Telemetry) {\n  return telemetry.trace(\"foo.process\", { fooId: foo.id }, async span => {\n    await fooStore.save(foo);\n    span.event(\"foo.saved\");\n    telemetry.count(\"foo.processed\", 1);\n  });\n}",
    "before": "async function processFoo(foo: Foo) {\n  await fooStore.save(foo);\n}",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "service",
    "system",
    "runtime"
  ],
  "severity": "contextual"
}