1. Significado
No Linux, arquivos, sockets e pipes usam descritores de arquivo. Cada processo tem um limite (nofile), que muitas distribuições deixam em 1024 por padrão. Servidores com muitas conexões simultâneas chegam nele rápido e passam a falhar com EMFILE: too many open files (Node), OSError: [Errno 24] (Python) ou mensagens parecidas em Nginx e bancos.
2. Ver o limite e o uso atual
ulimit -n # limite da sessão atual
cat /proc/PID/limits | grep "open files" # limite de um processo em execução
ls /proc/PID/fd | wc -l # quantos descritores ele usa agora
sudo lsof -p PID | wc -l
Veja detalhes em lsof.
3. Aumentar o limite
Serviço no systemd (o jeito certo para serviços):
sudo systemctl edit minha-api
# adicione:
[Service]
LimitNOFILE=65535
sudo systemctl restart minha-api
Sessões de usuário (login shell), em /etc/security/limits.conf:
ana soft nofile 65535
ana hard nofile 65535
Em contêineres Docker: docker run --ulimit nofile=65535:65535 .... Para Nginx, ajuste também worker_rlimit_nofile e worker_connections.
4. Aumentar não resolve vazamento
Se o número de descritores só cresce ao longo do tempo, há vazamento: arquivos ou conexões não fechados. Compare ls /proc/PID/fd | wc -l em momentos diferentes e use lsof para ver o tipo (sockets em CLOSE_WAIT, arquivos de log, pipes).
- Feche arquivos com
with open(...)(Python) oudefer f.Close()(Go). - Reutilize conexões HTTP/banco com pool em vez de abrir uma por requisição.
- Em Node, verifique streams não encerrados e watchers (vários
fs.watchem muitos arquivos).
ulimit -n) e exclua node_modules do monitoramento.Continue explorando
← erros · lsof · ss · systemctl · OOM killer
Veja também o hub de conteúdo, o glossário e os cursos gratuitos.