From 83e9bd3dc3a3e6ce0b9414f1a94bf2ed5a51cf97 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 18:30:03 +0900 Subject: [PATCH] =?UTF-8?q?docs(runbooks):=20JVM=20OOM=20runbook=EC=9D=98?= =?UTF-8?q?=20=EC=A2=85=EB=A3=8C=20=EC=BD=94=EB=93=9C=EB=A5=BC=20=EC=8B=A4?= =?UTF-8?q?=EC=A0=9C=20JVM=20=EB=8F=99=EC=9E=91=EC=97=90=20=EB=A7=9E?= =?UTF-8?q?=EC=B6=98=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit runtime-jvm-oom runbook이 「컨테이너가 코드 137로 끝난다 (-XX:+ExitOnOutOfMemoryError가 동작함)」고 적는다. 그 옵션으로 JVM이 스스로 끝나면 종료 코드는 3이고 stderr에 「Terminating due to java.lang.OutOfMemoryError: …」가 남는다. 137은 SIGKILL이다. 힙이 아니라 프로세스 전체 메모리가 컨테이너 한계를 넘어 커널이 죽인 경우이고, 원인과 볼 것이 다르다(번역 묶음 D2c가 확인 필요로 넘긴 것). 증상 절을 둘로 나눴다: 코드 3 + 그 stderr 줄은 이 runbook, 코드 137 + OOMKilled는 다른 일(힙과 네이티브 메모리의 합, MaxRAMPercentage가 남긴 몫, 힙 덤프 없음). 검증: desktop에서 이 저장소 이미지(caskeleton:0.0.1_local_0000000-default, 9ae52229)를 공유 잠금 아래 java -Xmx4m·-Xmx6m -XX:+ExitOnOutOfMemoryError -jar application.jar로 띄웠다. 둘 다 rc=3, stderr 「Terminating due to java.lang.OutOfMemoryError: Java heap space」. 노트북 check-docs.py OK. 한계: ContainerRuntimeOomContractTest Javadoc의 「exit 137」은 테스트 코드라 이 변경에서 고치지 않았다. --- docs/runbooks/runtime-jvm-oom.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/runbooks/runtime-jvm-oom.md b/docs/runbooks/runtime-jvm-oom.md index 0f3e3a63..b3666efb 100644 --- a/docs/runbooks/runtime-jvm-oom.md +++ b/docs/runbooks/runtime-jvm-oom.md @@ -12,9 +12,12 @@ status: 초안 ## 증상 -- 컨테이너가 코드 137로 끝난다(`-XX:+ExitOnOutOfMemoryError`가 동작함). -- 앱은 끝나기 전에 `error.code=JVM_OOM` 로그를 남기지 않는다. 이 코드를 로그에 쓰는 코드가 없다. JVM이 - stderr에 `OutOfMemoryError`를 남기고 바로 끝난다. +- 컨테이너가 코드 3으로 끝나고, stderr 마지막 줄이 `Terminating due to java.lang.OutOfMemoryError: <종류>`다 + (예: `Java heap space`). 이미지의 `JAVA_TOOL_OPTIONS`가 `-XX:+ExitOnOutOfMemoryError`를 켜기 때문이다(`src/Dockerfile`). +- 앱은 끝나기 전에 `error.code=JVM_OOM` 로그를 남기지 않는다. 이 코드를 로그에 쓰는 코드가 없다. +- 코드 137(SIGKILL)과 `OOMKilled: true`는 이 runbook의 일이 아니다. 프로세스 전체 메모리가 컨테이너 한계를 넘어 커널이 + 죽인 것이다. 힙과 그 밖의 네이티브 메모리(스레드 스택, 라이브러리의 네이티브 할당 등)를 합친 크기를 보고, + `-XX:MaxRAMPercentage`가 힙 밖에 남긴 몫이 모자라는지 본다. JVM이 손쓸 틈 없이 죽으므로 힙 덤프도 없다. ## 진단