eduardweb.
PM2 & NodeIntermediar#nodejs#devops#pm2#backend

Cum configurez PM2 în producție: cluster mode, OOM și reload fără 502-uri

De Vlad Stancu, 2 nov. 2026 · 19 vizualizări · 3 like-uri

Postat 2 nov. 2026
javascript
module.exports = {
  apps: [{
    name: 'api-core',
    script: './dist/server.js',
    instances: 4,
    exec_mode: 'cluster',
    max_memory_restart: '850M',
    wait_ready: true,
    listen_timeout: 6000,
    kill_timeout: 5000,
    exp_backoff_restart_delay: 100,
    env_production: {
      NODE_ENV: 'production',
      PORT: 3000
    }
  }]
};

Când aud oameni rulând pm2 start index.js -i max direct din terminal pe serverul de producție, mă trece o ușoară transpirație. Fără un fișier ecosystem.config.js salvat în git, pierzi fix avantajele pentru care ai ales PM2 în loc de un simplu serviciu de systemd: graceful reload real, gestiunea memoriei și prevenirea restart loop-urilor.

Am pățit-o acum trei ani pe un API de plăți cu vreo 15k utilizatori activi zilnic. Dădeam pm2 reload all la fiecare release și tot primeam alerte de 502 Bad Gateway pe Sentry timp de 2-3 secunde. În plus, o librărie de generare de PDF-uri avea un memory leak subtil, iar când procesul Node depășea RAM-ul mașinii, Linux OOM killer curăța procesul părinte PM2 cu totul, nu doar worker-ul vinovat.

Cluster mode și capcana cu instances: 'max'

Prima greșeală pe care o văd des e setarea instances: 'max' pe servere mari. Dacă ai un dedicat cu 32 de core-uri și pui 'max', PM2 îți ridică 32 de procese Node.js independente. Sună spectaculos, până realizezi că fiecare worker deschide un pool de conexiuni către PostgreSQL (să zicem 10 conexiuni per instanță), iar baza de date se trezește instant cu 320 de conexiuni doar de la un singur nod.

În practică, setez mereu un număr fix de instanțe, de obicei core-uri fizice minus 1, lăsând un nucleu liber pentru sistemul de operare și logare. Dacă mașina are 8 vCPU-uri, pun instances: 4 sau 6.

Graceful reload fără 502 la deploy

Ca să ai zero downtime la reload, nu e destul să scrii pm2 reload. Comanda trimite semnalul SIGINT, dar dacă aplicația ta nu ascultă după el sau dacă PM2 nu știe când serverul nou a terminat faza de bootstrap (conexiune la Redis, populat cache-uri locale), o să ruteze trafic către un port încă închis.

Soluția e formată din două setări cheie în config:

  1. wait_ready: true: îi spune lui PM2 să nu trimită trafic către noul proces până când aplicația nu rulează explicit process.send('ready') în cod, după ce app.listen() a confirmat bind-ul pe port.
  2. kill_timeout: 5000: îi dă worker-ului vechi 5 secunde să-și termine request-urile HTTP aflate în zbor înainte să primească un brutal SIGKILL.

Limitarea memoriei: max_memory_restart

Node.js e faimos pentru Garbage Collector-ul care amână curățarea până când memoria atinge limita V8. În producție, pe containere sau VPS-uri mici, vrei ca worker-ul să se reseteze singur ÎNAINTE să intervină kernelul Linux.

Prin max_memory_restart: '850M', PM2 monitorizează RSS-ul fiecărui proces. Dacă un worker depășește pragul, PM2 îl omoară și pornește altul în mod controlat, unul câte unul, fără să întrerupă serviciul.

Aici există însă un trade-off sincer: setarea asta este o plasă de siguranță, nu o soluție de arhitectură. E excelentă ca să dormi liniștit noaptea fără apeluri de on-call, dar dacă procesele tale se restartează de 20 de ori pe zi din cauza asta, doar ascunzi sub preș un leak pe care trebuie să-l inspectezi cu un heapdump.

Rotația logurilor

Nu uitați de plugin-ul pm2-logrotate. PM2 scrie implicit logurile în ~/.pm2/logs fără nicio limită. Am curățat acum câteva luni un disk plin de 80GB pe un nod uitat, unde fișierul out.log ajunsese la 54GB pentru că un junior lăsase un console.log(req) pe fiecare hit.

Instalați-l direct pe server cu pm2 install pm2-logrotate și setați max_size 100M și retain 10.

Voi cum gestionați drain-ul de conexiuni la deploy-uri pe Node: vă bazați pe PM2 sau ați mutat totul în Kubernetes cu rollouts controlate?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.