refactor: 문서 개선 중
This commit is contained in:
donghyeon-ka
+7
-7
@@ -10,13 +10,13 @@
|
||||
|
||||
## Elements and evidence
|
||||
|
||||
- **Keycloak 클러스터** (service): 측정 대상. Evidence: L141–L146.
|
||||
- **외부 curl** (process): 사용자가 겪는 것. Evidence: L143–L147.
|
||||
- **Prometheus 지표** (process): 클러스터 내부 상태. Evidence: L143–L147.
|
||||
- **PostgreSQL 직접 조회** (process): 실제로 무엇이 저장됐는가. Evidence: L143–L147.
|
||||
- **Keycloak 클러스터** (service): 측정 대상. Evidence: L330–L332.
|
||||
- **외부 curl** (process): 사용자가 겪는 것. Evidence: L331–L333.
|
||||
- **Prometheus 지표** (process): 클러스터 내부 상태. Evidence: L331–L333.
|
||||
- **PostgreSQL 직접 조회** (process): 실제로 무엇이 저장됐는가. Evidence: L331–L333.
|
||||
|
||||
## Relationships
|
||||
|
||||
- **Keycloak 클러스터 → 외부 curl:** 외부 응답. Evidence: L143–L147.
|
||||
- **Keycloak 클러스터 → PostgreSQL 직접 조회:** 저장 결과. Evidence: L143–L147.
|
||||
- **Keycloak 클러스터 → Prometheus 지표:** 내부 지표. Evidence: L143–L147.
|
||||
- **Keycloak 클러스터 → 외부 curl:** 외부 응답. Evidence: L331–L333.
|
||||
- **Keycloak 클러스터 → PostgreSQL 직접 조회:** 저장 결과. Evidence: L331–L333.
|
||||
- **Keycloak 클러스터 → Prometheus 지표:** 내부 지표. Evidence: L331–L333.
|
||||
|
||||
+4
-4
@@ -5,16 +5,16 @@
|
||||
<root>
|
||||
<mxCell id="0"/>
|
||||
<mxCell id="1" parent="0"/>
|
||||
<mxCell id="n_system" value="Keycloak 클러스터<br/>두 노드" tooltip="측정 대상. | Evidence: L141-L146" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
||||
<mxCell id="n_system" value="Keycloak 클러스터<br/>두 노드" tooltip="측정 대상. | Evidence: L330-L332" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
||||
<mxGeometry x="70.0" y="203.0" width="150.0" height="71.0" as="geometry"/>
|
||||
</mxCell>
|
||||
<mxCell id="n_curl" value="외부 curl<br/>분단 시에도 200" tooltip="사용자가 겪는 것. | Evidence: L143-L147" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
|
||||
<mxCell id="n_curl" value="외부 curl<br/>분단 시에도 200" tooltip="사용자가 겪는 것. | Evidence: L331-L333" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
|
||||
<mxGeometry x="427.0" y="60.0" width="150.0" height="71.0" as="geometry"/>
|
||||
</mxCell>
|
||||
<mxCell id="n_prom" value="Prometheus 지표<br/>vendor_cluster_size · agroal_*" tooltip="클러스터 내부 상태. | Evidence: L143-L147" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
||||
<mxCell id="n_prom" value="Prometheus 지표<br/>vendor_cluster_size · agroal_*" tooltip="클러스터 내부 상태. | Evidence: L331-L333" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
||||
<mxGeometry x="380.0" y="203.0" width="244.0" height="71.0" as="geometry"/>
|
||||
</mxCell>
|
||||
<mxCell id="n_psql" value="PostgreSQL 직접 조회<br/>OFFLINE_USER_SESSION" tooltip="실제로 무엇이 저장됐는가. | Evidence: L143-L147" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
||||
<mxCell id="n_psql" value="PostgreSQL 직접 조회<br/>OFFLINE_USER_SESSION" tooltip="실제로 무엇이 저장됐는가. | Evidence: L331-L333" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
||||
<mxGeometry x="415.0" y="346.0" width="174.0" height="71.0" as="geometry"/>
|
||||
</mxCell>
|
||||
<mxCell id="e_s-c" value="외부 응답" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_system" target="n_curl">
|
||||
|
||||
+3
-3
@@ -2,14 +2,14 @@
|
||||
"harness_version": "0.2.0",
|
||||
"spec_id": "observation-points",
|
||||
"spec_version": "1.1",
|
||||
"spec_sha256": "17709b275fbf9b82484b8ca7c509a805f74d7e90019b5e6b42e5fb0e17578325",
|
||||
"spec_sha256": "e427e786f48db0ff6c2a546d5b025af4a889f3beb6f280e41f93a9a856ec1d2c",
|
||||
"source_context": {
|
||||
"document": "docs/keycloak-session-store/final/document.md",
|
||||
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
|
||||
"document_sha256": "28aef96a2bbb94fbb10ade26a71238fee62a5a4d9fa6e7749ae98cfd0a65e560",
|
||||
"anchor": {
|
||||
"kind": "heading",
|
||||
"value": "관측을 어디에 둘 것인가",
|
||||
"line": 140
|
||||
"line": 328
|
||||
}
|
||||
},
|
||||
"outputs": [
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="462" viewBox="0 0 680 462" role="img" aria-labelledby="diagram-title diagram-description">
|
||||
<title id="diagram-title">관측을 어디에 둘 것인가</title>
|
||||
<desc id="diagram-description">처음에는 외부 curl 로만 쟀다. A-1 에서 7800 을 끊었는데 외부 응답이 전부 200 이었다. 장애가 없어서가 아니라 분단된 노드가 readiness 실패로 스스로 로드밸런서에서 빠졌기 때문이다. 그래서 관측 지점을 셋으로 늘렸다. up 지표도 신뢰할 수 없었다 — A-2 에서 503 이 나는 동안에도 1이었다. 프로세스가 살아 있고 metrics 가 응답하면 up 은 1이며 살아 있지만 쓸모없는 상태를 못 본다.</desc>
|
||||
<metadata>{"techviz":{"spec_version":"1.1","id":"observation-points","profile":"component-flow"},"source_context":{"document":"docs/keycloak-session-store/final/document.md","document_sha256":"1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe","anchor":{"kind":"heading","value":"관측을 어디에 둘 것인가","line":140}},"evidence_policy":"Each factual element cites source lines or is marked assumption.","diagram_only":true}</metadata>
|
||||
<metadata>{"techviz":{"spec_version":"1.1","id":"observation-points","profile":"component-flow"},"source_context":{"document":"docs/keycloak-session-store/final/document.md","document_sha256":"28aef96a2bbb94fbb10ade26a71238fee62a5a4d9fa6e7749ae98cfd0a65e560","anchor":{"kind":"heading","value":"관측을 어디에 둘 것인가","line":328}},"evidence_policy":"Each factual element cites source lines or is marked assumption.","diagram_only":true}</metadata>
|
||||
<defs>
|
||||
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
|
||||
<path d="M 0 0 L 10 5 L 0 10 z" />
|
||||
@@ -50,35 +50,35 @@
|
||||
</style>
|
||||
</defs>
|
||||
<rect class="canvas" width="680" height="462" />
|
||||
<polyline class="edge kind-read style-solid emphasis-normal" points="220.0,220.5 323.5,220.5 323.5,95.5 427.0,95.5" data-evidence="143-147" />
|
||||
<polyline class="edge kind-read style-solid emphasis-normal" points="220.0,220.5 323.5,220.5 323.5,95.5 427.0,95.5" data-evidence="331-333" />
|
||||
<rect class="edge-label-bg" x="321.8" y="144.0" width="51.5" height="22" rx="3" />
|
||||
<text class="edge-label" x="347.5" y="159.0">외부 응답</text>
|
||||
<polyline class="edge kind-read style-solid emphasis-normal" points="220.0,256.5 317.5,256.5 317.5,381.5 415.0,381.5" data-evidence="143-147" />
|
||||
<polyline class="edge kind-read style-solid emphasis-normal" points="220.0,256.5 317.5,256.5 317.5,381.5 415.0,381.5" data-evidence="331-333" />
|
||||
<rect class="edge-label-bg" x="315.8" y="305.0" width="51.5" height="22" rx="3" />
|
||||
<text class="edge-label" x="341.5" y="320.0">저장 결과</text>
|
||||
<polyline class="edge kind-read style-solid emphasis-normal" points="220.0,238.5 300.0,238.5 300.0,238.5 380.0,238.5" data-evidence="143-147" />
|
||||
<polyline class="edge kind-read style-solid emphasis-normal" points="220.0,238.5 300.0,238.5 300.0,238.5 380.0,238.5" data-evidence="331-333" />
|
||||
<rect class="edge-label-bg" x="274.2" y="196.5" width="51.5" height="22" rx="3" />
|
||||
<text class="edge-label" x="300.0" y="211.5">내부 지표</text>
|
||||
<g id="node-system">
|
||||
<rect class="node-shape kind-service emphasis-primary role-source" data-evidence="141-146" x="70.0" y="203.0" width="150.0" height="71.0" rx="7" />
|
||||
<rect class="node-shape kind-service emphasis-primary role-source" data-evidence="330-332" x="70.0" y="203.0" width="150.0" height="71.0" rx="7" />
|
||||
<text class="node-label" x="145.0" y="230.0">Keycloak 클러스터</text>
|
||||
<line class="node-detail-divider" x1="84.0" y1="251.0" x2="206.0" y2="251.0" />
|
||||
<text class="node-detail" x="86.0" y="268.0">두 노드</text>
|
||||
</g>
|
||||
<g id="node-curl">
|
||||
<rect class="node-shape kind-process emphasis-normal role-target" data-evidence="143-147" x="427.0" y="60.0" width="150.0" height="71.0" rx="7" />
|
||||
<rect class="node-shape kind-process emphasis-normal role-target" data-evidence="331-333" x="427.0" y="60.0" width="150.0" height="71.0" rx="7" />
|
||||
<text class="node-label" x="502.0" y="87.0">외부 curl</text>
|
||||
<line class="node-detail-divider" x1="441.0" y1="108.0" x2="563.0" y2="108.0" />
|
||||
<text class="node-detail" x="443.0" y="125.0">분단 시에도 200</text>
|
||||
</g>
|
||||
<g id="node-prom">
|
||||
<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="143-147" x="380.0" y="203.0" width="244.0" height="71.0" rx="7" />
|
||||
<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="331-333" x="380.0" y="203.0" width="244.0" height="71.0" rx="7" />
|
||||
<text class="node-label" x="502.0" y="230.0">Prometheus 지표</text>
|
||||
<line class="node-detail-divider" x1="394.0" y1="251.0" x2="610.0" y2="251.0" />
|
||||
<text class="node-detail" x="396.0" y="268.0">vendor_cluster_size · agroal_*</text>
|
||||
</g>
|
||||
<g id="node-psql">
|
||||
<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="143-147" x="415.0" y="346.0" width="174.0" height="71.0" rx="7" />
|
||||
<rect class="node-shape kind-process emphasis-primary role-target" data-evidence="331-333" x="415.0" y="346.0" width="174.0" height="71.0" rx="7" />
|
||||
<text class="node-label" x="502.0" y="373.0">PostgreSQL 직접 조회</text>
|
||||
<line class="node-detail-divider" x1="429.0" y1="394.0" x2="575.0" y2="394.0" />
|
||||
<text class="node-detail" x="431.0" y="411.0">OFFLINE_USER_SESSION</text>
|
||||
|
||||
|
Before Width: | Height: | Size: 6.9 KiB After Width: | Height: | Size: 6.9 KiB |
Reference in New Issue
Block a user