Files
DongHyeonkaandClaude Opus 5 95c0e680b5 docs(keycloak-session-store): take the sentences out of the diagram canvases
The skill says drawings carry names and sentences go in <desc> and the
paragraph beside the figure. I put sentences in node details and edge labels
instead, and 27 of the 28 diagrams shipped with prose inside the canvas —
"예측 다섯 개가 틀렸다", "아홉 번 조용히 실패했다", "막혀서 닿지 않는다".

Only label and details render on the canvas; description does not. So every
sentence moved to a noun phrase and the meaning stays in description, which
was already carrying it.

  막혀서 닿지 않는다              -> 차단
  아홉 번 조용히 실패했다         -> 조용한 실패 9건
  예측 다섯 개가 틀렸다           -> 틀린 예측 5건
  로그아웃이 정리하지 않는다      -> 로그아웃 미정리
  볼륨이 없으면 여기까지다        -> 볼륨 없음

Three node labels were sentences too and became names: 세션 스냅샷, 예측
선기록, 대조군 확보.

What stays is what the rules protect — identifiers, commands and measured
values: PRIMARY KEY (client_registration_id, principal_name),
ValidationFailedException: 1 changesets check sum, nginx -t && nginx -s
reload, SET LOCAL synchronous_commit TO OFF. Those are names of things, not
prose about them.

294 canvas strings across 28 diagrams, none matching a sentence ending,
average 11 characters. All 28 still lint clean and re-rendered.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 11:50:33 +09:00

1.5 KiB
Raw Permalink Blame History

지연이 곱해지는 두 단계

Alternative text

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

Long description

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

Elements and evidence

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

Relationships

  • 주입한 지연 → 왕복 횟수만큼 누적: 왕복당 누적. Evidence: L253L263.
  • 커넥션 풀 대기 → readiness 실패: 프로브도 타임아웃. Evidence: L264L273.
  • 왕복 횟수만큼 누적 → 커넥션 풀 대기: 커넥션 점유. Evidence: L259L268.