Last State: Terminated, Reason: OOMKilled, Exit Code: 137
Containerul a depășit limita de memorie (resources.limits.memory), iar kernel-ul l-a oprit forțat. Mărește limita la un nivel realist pentru aplicație sau reduce consumul de memorie; codul 137 înseamnă oprire cu SIGKILL.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Limita de memorie a unui container e aplicată de kernel-ul nodului prin cgroups. Când procesul încearcă să folosească mai mult, kernel-ul îl omoară imediat cu SIGKILL, fără avertisment. Kubernetes raportează Reason: OOMKilled și Exit Code: 137 (128 + 9, numărul semnalului) în secțiunea Last State din kubectl describe pod, apoi repornește containerul, de obicei până la CrashLoopBackOff.
Jurnalul se oprește brusc, de multe ori fără nicio eroare a aplicației. De aceea motivul se caută în describe, nu în logs.
Două situații diferite: limita e prea mică pentru ce face aplicația (cade imediat, la fiecare pornire), sau aplicația are o scurgere de memorie (cade după ore sau zile). În primul caz mărești limita; în al doilea, o limită mai mare doar amână căderea.
De ce apare: cauzele frecvente
1Limită sub necesarul aplicației
resources:
limits:
memory: 200Mi # aplicația are nevoie de ~250Mi resources:
limits:
memory: 384MiLimita trebuie să acopere consumul normal plus o rezervă.
2Runtime care nu știe de limită
image: aplicatie-java
resources:
limits:
memory: 512Mi env:
- name: JAVA_TOOL_OPTIONS
value: "-XX:MaxRAMPercentage=75"Heap-ul crește peste limită dacă JVM-ul (sau Node, .NET) nu e configurat să o respecte.
3Cauți motivul în jurnal
kubectl logs incarcatorkubectl describe pod incarcator | grep -A3 'Last State'OOMKilled apare în starea containerului, nu în jurnalul aplicației.
Repară eroarea, direct în pagină
Serviciul de import al unui magazin de mobilă (import, imaginea academia/memorie:1.0, care încarcă aproximativ 250 MiB) repornește continuu. Găsește în starea containerului motivul și codul de ieșire, apoi ridică limita de memorie la 512Mi (requests rămân 128Mi).
Indiciu
kubectl describe pod → secțiunea Last State; kubectl set resources schimbă limita.
Reparația
Motivul și codul de ieșire:
kubectl get pods -l app=import
kubectl describe pod -l app=import | grep -A3 'Last State'NAME READY STATUS RESTARTS AGE
import-l5mf4c9w2p-vf4fm 0/1 CrashLoopBackOff 2 (19s ago) 43s
Last State: Terminated
Reason: OOMKilled
Exit Code: 137
Started: Thu, 15 Jan 2026 10:00:27 +0200Limita nouă:
kubectl set resources deployment import --limits=memory=512Mi
kubectl rollout status deployment/importdeployment.apps/import resource requirements updated
Waiting for deployment "import" rollout to finish: 1 old replicas are pending termination...
deployment "import" successfully rolled outDe ce merge
Kernel-ul a omorât procesul când a trecut de limita de 200Mi, iar Kubernetes raportează OOMKilled cu codul 137. Aplicația are nevoie constant de aproximativ 250 MiB, deci limita era prea mică de la început. Cu 512Mi, containerul încape cu o rezervă bună, iar requests de 128Mi păstrează programarea pe noduri neschimbată.
Alte forme ale mesajului
Reason: OOMKilledExit Code: 137Container incarcator was OOM killed
Cum o eviți pe viitor
- Măsoară consumul real cu
kubectl top podssub sarcină normală și pune limita cu o rezervă de 25-50%. - Configurează runtime-ul să respecte limita containerului (Java, Node, .NET).
- Pune alerte pe restarturi cu motiv OOMKilled.
- Nu scoate limita de tot: un container fără limită poate consuma memoria nodului și poate provoca evacuarea altor poduri.
Întrebări frecvente
137 înseamnă mereu lipsă de memorie?
Nu. 137 înseamnă doar SIGKILL. Dacă motivul e Error (nu OOMKilled), procesul a fost oprit forțat din alt motiv, de exemplu după o probă de liveness eșuată și perioada de grație depășită.
Requests contează la OOMKilled?
Nu direct. Doar limits declanșează OOMKilled. Requests contează la programare și la ce poduri sunt evacuate primele când nodul rămâne fără memorie.
Erori înrudite
Back-off restarting failed container api in pod api-6d8f7c9b5-x2kq9_default Containerul pornește și se oprește iar și iar, iar kubelet-ul așteaptă tot mai mult între reporniri (CrashLoopBackOff). Cauza e aproape mereu în jurnalul rulării care a căzut: kubectl logs POD --previous. Repară configurarea sau codul care face procesul să iasă. The Pod "api" is invalid: spec.containers[0].resources.requests: Invalid value: "512Mi": must be less than or equal to memory limit of 256Mi Containerul cere (requests) mai mult decât limita lui (limits) pentru aceeași resursă, ceea ce nu are sens. Fă requests mai mic sau egal cu limits, de exemplu requests 256Mi și limits 512Mi. 0/3 nodes are available: 2 Insufficient memory, 1 node(s) had untolerated taint {node-role.kubernetes.io/control-plane: }. preemption: 0/3 nodes are available: 1 Preemption is not helpful for scheduling, 2 No preemption victims found for incoming pod. Nodurile nu mai au destulă memorie nerezervată pentru requests.memory al podului. Fie podul cere mai mult decât încape pe un nod, fie replicile împreună au umplut nodurile. Coboară requests.memory la necesarul real sau redu numărul de replici. Învață Kubernetes de la zero, cu exerciții la fiecare lecție
Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.
