Files

T

DongHyeonkaandClaude Opus 5 75bed382c8 docs(keycloak-session-store): remake all 28 diagrams through the techviz pipeline

The originating repository's SVGs were drawn by hand and every one of them
put a title, a subtitle and an explanation band inside the canvas. This
repository forbids both, so they could not be carried over — the whole set
was rebuilt through the skill's pipeline instead.

Each diagram went through prepare, references, prompt, a VizSpec 1.1 citing
document line ranges, lint, and render. All 28 pass lint and produce the
same eight formats the existing keycloak project has. Sentences moved out of
the canvas into <desc> and the paragraph beside each figure; the drawings
carry names only.

Two lint rules did real work rather than formatting work:

  edge-through-node                  caught arrows crossing an unrelated
                                     node and implying an adjacency that
                                     does not exist — four diagrams had to
                                     be restructured, not just relaid out
  evidence-outside-prepared-context  caught a diagram citing another
                                     section; its anchor moved from B-0 to
                                     B-1 so all three sections it draws on
                                     are inside the prepared context

lab-topology also had to change profile: its context offers a different
candidate set, and query-fanout with shard roles is what the section
actually shows — one entry point spreading to two Keycloak nodes.

The document now carries all 28 inline, one per claim that needed one, and
the section recording what was still missing is updated: the diagram gap is
closed, Studio records remain.

verify-pipeline.py passes. audit-records.py reports no issues.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-05 11:03:10 +09:00

1.5 KiB

Raw Blame History

지연이 곱해지는 두 단계

Alternative text

네트워크 지연이 왕복 횟수만큼 누적되고 커넥션 풀 대기에서 다시 증폭되며 마지막에 readiness 실패로 이어지는 구성.

Long description

주입한 지연은 200ms 인데 로그인 응답이 1,872ms 가 됐다. 로그인 한 번이 데이터베이스 왕복을 여러 번 하므로 왕복 횟수만큼 더해진다. 동시 20건에서는 22.2초가 됐다. 요청이 커넥션을 오래 붙들어 뒤의 요청이 풀에서 대기하기 때문이며 커넥션 획득 대기 최대가 20,000ms 였다. 마지막으로 readiness 프로브가 타임아웃으로 실패해 느린 노드가 로드밸런서에서 빠진다. 느림이 장애로 승격된다.

Elements and evidence

주입한 지연 (process): tc netem 으로 넣는다. Evidence: L253–L258.
왕복 횟수만큼 누적 (process): 로그인 한 번이 DB 를 여러 번 왕복한다. Evidence: L259–L263.
커넥션 풀 대기 (component): 앞 요청이 커넥션을 붙들어 뒤가 밀린다. Evidence: L264–L268.
readiness 실패 (process): 느린 노드가 로드밸런서에서 빠진다. Evidence: L269–L273.

Relationships

주입한 지연 → 왕복 횟수만큼 누적: 왕복마다 더해진다. Evidence: L253–L263.
커넥션 풀 대기 → readiness 실패: 프로브도 타임아웃. Evidence: L264–L273.
왕복 횟수만큼 누적 → 커넥션 풀 대기: 커넥션 점유가 길어진다. Evidence: L259–L268.

1.5 KiB Raw Blame History Unescape Escape