document-haness/docs/keycloak-session-store/final/.techviz/a6-latency-multiplication/spec.json

{
  "version": "1.1",
  "id": "a6-latency-multiplication",
  "title": "지연이 곱해지는 두 단계",
  "question": "200밀리초가 어떻게 22초가 되는가",
  "type": "architecture",
  "direction": "TB",
  "audience": [
    "지연 예산을 세우는 백엔드 엔지니어"
  ],
  "summary": "왕복 횟수만큼 더해지고, 커넥션 풀에서 한 번 더 곱해진다. 그리고 느림이 장애로 승격된다.",
  "alt": "네트워크 지연이 왕복 횟수만큼 누적되고 커넥션 풀 대기에서 다시 증폭되며 마지막에 readiness 실패로 이어지는 구성.",
  "long_description": "주입한 지연은 200ms 인데 로그인 응답이 1,872ms 가 됐다. 로그인 한 번이 데이터베이스 왕복을 여러 번 하므로 왕복 횟수만큼 더해진다. 동시 20건에서는 22.2초가 됐다. 요청이 커넥션을 오래 붙들어 뒤의 요청이 풀에서 대기하기 때문이며 커넥션 획득 대기 최대가 20,000ms 였다. 마지막으로 readiness 프로브가 타임아웃으로 실패해 느린 노드가 로드밸런서에서 빠진다. 느림이 장애로 승격된다.",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
    "anchor": {
      "kind": "heading",
      "value": "A-6 · 지연 주입 — 200밀리초가 22초가 된다",
      "line": 255
    }
  },
  "composition": {
    "profile": "component-flow",
    "diagram_only": true,
    "reference_ids": [
      "payment-event-flow"
    ],
    "rationale": "한 값이 두 단계를 지나며 커지는 것이 지배적 질문이다. 증폭 경로이므로 component-flow 를 골랐다."
  },
  "groups": [],
  "nodes": [
    {
      "id": "inject",
      "label": "주입한 지연",
      "kind": "process",
      "role": "source",
      "emphasis": "warning",
      "description": "tc netem 으로 넣는다.",
      "details": [
        "200 ms"
      ],
      "evidence": [
        {
          "start_line": 253,
          "end_line": 258
        }
      ],
      "assumption": false
    },
    {
      "id": "roundtrips",
      "label": "왕복 횟수만큼 누적",
      "kind": "process",
      "role": "control",
      "emphasis": "normal",
      "description": "로그인 한 번이 DB 를 여러 번 왕복한다.",
      "details": [
        "66ms → 1,872ms"
      ],
      "evidence": [
        {
          "start_line": 259,
          "end_line": 263
        }
      ],
      "assumption": false
    },
    {
      "id": "pool",
      "label": "커넥션 풀 대기",
      "kind": "component",
      "role": "control",
      "emphasis": "warning",
      "description": "앞 요청이 커넥션을 붙들어 뒤가 밀린다.",
      "details": [
        "획득 대기 최대 20,000ms"
      ],
      "evidence": [
        {
          "start_line": 264,
          "end_line": 268
        }
      ],
      "assumption": false
    },
    {
      "id": "probe",
      "label": "readiness 실패",
      "kind": "process",
      "role": "target",
      "emphasis": "warning",
      "description": "느린 노드가 로드밸런서에서 빠진다.",
      "details": [
        "동시 20건 최대 22.2초"
      ],
      "evidence": [
        {
          "start_line": 269,
          "end_line": 273
        }
      ],
      "assumption": false
    }
  ],
  "edges": [
    {
      "id": "i-r",
      "from": "inject",
      "to": "roundtrips",
      "label": "왕복마다 더해진다",
      "kind": "request",
      "evidence": [
        {
          "start_line": 253,
          "end_line": 263
        }
      ],
      "assumption": false
    },
    {
      "id": "r-p",
      "from": "roundtrips",
      "to": "pool",
      "label": "커넥션 점유가 길어진다",
      "kind": "request",
      "evidence": [
        {
          "start_line": 259,
          "end_line": 268
        }
      ],
      "assumption": false
    },
    {
      "id": "p-pr",
      "from": "pool",
      "to": "probe",
      "label": "프로브도 타임아웃",
      "kind": "request",
      "evidence": [
        {
          "start_line": 264,
          "end_line": 273
        }
      ],
      "assumption": false
    }
  ],
  "legend": [],
  "metadata": {
    "rationale": "왕복 누적과 풀 경합을 분리해 그렸다. 두 단계를 하나로 보면 28배가 어디서 왔는지 설명되지 않는다."
  }
}