cylinderhost®
VPS

PM2 na VPS: processos, logs e reinício da aplicação

Comandos para acompanhar aplicações Node.js e investigar reinícios sem confundir processo online com aplicação saudável.

O PM2 gerencia processos, permite consultar logs e ajuda a manter uma aplicação em execução. Ainda assim, ver o estado “online” não garante que o site esteja respondendo corretamente.

Use o usuário correto

Execute os comandos com o usuário responsável pela aplicação. O PM2 pode ter diretórios de estado diferentes conforme o usuário e a variável PM2_HOME. Uma sessão como root pode mostrar uma lista diferente daquela usada para iniciar o projeto.

Inicie e acompanhe o processo

Com Node.js e PM2 instalados, entre na pasta do projeto e escolha um nome fácil de reconhecer. Ajuste o arquivo de entrada ao seu código:

pm2 start server.js --name minha-api
pm2 status
pm2 logs minha-api --lines 100
pm2 restart minha-api

Se a aplicação precisa de um build, conclua essa etapa antes de iniciar a versão de produção. Evite iniciar o mesmo serviço em dois gerenciadores ao mesmo tempo: isso pode causar conflito de porta.

Prepare a volta após um reboot

pm2 startup
pm2 save

O primeiro comando mostra instruções para configurar o início automático no sistema. Execute a instrução gerada para o usuário correto e salve a lista desejada. Fechar o terminal não configura, por si só, a recuperação após uma reinicialização da VPS.

Investigue por que reinicia

Se o contador de reinícios aumenta, consulte os logs e confira memória, disco, porta ocupada e dependências externas. Verifique o código de saída. Reiniciar repetidamente pode esconder o sintoma sem resolver a causa.

Teste uma rota HTTP e a conexão com o banco. Um processo pode continuar em execução e devolver erros em todas as requisições. Um erro 502 também pode estar no caminho entre o proxy e a aplicação; a mensagem sozinha não identifica qual componente falhou.

Respeite o fluxo do ambiente

Os comandos deste artigo são para uma VPS em que você administra o PM2 diretamente. Em um ambiente gerenciado pelo painel, siga os controles da plataforma. Consulte a documentação da CylinderHost e os logs para identificar o fluxo do seu projeto.

Referência: guia oficial de início do PM2.