1. O que acontece
Quando a memória (RAM + swap) acaba, o kernel Linux aciona o OOM killer (out of memory) e encerra um processo para recuperar espaço. A aplicação simplesmente desaparece, muitas vezes sem mensagem de erro própria. Em Docker, aparece como contêiner finalizado com código 137 (SIGKILL).
2. Confirmar nos logs
sudo journalctl -k | grep -i -E "out of memory|oom"
sudo dmesg -T | grep -i -E "killed process|out of memory"
# Contêiner
docker inspect --format '{{.State.OOMKilled}}' nome-do-conteiner
Uma linha como Out of memory: Killed process 2314 (node) confirma. O log também lista o uso de memória dos processos no momento.
3. Descobrir quem consome
ps aux --sort=-%mem | head
free -h
top -o %MEM
Veja ps e top. Observe o valor available em free -h, e se o uso cresce continuamente (vazamento de memória) ou só em picos.
4. Opções de correção
- Reduzir o consumo: corrigir vazamentos, limitar o cache, diminuir o número de workers, paginar consultas grandes.
- Aumentar a memória da máquina ou do contêiner (
docker run -m 1g, limites no Kubernetes). - Adicionar swap como colchão de segurança em servidores pequenos (não substitui RAM; swap em disco é lento).
- Limitar a aplicação: no systemd,
MemoryMax=faz o limite valer por serviço e protege o restante do sistema. - Ajustar prioridade com
oom_score_adjpara proteger serviços críticos (banco) — com cuidado para não empurrar a morte para outro processo essencial.
5. No Node, Java e Python
Runtimes têm limites próprios: --max-old-space-size no Node, -Xmx no Java. Defina-os abaixo do limite do contêiner para evitar que o kernel mate o processo antes do runtime tratar o erro.
Continue explorando
← erros · ps · top · docker · Disco cheio no Linux
Veja também o hub de conteúdo, o glossário e os cursos gratuitos.