@documentation-robotics/cli 0.1.0

package/dist/schemas/bundled/11-apm-observability-layer.schema.json

@@ -0,0 +1,1430 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://example.com/schemas/11-apm-observability-layer.schema.json",
+  "title": "APM/Observability Layer Layer Schema",
+  "description": "Defines distributed tracing, logging, and metrics instrumentation using OpenTelemetry standards for application performance monitoring and observability.",
+  "layerMetadata": {
+    "layerId": "11-apm-observability-layer",
+    "layerName": "APM/Observability Layer",
+    "intraLayerRelationshipSupport": true,
+    "crossLayerRelationshipSupport": true,
+    "relationshipCatalogVersion": "2.1.0"
+  },
+  "intraLayerRelationships": {
+    "$comment": "Relationships between entities within this layer. References relationship-catalog.json by ID.",
+    "allowed": [
+      {
+        "relationshipTypeId": "composition",
+        "sourceTypes": ["APMConfiguration", "MeterConfig", "Span"],
+        "targetTypes": ["MetricInstrument", "SpanEvent", "TraceConfiguration"],
+        "examples": [
+          {
+            "source": "Span",
+            "target": "SpanEvent",
+            "description": "Span composes timestamped events occurring during execution",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "APMConfiguration",
+            "target": "TraceConfiguration",
+            "description": "APM config composes trace, log, and metric configurations",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "MeterConfig",
+            "target": "MetricInstrument",
+            "description": "Meter config composes individual metric instruments",
+            "layer": "11-apm-observability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "aggregation",
+        "sourceTypes": ["InstrumentationScope", "Resource", "TraceConfiguration"],
+        "targetTypes": ["ExporterConfig", "MetricInstrument", "Span"],
+        "examples": [
+          {
+            "source": "Resource",
+            "target": "Span",
+            "description": "Resource aggregates all spans it produces",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "InstrumentationScope",
+            "target": "MetricInstrument",
+            "description": "Instrumentation scope aggregates metrics it records",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "TraceConfiguration",
+            "target": "ExporterConfig",
+            "description": "Trace config aggregates trace exporters",
+            "layer": "11-apm-observability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "specialization",
+        "sourceTypes": ["PremiumAccount", "Schema"],
+        "targetTypes": ["Account", "Schema"],
+        "examples": [
+          {
+            "source": "PremiumAccount",
+            "target": "Account",
+            "description": "Premium account specializes the general account concept"
+          },
+          {
+            "source": "Schema",
+            "target": "Schema",
+            "description": "API schema specializes another via allOf/oneOf/anyOf composition",
+            "layer": "06-api"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "triggering",
+        "sourceTypes": ["DataQualityMetric"],
+        "targetTypes": ["LogRecord"],
+        "examples": [
+          {
+            "source": "DataQualityMetric",
+            "target": "LogRecord",
+            "description": "Quality violation triggers alert log record",
+            "layer": "11-apm-observability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "flow",
+        "sourceTypes": ["LogProcessor", "MetricInstrument", "Span"],
+        "targetTypes": ["ExporterConfig", "LogProcessor", "Span"],
+        "examples": [
+          {
+            "source": "Span",
+            "target": "Span",
+            "description": "Span flows to child spans (request propagation)",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "LogProcessor",
+            "target": "LogProcessor",
+            "description": "Log records flow through processor pipeline in order",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "MetricInstrument",
+            "target": "ExporterConfig",
+            "description": "Collected metrics flow to configured exporters",
+            "layer": "11-apm-observability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "serving",
+        "sourceTypes": ["ExporterConfig", "InstrumentationConfig"],
+        "targetTypes": ["APMConfiguration", "Resource"],
+        "examples": [
+          {
+            "source": "InstrumentationConfig",
+            "target": "Resource",
+            "description": "Instrumentation config serves resources it instruments",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "ExporterConfig",
+            "target": "APMConfiguration",
+            "description": "Exporter serves APM configuration by delivering telemetry",
+            "layer": "11-apm-observability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "access",
+        "sourceTypes": ["LogProcessor", "MetricInstrument"],
+        "targetTypes": ["Attribute"],
+        "examples": [
+          {
+            "source": "LogProcessor",
+            "target": "Attribute",
+            "description": "Log processor accesses attributes for filtering/transformation",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "MetricInstrument",
+            "target": "Attribute",
+            "description": "Metric instrument accesses attributes for labeling",
+            "layer": "11-apm-observability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "reference",
+        "sourceTypes": ["LogRecord", "Span", "SpanLink"],
+        "targetTypes": ["Span"],
+        "examples": [
+          {
+            "source": "Span",
+            "target": "Span",
+            "description": "Span references parent span via parentSpanId (trace hierarchy)",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "LogRecord",
+            "target": "Span",
+            "description": "Log record references associated span via traceContext",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "SpanLink",
+            "target": "Span",
+            "description": "Span link references target span across traces",
+            "layer": "11-apm-observability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "depends-on",
+        "sourceTypes": ["LogRecord", "MetricInstrument", "Span"],
+        "targetTypes": ["InstrumentationScope", "Resource"],
+        "examples": [
+          {
+            "source": "Span",
+            "target": "Resource",
+            "description": "Span depends on resource for identity context",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "Span",
+            "target": "InstrumentationScope",
+            "description": "Span depends on instrumentation scope for source context",
+            "layer": "11-apm-observability"
+          },
+          {
+            "source": "LogRecord",
+            "target": "Resource",
+            "description": "Log record depends on resource for identity context",
+            "layer": "11-apm-observability"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "fulfills-requirements",
+        "sourceTypes": ["ApplicationService", "Operation"],
+        "targetTypes": ["Requirement"],
+        "examples": [
+          {
+            "source": "ApplicationService",
+            "target": "Requirement",
+            "description": "OAuth service fulfills authentication requirement"
+          },
+          {
+            "source": "Operation",
+            "sourceLayer": "06-api",
+            "target": "Requirement",
+            "targetLayer": "01-motivation",
+            "value": "req-product-creation-capability",
+            "description": "POST /products operation fulfills product creation requirement"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "measures-outcome",
+        "sourceTypes": ["Metric"],
+        "targetTypes": ["Outcome"],
+        "examples": [
+          {
+            "source": "Metric",
+            "target": "Outcome",
+            "description": "Response time metric measures performance outcome"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "traces",
+        "sourceTypes": ["APIOperation"],
+        "targetTypes": ["DistributedTrace"],
+        "examples": [
+          {
+            "source": "APIOperation",
+            "target": "DistributedTrace",
+            "description": "API operation participates in distributed trace"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "monitors",
+        "sourceTypes": ["HealthCheck"],
+        "targetTypes": ["ApplicationService"],
+        "examples": [
+          {
+            "source": "HealthCheck",
+            "target": "ApplicationService",
+            "description": "Health check monitors application service"
+          }
+        ]
+      },
+      {
+        "relationshipTypeId": "measures",
+        "sourceTypes": ["Metric"],
+        "targetTypes": ["APIOperation"],
+        "examples": [
+          {
+            "source": "Metric",
+            "target": "APIOperation",
+            "description": "Response time metric measures API operation"
+          }
+        ]
+      }
+    ]
+  },
+  "crossLayerRelationships": {
+    "$comment": "Relationships to/from entities in other layers",
+    "outgoing": [
+      {
+        "id": "motivation-governed-by-principles",
+        "predicate": "governed-by-principles",
+        "inversePredicate": "governs",
+        "targetLayer": "01-motivation",
+        "targetTypes": ["GovernedByPrinciple"],
+        "sourceTypes": ["BusinessService"],
+        "fieldPath": "motivation.governed-by-principles",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "high",
+        "required": false,
+        "description": "BusinessService governed by Principles",
+        "examples": [
+          {
+            "elementType": "BusinessService",
+            "elementId": "order-service",
+            "elementName": "Order Processing Service",
+            "fieldPath": "motivation.governed-by-principles",
+            "value": "principle-customer-first,principle-automation",
+            "layer": "02-business"
+          },
+          {
+            "elementType": "ApplicationService",
+            "elementId": "product-service",
+            "elementName": "product-service",
+            "fieldPath": "motivation.governed-by-principles",
+            "value": "principle-api-first,principle-cloud-native",
+            "layer": "04-application"
+          }
+        ]
+      },
+      {
+        "id": "motivation-supports-goals",
+        "predicate": "supports-goals",
+        "inversePredicate": "supported-by",
+        "targetLayer": "01-motivation",
+        "targetTypes": ["SupportsGoal"],
+        "sourceTypes": ["BusinessService"],
+        "fieldPath": "motivation.supports-goals",
+        "cardinality": "array",
+        "format": "reference",
+        "strength": "high",
+        "required": false,
+        "description": "BusinessService supports Goals",
+        "examples": [
+          {
+            "elementType": "BusinessService",
+            "elementId": "order-service",
+            "elementName": "Order Processing Service",
+            "fieldPath": "motivation.supports-goals",
+            "value": "goal-customer-satisfaction,goal-revenue-growth",
+            "layer": "02-business"
+          },
+          {
+            "elementType": "ApplicationService",
+            "elementId": "product-service",
+            "elementName": "product-service",
+            "fieldPath": "motivation.supports-goals",
+            "value": "goal-product-catalog-accuracy,goal-customer-satisfaction",
+            "layer": "04-application"
+          }
+        ]
+      },
+      {
+        "id": "security-classification",
+        "predicate": "classification",
+        "inversePredicate": "referenced-by",
+        "targetLayer": "03-security",
+        "targetTypes": ["Classification"],
+        "sourceTypes": ["Artifact"],
+        "fieldPath": "security.classification",
+        "cardinality": "single",
+        "format": "string",
+        "strength": "low",
+        "required": false,
+        "description": "Links to Classification in target layer",
+        "examples": [
+          {
+            "elementType": "Artifact",
+            "elementId": "product-db",
+            "elementName": "product-db",
+            "fieldPath": "security.classification",
+            "value": "internal",
+            "layer": "05-technology"
+          },
+          {
+            "elementType": "Artifact",
+            "elementId": "customer-db",
+            "elementName": "customer-db",
+            "fieldPath": "security.classification",
+            "value": "restricted",
+            "layer": "05-technology"
+          }
+        ]
+      }
+    ],
+    "incoming": [
+      {
+        "id": "apm-criticality",
+        "predicate": "referenced-by",
+        "inversePredicate": "apm-criticality",
+        "sourceLayer": "06-api",
+        "sourceTypes": ["Operation", "SecurityScheme"],
+        "targetTypes": ["Criticality"],
+        "fieldPath": "x-apm-criticality",
+        "cardinality": "single",
+        "description": "Inverse of: enum [low, medium, high, critical] (optional)"
+      },
+      {
+        "id": "apm-health-check-endpoint",
+        "predicate": "referenced-by",
+        "inversePredicate": "health-check-endpoint",
+        "sourceLayer": "05-technology",
+        "sourceTypes": ["TechnologyService"],
+        "targetTypes": ["HealthCheckEndpoint"],
+        "fieldPath": "apm.health-check-endpoint",
+        "cardinality": "single",
+        "description": "Inverse of: health check endpoint"
+      },
+      {
+        "id": "apm-health-monitored",
+        "predicate": "referenced-by",
+        "inversePredicate": "health-monitored",
+        "sourceLayer": "05-technology",
+        "sourceTypes": ["TechnologyService"],
+        "targetTypes": ["HealthMonitored"],
+        "fieldPath": "apm.health-monitored",
+        "cardinality": "single",
+        "description": "Inverse of: whether health is actively monitored"
+      },
+      {
+        "id": "apm-sla-target-availability",
+        "predicate": "referenced-by",
+        "inversePredicate": "sla-target-availability",
+        "sourceLayer": "04-application",
+        "sourceTypes": ["ApplicationService"],
+        "targetTypes": ["SlaTargetAvailability"],
+        "fieldPath": "apm.sla-target-availability",
+        "cardinality": "single",
+        "description": "Inverse of: string (e.g., \"99.95%\", \"99.99%\", optional)"
+      },
+      {
+        "id": "apm-sla-target-availability",
+        "predicate": "referenced-by",
+        "inversePredicate": "sla-target-availability",
+        "sourceLayer": "05-technology",
+        "sourceTypes": ["TechnologyService"],
+        "targetTypes": ["SlaTargetAvailability"],
+        "fieldPath": "apm.sla-target-availability",
+        "cardinality": "single",
+        "description": "Inverse of: string (e.g., \"99.95%\", \"99.99%\", optional)"
+      },
+      {
+        "id": "apm-sla-target-availability",
+        "predicate": "referenced-by",
+        "inversePredicate": "sla-target-availability",
+        "sourceLayer": "06-api",
+        "sourceTypes": ["Operation", "SecurityScheme"],
+        "targetTypes": ["SlaTargetAvailability"],
+        "fieldPath": "apm.sla-target-availability",
+        "cardinality": "single",
+        "description": "Inverse of: string (e.g., \"99.95%\", \"99.99%\", optional)"
+      },
+      {
+        "id": "apm-sla-target-latency",
+        "predicate": "referenced-by",
+        "inversePredicate": "sla-target-latency",
+        "sourceLayer": "04-application",
+        "sourceTypes": ["ApplicationService"],
+        "targetTypes": ["SlaTargetLatency"],
+        "fieldPath": "apm.sla-target-latency",
+        "cardinality": "single",
+        "description": "Inverse of: string (e.g., \"200ms\", \"500ms\", optional)"
+      },
+      {
+        "id": "apm-sla-target-latency",
+        "predicate": "referenced-by",
+        "inversePredicate": "sla-target-latency",
+        "sourceLayer": "05-technology",
+        "sourceTypes": ["TechnologyService"],
+        "targetTypes": ["SlaTargetLatency"],
+        "fieldPath": "apm.sla-target-latency",
+        "cardinality": "single",
+        "description": "Inverse of: string (e.g., \"200ms\", \"500ms\", optional)"
+      },
+      {
+        "id": "apm-sla-target-latency",
+        "predicate": "referenced-by",
+        "inversePredicate": "sla-target-latency",
+        "sourceLayer": "06-api",
+        "sourceTypes": ["Operation", "SecurityScheme"],
+        "targetTypes": ["SlaTargetLatency"],
+        "fieldPath": "apm.sla-target-latency",
+        "cardinality": "single",
+        "description": "Inverse of: string (e.g., \"200ms\", \"500ms\", optional)"
+      },
+      {
+        "id": "apm-trace",
+        "predicate": "referenced-by",
+        "inversePredicate": "apm-trace",
+        "sourceLayer": "06-api",
+        "sourceTypes": ["Operation", "SecurityScheme"],
+        "targetTypes": ["Trace"],
+        "fieldPath": "x-apm-trace",
+        "cardinality": "single",
+        "description": "Inverse of: boolean (optional)"
+      },
+      {
+        "id": "apm-traced",
+        "predicate": "referenced-by",
+        "inversePredicate": "traced",
+        "sourceLayer": "04-application",
+        "sourceTypes": ["ApplicationService", "Data Properties"],
+        "targetTypes": ["Traced"],
+        "fieldPath": "apm.traced",
+        "cardinality": "single",
+        "description": "Inverse of: Links to Traced in target layer"
+      }
+    ]
+  },
+  "type": "object",
+  "properties": {
+    "spans": {
+      "type": "array",
+      "description": "Collection of Span entities",
+      "items": {
+        "$ref": "#/definitions/Span"
+      }
+    },
+    "span-events": {
+      "type": "array",
+      "description": "Collection of SpanEvent entities",
+      "items": {
+        "$ref": "#/definitions/SpanEvent"
+      }
+    },
+    "span-links": {
+      "type": "array",
+      "description": "Collection of SpanLink entities",
+      "items": {
+        "$ref": "#/definitions/SpanLink"
+      }
+    },
+    "span-statuses": {
+      "type": "array",
+      "description": "Collection of SpanStatus entities",
+      "items": {
+        "$ref": "#/definitions/SpanStatus"
+      }
+    },
+    "log-records": {
+      "type": "array",
+      "description": "Collection of LogRecord entities",
+      "items": {
+        "$ref": "#/definitions/LogRecord"
+      }
+    },
+    "resources": {
+      "type": "array",
+      "description": "Collection of Resource entities",
+      "items": {
+        "$ref": "#/definitions/Resource"
+      }
+    },
+    "instrumentation-scopes": {
+      "type": "array",
+      "description": "Collection of InstrumentationScope entities",
+      "items": {
+        "$ref": "#/definitions/InstrumentationScope"
+      }
+    },
+    "exporter-configs": {
+      "type": "array",
+      "description": "Collection of ExporterConfig entities",
+      "items": {
+        "$ref": "#/definitions/ExporterConfig"
+      }
+    },
+    "instrumentation-configs": {
+      "type": "array",
+      "description": "Collection of InstrumentationConfig entities",
+      "items": {
+        "$ref": "#/definitions/InstrumentationConfig"
+      }
+    },
+    "log-processors": {
+      "type": "array",
+      "description": "Collection of LogProcessor entities",
+      "items": {
+        "$ref": "#/definitions/LogProcessor"
+      }
+    },
+    "meter-configs": {
+      "type": "array",
+      "description": "Collection of MeterConfig entities",
+      "items": {
+        "$ref": "#/definitions/MeterConfig"
+      }
+    },
+    "metric-instruments": {
+      "type": "array",
+      "description": "Collection of MetricInstrument entities",
+      "items": {
+        "$ref": "#/definitions/MetricInstrument"
+      }
+    },
+    "attributes": {
+      "type": "array",
+      "description": "Collection of Attribute entities",
+      "items": {
+        "$ref": "#/definitions/Attribute"
+      }
+    },
+    "apm-configurations": {
+      "type": "array",
+      "description": "Collection of APMConfiguration entities",
+      "items": {
+        "$ref": "#/definitions/APMConfiguration"
+      }
+    },
+    "trace-configurations": {
+      "type": "array",
+      "description": "Collection of TraceConfiguration entities",
+      "items": {
+        "$ref": "#/definitions/TraceConfiguration"
+      }
+    },
+    "log-configurations": {
+      "type": "array",
+      "description": "Collection of LogConfiguration entities",
+      "items": {
+        "$ref": "#/definitions/LogConfiguration"
+      }
+    },
+    "metric-configurations": {
+      "type": "array",
+      "description": "Collection of MetricConfiguration entities",
+      "items": {
+        "$ref": "#/definitions/MetricConfiguration"
+      }
+    },
+    "data-quality-metricses": {
+      "type": "array",
+      "description": "Collection of DataQualityMetrics entities",
+      "items": {
+        "$ref": "#/definitions/DataQualityMetrics"
+      }
+    },
+    "data-quality-metrics": {
+      "type": "array",
+      "description": "Collection of DataQualityMetric entities",
+      "items": {
+        "$ref": "#/definitions/DataQualityMetric"
+      }
+    }
+  },
+  "definitions": {
+    "SpanKind": {
+      "type": "string",
+      "enum": ["INTERNAL", "SERVER", "CLIENT", "PRODUCER", "CONSUMER"]
+    },
+    "StatusCode": {
+      "type": "string",
+      "enum": ["UNSET", "OK", "ERROR"]
+    },
+    "SeverityNumber": {
+      "type": "string",
+      "enum": [
+        "UNSPECIFIED",
+        "TRACE",
+        "TRACE2",
+        "TRACE3",
+        "TRACE4",
+        "DEBUG",
+        "DEBUG2",
+        "DEBUG3",
+        "DEBUG4",
+        "INFO",
+        "INFO2",
+        "INFO3",
+        "INFO4",
+        "WARN",
+        "WARN2",
+        "WARN3",
+        "WARN4",
+        "ERROR",
+        "ERROR2",
+        "ERROR3",
+        "ERROR4",
+        "FATAL",
+        "FATAL2",
+        "FATAL3",
+        "FATAL4"
+      ]
+    },
+    "ExporterType": {
+      "type": "string",
+      "enum": ["otlp", "jaeger", "zipkin", "prometheus", "console", "file", "logging", "noop"]
+    },
+    "ExporterProtocol": {
+      "type": "string",
+      "enum": ["grpc", "http", "http/json"]
+    },
+    "CompressionType": {
+      "type": "string",
+      "enum": ["none", "gzip", "zstd"]
+    },
+    "AuthType": {
+      "type": "string",
+      "enum": ["none", "api-key", "bearer", "basic", "oauth2", "mTLS"]
+    },
+    "InstrumentationType": {
+      "type": "string",
+      "enum": [
+        "http",
+        "database",
+        "redis",
+        "grpc",
+        "messaging",
+        "graphql",
+        "aws-sdk",
+        "mongodb",
+        "elasticsearch",
+        "fs",
+        "dns",
+        "net",
+        "custom"
+      ]
+    },
+    "LogProcessorType": {
+      "type": "string",
+      "enum": [
+        "batch",
+        "resource",
+        "filter",
+        "transform",
+        "sampling",
+        "redact",
+        "routing",
+        "memory-limiter",
+        "custom"
+      ]
+    },
+    "TransformOperation": {
+      "type": "string",
+      "enum": [
+        "set-attribute",
+        "delete-attribute",
+        "rename-attribute",
+        "hash-attribute",
+        "truncate-body",
+        "extract-attribute",
+        "convert-severity"
+      ]
+    },
+    "AggregationTemporality": {
+      "type": "string",
+      "enum": ["delta", "cumulative"]
+    },
+    "InstrumentType": {
+      "type": "string",
+      "enum": [
+        "counter",
+        "up_down_counter",
+        "gauge",
+        "histogram",
+        "observable_counter",
+        "observable_up_down_counter",
+        "observable_gauge"
+      ]
+    },
+    "SamplerType": {
+      "type": "string",
+      "enum": [
+        "always_on",
+        "always_off",
+        "traceidratio",
+        "parentbased_always_on",
+        "parentbased_always_off",
+        "parentbased_traceidratio"
+      ]
+    },
+    "PropagatorType": {
+      "type": "string",
+      "enum": ["w3c-trace-context", "w3c-baggage", "b3", "jaeger", "xray", "ottrace"]
+    },
+    "LogLevel": {
+      "type": "string",
+      "enum": ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL"]
+    },
+    "DataQualityType": {
+      "type": "string",
+      "enum": [
+        "completeness",
+        "accuracy",
+        "freshness",
+        "consistency",
+        "uniqueness",
+        "validity",
+        "timeliness",
+        "integrity"
+      ]
+    },
+    "Span": {
+      "type": "object",
+      "description": "Unit of work in distributed tracing",
+      "required": [
+        "id",
+        "traceId",
+        "spanId",
+        "traceState",
+        "parentSpanId",
+        "name",
+        "spanKind",
+        "startTimeUnixNano",
+        "endTimeUnixNano",
+        "droppedAttributesCount",
+        "droppedEventsCount",
+        "droppedLinksCount"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "traceId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "spanId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "traceState": {
+          "type": "string",
+          "minLength": 1
+        },
+        "parentSpanId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "spanKind": {
+          "$ref": "#/definitions/SpanKind"
+        },
+        "startTimeUnixNano": {
+          "type": "string",
+          "minLength": 1
+        },
+        "endTimeUnixNano": {
+          "type": "string",
+          "minLength": 1
+        },
+        "droppedAttributesCount": {
+          "type": "string",
+          "minLength": 1
+        },
+        "droppedEventsCount": {
+          "type": "string",
+          "minLength": 1
+        },
+        "droppedLinksCount": {
+          "type": "string",
+          "minLength": 1
+        },
+        "attributes": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "events": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        },
+        "links": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "SpanEvent": {
+      "type": "object",
+      "description": "Timestamped event during span execution",
+      "required": ["id", "timeUnixNano", "name", "droppedAttributesCount"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "timeUnixNano": {
+          "type": "string",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "droppedAttributesCount": {
+          "type": "string",
+          "minLength": 1
+        },
+        "attributes": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "SpanLink": {
+      "type": "object",
+      "description": "Link to related span (different trace or parent)",
+      "required": ["id", "name", "traceId", "spanId", "droppedAttributesCount"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "traceId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "spanId": {
+          "type": "string",
+          "minLength": 1
+        },
+        "traceState": {
+          "type": "string",
+          "minLength": 1
+        },
+        "droppedAttributesCount": {
+          "type": "string",
+          "minLength": 1
+        },
+        "attributes": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "SpanStatus": {
+      "type": "object",
+      "description": "Outcome of span execution",
+      "required": ["id", "name", "code"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "code": {
+          "$ref": "#/definitions/StatusCode"
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "LogRecord": {
+      "type": "object",
+      "description": "OpenTelemetry log entry",
+      "required": [
+        "id",
+        "name",
+        "timeUnixNano",
+        "observedTimeUnixNano",
+        "severityNumber",
+        "body",
+        "flags",
+        "droppedAttributesCount"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "timeUnixNano": {
+          "type": "string",
+          "minLength": 1
+        },
+        "observedTimeUnixNano": {
+          "type": "string",
+          "minLength": 1
+        },
+        "severityNumber": {
+          "$ref": "#/definitions/SeverityNumber"
+        },
+        "severityText": {
+          "type": "string",
+          "minLength": 1
+        },
+        "body": {
+          "type": "string",
+          "minLength": 1
+        },
+        "flags": {
+          "type": "string",
+          "minLength": 1
+        },
+        "droppedAttributesCount": {
+          "type": "string",
+          "minLength": 1
+        },
+        "attributes": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "Resource": {
+      "type": "object",
+      "description": "Immutable representation of entity producing telemetry",
+      "required": ["id", "name", "droppedAttributesCount"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schemaUrl": {
+          "type": "string",
+          "minLength": 1
+        },
+        "droppedAttributesCount": {
+          "type": "string",
+          "minLength": 1
+        },
+        "attributes": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "InstrumentationScope": {
+      "type": "object",
+      "description": "Logical unit of code that generates telemetry",
+      "required": ["id", "name", "droppedAttributesCount"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schemaUrl": {
+          "type": "string",
+          "minLength": 1
+        },
+        "droppedAttributesCount": {
+          "type": "string",
+          "minLength": 1
+        },
+        "attributes": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ExporterConfig": {
+      "type": "object",
+      "description": "Configuration for telemetry data export destinations, specifying protocol (OTLP, Jaeger, Prometheus), endpoints, authentication, batching, and retry policies. Controls where observability data is sent.",
+      "required": ["id", "name", "type", "endpoint"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/ExporterType"
+        },
+        "enabled": {
+          "type": "boolean"
+        },
+        "endpoint": {
+          "type": "string",
+          "minLength": 1
+        },
+        "protocol": {
+          "$ref": "#/definitions/ExporterProtocol"
+        }
+      }
+    },
+    "InstrumentationConfig": {
+      "type": "object",
+      "description": "Configuration for automatic or manual instrumentation of application code, specifying which libraries, frameworks, or code paths to instrument and capture telemetry from.",
+      "required": ["id", "name", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/InstrumentationType"
+        },
+        "enabled": {
+          "type": "boolean"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "LogProcessor": {
+      "type": "object",
+      "description": "A processing pipeline component for log records, enabling filtering, transformation, enrichment, or routing of logs before export. Customizes log processing behavior.",
+      "required": ["id", "name", "type"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/LogProcessorType"
+        },
+        "order": {
+          "type": "integer"
+        },
+        "enabled": {
+          "type": "boolean"
+        }
+      }
+    },
+    "MeterConfig": {
+      "type": "object",
+      "description": "Configuration for metric collection meters, specifying aggregation temporality, cardinality limits, and collection intervals. Controls how metrics are gathered and aggregated.",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "schemaUrl": {
+          "type": "string",
+          "minLength": 1
+        },
+        "instruments": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "MetricInstrument": {
+      "type": "object",
+      "description": "Defines a specific metric measurement instrument (Counter, Gauge, Histogram, etc.) with its name, unit, description, and attributes. The fundamental unit of metric collection.",
+      "required": ["id", "name", "type", "unit"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "$ref": "#/definitions/InstrumentType"
+        },
+        "unit": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "enabled": {
+          "type": "boolean"
+        },
+        "source": {
+          "type": "object",
+          "description": "Source code reference for code-defined metrics",
+          "properties": {
+            "reference": {
+              "$ref": "common/source-references.schema.json#/definitions/SourceReference"
+            }
+          }
+        }
+      }
+    },
+    "Attribute": {
+      "type": "object",
+      "description": "Key-value pair metadata",
+      "required": ["id", "name", "key", "value"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "key": {
+          "type": "string",
+          "minLength": 1
+        },
+        "value": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "APMConfiguration": {
+      "type": "object",
+      "description": "Complete APM configuration for an application",
+      "required": ["id", "name", "version", "application"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "application": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "TraceConfiguration": {
+      "type": "object",
+      "description": "Distributed tracing configuration",
+      "required": ["id", "name", "serviceName"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "serviceName": {
+          "type": "string",
+          "minLength": 1
+        },
+        "serviceVersion": {
+          "type": "string",
+          "minLength": 1
+        },
+        "deploymentEnvironment": {
+          "type": "string",
+          "minLength": 1
+        },
+        "source": {
+          "type": "object",
+          "description": "Source code reference for trace configuration",
+          "properties": {
+            "reference": {
+              "$ref": "common/source-references.schema.json#/definitions/SourceReference"
+            }
+          }
+        }
+      }
+    },
+    "LogConfiguration": {
+      "type": "object",
+      "description": "Logging configuration",
+      "required": ["name", "id", "serviceName", "logLevel"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "serviceName": {
+          "type": "string",
+          "minLength": 1
+        },
+        "logLevel": {
+          "$ref": "#/definitions/LogLevel"
+        }
+      }
+    },
+    "MetricConfiguration": {
+      "type": "object",
+      "description": "Metrics configuration",
+      "required": ["id", "name", "serviceName"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "format": "uuid",
+          "minLength": 1
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "serviceName": {
+          "type": "string",
+          "minLength": 1
+        },
+        "exportIntervalMillis": {
+          "type": "integer"
+        }
+      }
+    },
+    "DataQualityMetrics": {
+      "type": "object",
+      "description": "Data quality monitoring metrics (referenced by Data Model Layer x-apm-data-quality-metrics)",
+      "required": ["schemaRef"],
+      "properties": {
+        "schemaRef": {
+          "type": "string",
+          "minLength": 1
+        },
+        "monitoringEnabled": {
+          "type": "boolean"
+        },
+        "metrics": {
+          "type": "array",
+          "description": "Contains relationship",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "DataQualityMetric": {
+      "type": "object",
+      "description": "Individual data quality metric",
+      "required": ["type", "name", "measurement", "threshold"],
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/DataQualityType"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "measurement": {
+          "type": "string",
+          "minLength": 1
+        },
+        "threshold": {
+          "type": "string",
+          "minLength": 1
+        },
+        "alertOnViolation": {
+          "type": "boolean"
+        }
+      }
+    }
+  }
+}