{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-distributed-tracing",
  "id": "distributed-tracing",
  "kind": "mechanism",
  "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": "Distributed Tracing",
  "ref": "architecture:distributed-tracing",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-trace-context-propagation",
          "json": "https://banes-lab.com/json/records/lexicon/trace-context-propagation",
          "label": "Trace Context Propagation",
          "markdown": "https://banes-lab.com/records/lexicon/trace-context-propagation.md",
          "ref": "lexicon:trace-context-propagation"
        }
      ],
      "relation": "requires"
    },
    {
      "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"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-causality",
          "json": "https://banes-lab.com/json/records/architecture/causality",
          "label": "Causality",
          "markdown": "https://banes-lab.com/records/architecture/causality.md",
          "ref": "architecture:causality"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-latency-failure-root-cause-analysis",
          "json": "https://banes-lab.com/json/records/lexicon/latency-failure-root-cause-analysis",
          "label": "Latency/Failure Root Cause Analysis",
          "markdown": "https://banes-lab.com/records/lexicon/latency-failure-root-cause-analysis.md",
          "ref": "lexicon:latency-failure-root-cause-analysis"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-opaque-distributed-calls",
          "json": "https://banes-lab.com/json/records/lexicon/opaque-distributed-calls",
          "label": "Opaque Distributed Calls",
          "markdown": "https://banes-lab.com/records/lexicon/opaque-distributed-calls.md",
          "ref": "lexicon:opaque-distributed-calls"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-overhead-sampling",
          "json": "https://banes-lab.com/json/records/lexicon/overhead-sampling",
          "label": "Overhead/Sampling",
          "markdown": "https://banes-lab.com/records/lexicon/overhead-sampling.md",
          "ref": "lexicon:overhead-sampling"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-distributed-tracing-overhead-sampling",
          "json": "https://banes-lab.com/json/records/tension/distributed-tracing-overhead-sampling",
          "label": "Distributed Tracing / Overhead/Sampling",
          "markdown": "https://banes-lab.com/records/tension/distributed-tracing-overhead-sampling.md",
          "ref": "tension:distributed-tracing-overhead-sampling"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-opaque-distributed-calls",
          "json": "https://banes-lab.com/json/records/lexicon/opaque-distributed-calls",
          "label": "Opaque Distributed Calls",
          "markdown": "https://banes-lab.com/records/lexicon/opaque-distributed-calls.md",
          "ref": "lexicon:opaque-distributed-calls"
        }
      ],
      "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-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-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-traceability",
          "json": "https://banes-lab.com/json/records/architecture/traceability",
          "label": "Traceability",
          "markdown": "https://banes-lab.com/records/architecture/traceability.md",
          "ref": "architecture:traceability"
        }
      ],
      "relation": "refactors"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-correlation-id",
          "json": "https://banes-lab.com/json/records/architecture/correlation-id",
          "label": "Correlation ID",
          "markdown": "https://banes-lab.com/records/architecture/correlation-id.md",
          "ref": "architecture:correlation-id"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-causality-ordering-distributed-time",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-causality-ordering-distributed-time",
          "label": "Causality / Ordering / Distributed Time",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-causality-ordering-distributed-time.md",
          "ref": "chapter:/ontology#architecture-category-causality-ordering-distributed-time"
        },
        {
          "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-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-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/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 mechanism that propagates a trace context across service calls and records each call as a timed span of one trace.",
  "siblings": {
    "next": {
      "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"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-causation-id",
      "json": "https://banes-lab.com/json/records/architecture/causation-id",
      "label": "Causation ID",
      "markdown": "https://banes-lab.com/records/architecture/causation-id.md",
      "ref": "architecture:causation-id"
    }
  },
  "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": "await tracer.span(\"foo.request\", async span => {\n  await fooService.call({ traceparent: span.traceparent });\n  await barService.call({ traceparent: span.traceparent });\n});",
    "before": "await fooService.call();\nawait barService.call();",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "distributed system",
    "service mesh"
  ],
  "severity": "contextual"
}