eduardweb.
PM2 & NodeIntermediar#devops#pm2#backend#node-js

Cum configurezi PM2 ca să nu te trezească alertele noaptea: cluster, OOM și zero-downtime

De Ioana Marinescu, 25 oct. 2026 · 26 vizualizări · 2 like-uri

Postat 25 oct. 2026
javascript
module.exports = {
  apps: [{
    name: 'api-service',
    script: './dist/server.js',
    instances: 2,
    exec_mode: 'cluster',
    max_memory_restart: '1200M',
    wait_ready: true,
    listen_timeout: 10000,
    kill_timeout: 5000,
    env_production: {
      NODE_ENV: 'production',
      PORT: 3000
    }
  }]
};

Dacă încă rulezi pm2 start index.js pe serverele de producție, trăiești periculos. Un fișier ecosystem.config.js bine pus la punct face diferența între un deploy la prânz fără emoții și 502-uri aruncate în neant când procesul Node.js crapă silențios.

Am văzut prea multe echipe care folosesc PM2 doar pe post de demonizator simplu. Pierd 80% din beneficii.

Cluster mode: nu pune orbește instances: 'max'

Setarea instances: 'max' arată tentant în documentație. PM2 detectează numărul de nuclee și spawnează un worker pe fiecare. Pe o mașină cu 16 nuclee, ai 16 procese.

Dar am pățit-o urât la un magazin online cu vreo 4.000 de cereri pe minut. Fiecare worker deschidea un pool de conexiuni către PostgreSQL (20 per instanță). 16 x 20 = 320 conexiuni directe. Baza de date a intrat în genunchi înainte ca procesorul să atingă 30% load.

Regula mea de bun-simț: dacă mașina împarte resursele cu o bază de date locală sau un Redis, folosește instances: -1 sau setează un număr fix, gen 2-4 workeri. Node.js e single-threaded pe event loop, dar garbage collector-ul și I/O-ul din libuv trag oricum de restul nucleelor.

Graceful reload și capcana SIGINT

Comanda pm2 reload repornește procesele pe rând (rolling restart), fără downtime teoretic. Problema apare când aplicația ta taie tranzacții active în secundă doi.

Ca să funcționeze cu adevărat fără erori 502 în Nginx, trebuie să combini trei lucruri:

  1. wait_ready: true în config, ca PM2 să aștepte un semnal explicit de la app (process.send('ready')) înainte să considere noul worker sănătos.
  2. listen_timeout: 8000 pentru timpul alocat pornirii.
  3. kill_timeout: 5000 ca să lași conexiunile HTTP în zbor să se termine după ce procesul primește SIGINT.

Dacă serverul tău Express sau Fastify nu ascultă de process.on('SIGINT') ca să închidă serverul HTTP și conexiunile la DB, reload-ul va omorî forțat request-urile utilizatorilor.

Memory Leaks și rotația de loguri

Orice aplicație Node.js de dimensiuni medii are, la un moment dat, o scăpare de memorie. Un closure uitat, un cache în memorie fără TTL sau o librărie scrisă prost.

În loc să aștepți ca Linux Kernel să execute OOM Killer și să-ți culce întreg VPS-ul, setează max_memory_restart: '1G' (sau 70-80% din memoria pe care o aloci per proces). PM2 va restarta workerul respectiv automat, iar ceilalți din cluster preiau traficul fără întrerupere.

Pentru fișierele de log, instalează obligatoriu modulul pm2-logrotate. Fără el, ~/.pm2/logs/ o să ajungă la 80GB în câteva luni și o să-ți umple discul când ești în concediu.

Unde merită și unde e complet inutil

Trade-off-ul e direct: PM2 e genial dacă ții aplicația pe bare-metal, un VPS Hetzner sau DigitalOcean, fără o infrastructură complicată. Îți dă 90% din avantajele Kubernetes fără durerile de cap aferente.

Dacă ești deja pe Kubernetes, Docker Swarm sau AWS ECS, nu folosi PM2 în cluster mode în interiorul containerului. Acolo vrei un singur proces Node per container (node dist/index.js), iar de scalare și health checks trebuie să se ocupe orchestratorul.

Voi cum gestionați connection pool-urile de DB când rulați Node în cluster mode?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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