eduardweb.
DevOps & VPSIntermediar#nodejs#devops#pm2#backend#monitoring

Healthcheck care chiar funcționează pentru PM2: de ce statusul „online” minte

De Sorin Tudor, 1 nov. 2026 · 15 vizualizări · 2 like-uri

Postat 1 nov. 2026
javascript
// healthcheck.js - inclus ca middleware sau endpoint dedicat
import express from 'express';
import { pool } from './db.js';

export const healthRouter = express.Router();

healthRouter.get('/ready', async (req, res) => {
  const start = Date.now();
  try {
    // Timeout strict de 1.5s pentru a nu bloca Nginx/LB-ul
    const dbCheck = pool.query('SELECT 1');
    const timeout = new Promise((_, reject) => 
      setTimeout(() => reject(new Error('DB Timeout')), 1500)
    );
    
    await Promise.race([dbCheck, timeout]);
    
    return res.status(200).json({
      status: 'UP',
      latencyMs: Date.now() - start,
      uptime: process.uptime()
    });
  } catch (err) {
    // Returnăm 503 ca reverse proxy-ul să scoată instanța din rotație
    return res.status(503).json({
      status: 'DOWN',
      error: err.message,
      timestamp: new Date().toISOString()
    });
  }
});

Dacă te bazezi pe comanda pm2 status ca să știi dacă backend-ul tău e în viață, trăiești într-o iluzie periculoasă. PM2 se uită doar dacă procesul Node.js are un PID activ în sistemul de operare. Atât.

Am pățit-o acum vreo doi ani pe un cluster cu 4 instanțe de Node.js care deserveau în jur de 12.000 de cereri pe minut. Dashboard-ul PM2 arăta totul verde, memorie normală, CPU pe la 15%. În realitate, connection pool-ul de PostgreSQL era complet epuizat din cauza unui lock nesimțit pe un tabel, iar event loop-ul pe două worker-e era complet blocat. Pentru utilizatori, 50% din request-uri dădeau 504 Gateway Timeout din Nginx. PM2? „Online”, bine mersi.

Ce ratează PM2 când verifică procesul

Nodul poate fi viu pentru OS, dar complet mort pentru traficul real. Cazurile clasice pe care le văd constant pe producție:

  1. Event loop blocat: Un regex prost sau o procesare sincronă pe un JSON imens de 40MB blochează firul principal. Node nu mai răspunde la I/O, dar procesul rulează.
  2. Resurse externe crăpate: Conexiunea la Redis sau baza de date a picat, worker-ul nu mai poate servi nimic util, dar Nginx continuă să-i trimită request-uri.
  3. Memory leaks lente: În loc să crape cu OOM (unde PM2 ar da restart frumos), garbage collector-ul începe să consume 100% din thread încercând disperat să elibereze câțiva megabytes. Latența sare de la 40ms la 8 secunde.

Cum construiești un endpoint de probe util

Soluția nu e să pui un /health care returnează res.send({ status: 'ok' }). Endpoint-ul ăla verifică doar că router-ul din Express merge. Dacă baza de date e în flăcări, endpoint-ul ăla va returna tot 200.

Ai nevoie de două nivele distincte: liveness (procesul răspunde la HTTP?) și readiness (aplicația poate procesa comenzi reale?).

Pentru liveness, măsori event loop lag. Dacă lag-ul trece de 200-300ms, ceva e grav greșit și procesul trebuie rotit. Pentru readiness, faci un SELECT 1 rapid pe DB și un PING în Redis cu un timeout agresiv (maximum 1.5 - 2 secunde). Dacă DB-ul răspunde greu, tai nodul de la primirea de trafic nou înainte să crape de tot.

Trade-off-ul verificărilor profunde

Există o capcană mare aici: nu pune logica grea în healthcheck. Am văzut echipe care rulau query-uri complexe de agregare pe health endpoint, apelat de load balancer la fiecare 5 secunde. Practic își făceau singuri denial of service pe baza de date.

Healthcheck-ul trebuie să fie ultra-ușor. Verifici doar conectivitatea de bază, nu integritatea datelor din tabele. De asemenea, dacă pui timeout-ul de healthcheck prea scurt (sub 500ms), o mică variație de rețea îți va băga nodurile într-o buclă infinită de restartare (restart storm), ceea ce e mult mai rău decât o latență temporară.

Voi ce folosiți când nu aveți Kubernetes la îndemână: un script extern de curl cuplat cu pm2 restart, sau lăsați Nginx să scoată worker-ul din upstream când dă 3 erori consecutive?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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