OOMKilled (exit code 137): containerul e omorât pentru că depășește memoria
Containerul a depășit limita de memorie, iar kernelul l-a oprit cu SIGKILL (137 = 128 + 9), fără ca aplicația să poată termina cererile în curs. Măsoară consumul real, lasă loc pentru memoria din afara heap-ului (`-XX:MaxRAMPercentage=75`), repară scurgerile și ajustează limita după date, nu după ghicit.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În Kubernetes (OOMKilled în kubectl describe pod, Last State: Terminated, Reason: OOMKilled, Exit Code: 137) sau Docker, limita de memorie e impusă de kernel. La depășire, procesul nu primește o excepție prietenoasă: e omorât instant. Cererile în curs se pierd (clienții văd 502 sau resetări), iar pod-ul repornește, uneori în buclă (CrashLoopBackOff).
Cauze tipice: limita setată egal cu heap-ul (la Java, memoria totală e heap + metaspace + stive de thread-uri + buffere directe); încărcarea unor fișiere sau rezultate mari complet în memorie; cache-uri locale fără limită; scurgeri de memorie care cresc încet până la limită; mai multe procese (workeri) în același container.
Diagnostic: graficul memoriei containerului în timp. Dacă crește în trepte cu traficul, limita e mică; dacă urcă continuu și repornirea o resetează, e o scurgere.
De ce apare: cauzele frecvente
1Heap egal cu limita containerului
resources:
limits: { memory: 512Mi }
env:
- { name: JAVA_OPTS, value: "-Xmx512m" }resources:
requests: { memory: 768Mi }
limits: { memory: 768Mi }
env:
- { name: JAVA_OPTS, value: "-XX:MaxRAMPercentage=75" }Heap-ul ocupă 75% din limită, iar restul rămâne pentru memoria din afara lui.
2Fișier încărcat complet în memorie
const continut = fs.readFileSync("export-2gb.csv");fs.createReadStream("export-2gb.csv").pipe(transformare).pipe(raspuns);Stream-ul procesează fișierul pe bucăți, cu memorie constantă.
Repară eroarea, direct în pagină
Răspunde la cele trei întrebări despre pod-urile repornite cu OOMKilled.
Indiciu
Heap-ul nu e toată memoria procesului.
Reparația
- q1: Containerul a depășit limita de memorie și a fost omorât.
- q2: Memoria totală a JVM-ului depășește heap-ul.
- q3: Fals.
De ce merge
Kernelul omoară containerul la limita de memorie. Lasă loc pentru memoria din afara heap-ului și repară scurgerile; limita se ajustează după consumul măsurat.
Alte forme ale mesajului
Last State: Terminated, Reason: OOMKilled, Exit Code: 137Memory cgroup out of memory: Killed processjava.lang.OutOfMemoryError: Java heap space
Cum o eviți pe viitor
- Monitorizează memoria containerelor și alertează înainte de limită.
- La Java, folosește
MaxRAMPercentageîn loc de-Xmxegal cu limita. - Procesează datele mari în stream-uri.
- Pune limite pe cache-urile locale.
- Investighează creșterile continue (heap dump, profiler).
Întrebări frecvente
Care e diferența față de OutOfMemoryError?
OutOfMemoryError vine din JVM, când heap-ul e plin, iar aplicația încă rulează. OOMKilled vine din kernel, când tot procesul depășește limita containerului, și oprește procesul instant.
requests sau limits?
requests e cât rezervă scheduler-ul, limits e plafonul. Pentru memorie, de obicei se pun egale, ca pod-ul să nu fie omorât când nodul are presiune de memorie.
Erori înrudite
Server supraîncărcat: CPU 100% chiar pe cea mai mare mașină Ai mărit serverul de câteva ori (mai multe nuclee, mai multă memorie), dar traficul tot îl duce la 100% CPU, iar cererile încep să dureze secunde. Scalarea verticală are o limită și un preț care crește repede; treci la scalare orizontală: mai multe instanțe identice în spatele unui load balancer. Error: EMFILE: too many open files (serverul refuză conexiuni noi) Procesul a atins limita de descriptori de fișier, iar pe Linux fiecare socket (conexiune de la clienți, conexiune la bază sau la un API) consumă unul. Cauzele sunt fie o scurgere (conexiuni sau fișiere neînchise), fie o limită prea mică pentru numărul real de conexiuni. Repară scurgerea și reutilizează conexiunile, apoi ajustează `nofile` dacă e nevoie. OOM command not allowed when used memory > 'maxmemory'. Redis a ajuns la limita `maxmemory` și, cu politica de evacuare curentă (`noeviction` sau `volatile-*` fără chei cu TTL), nu poate elibera loc, așa că refuză scrierile. Pentru un cache, alege o politică precum `allkeys-lru`, pune TTL pe chei și dimensionează memoria după calcul. Învață System Design de la zero, cu exerciții la fiecare lecție
Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
