trace integrity audit derived

{
  "input": {
    "body": {
      "spans": "[\n {\n  \"trace_id\": \"t1\",\n  \"span_id\": \"a\",\n  \"name\": \"GET /orders\",\n  \"kind\": \"SPAN_KIND_SERVER\",\n  \"start_time\": \"2026-10-02T12:00:00.000Z\",\n  \"end_time\": \"2026-10-02T12:00:00.500Z\",\n  \"attributes\": {\n   \"http.request.method\": \"GET\",\n   \"http.route\": \"/orders\"\n  }\n },\n {\n  \"trace_id\": \"t1\",\n  \"span_id\": \"b\",\n  \"parent_span_id\": \"a\",\n  \"name\": \"SELECT orders\",\n  \"kind\": \"SPAN_KIND_CLIENT\",\n  \"start_time\": \"2026-10-02T11:59:59.960Z\",\n  \"end_time\": \"2026-10-02T12:00:00.200Z\",\n  \"attributes\": {}\n },\n {\n  \"trace_id\": \"t1\",\n  \"span_id\": \"c\",\n  \"parent_span_id\": \"zz\",\n  \"name\": \"cache.get\",\n  \"start_time\": \"2026-10-02T12:00:00.100Z\",\n  \"end_time\": \"2026-10-02T12:00:00.110Z\",\n  \"attributes\": {}\n },\n {\n  \"trace_id\": \"t2\",\n  \"span_id\": \"d\",\n  \"name\": \"GET /orders/8827341/items\",\n  \"kind\": \"HTTP_SERVER\",\n  \"start_time\": \"2026-10-02T12:00:01.000\",\n  \"end_time\": \"2026-10-02T12:00:01.300Z\",\n  \"attributes\": {\n   \"http.request.method\": \"GET\"\n  }\n }\n]"
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "intact": false,
      "limits": {
        "maxLines": 20000,
        "maxSpans": 10000,
        "maxFields": 500,
        "maxSamples": 20000,
        "maxFindings": 500,
        "maxJsonBytes": 2097152
      },
      "passed": false,
      "traces": [
        {
          "trace": "t1",
          "root_count": 1,
          "span_count": 3,
          "duration_ms": 540,
          "orphan_count": 1
        },
        {
          "trace": "t2",
          "root_count": 1,
          "span_count": 1,
          "duration_ms": 300,
          "orphan_count": 0
        }
      ],
      "complete": true,
      "findings": [
        {
          "code": "TIMESTAMP_WITHOUT_OFFSET",
          "span": "d",
          "detail": "Span d has a start time with no UTC offset, so it is not a point in time. It was read as UTC, which is a guess."
        },
        {
          "code": "PARENT_SPAN_NOT_IN_TRACE",
          "span": "c",
          "trace": "t1",
          "detail": "Span c names parent zz, which is not in the data supplied. The trace renders as separate fragments rather than one tree."
        },
        {
          "code": "CHILD_STARTS_BEFORE_PARENT",
          "span": "b",
          "trace": "t1",
          "detail": "Span b starts 40ms before its parent a. A child cannot precede its parent, so this is clock skew between the hosts rather than a defect in the code, and every latency figure derived from it inherits t..."
        }
      ],
      "request_id": "example-request",
      "service_id": "trace_integrity_audit",
      "span_count": 4,
      "assumptions": [
        "Both snake_case and camelCase field names are read, because exporters differ and reading only one would report a well-formed trace as having no ids at all.",
        "A timestamp with no UTC offset is reported rather than assumed: it is not a point in time, and assuming UTC is how a timeline comes to be hours wrong with no error anywhere. It is read as UTC so the r...",
        "A child starting before its parent is reported as clock skew between hosts rather than as a code defect, because that is what it is, and a tolerance is accepted for callers who know their fleet."
      ],
      "limitations": [
        "The spans supplied. A span dropped by sampling or still in flight is not here, so a missing parent may exist upstream; the finding says it is not in the data supplied rather than that it does not exis...",
        "intact is true only when every trace formed one tree, every parent resolved, and every time was coherent. Not a performance assessment."
      ],
      "observed_at": "2026-10-02T00:00:00.000Z",
      "trace_count": 2,
      "not_examined": [],
      "finding_count": 3,
      "service_version": "1.0.0",
      "findings_by_code": {
        "PARENT_SPAN_NOT_IN_TRACE": 1,
        "TIMESTAMP_WITHOUT_OFFSET": 1,
        "CHILD_STARTS_BEFORE_PARENT": 1
      },
      "clock_skew_tolerance_ms": 0
    }
  }
}