eduardweb.
PerformanceIntermediar#nodejs#performance#typescript#prisma#postgresql

Cum am vânat N+1 în Prisma cu $metrics și de ce include nu e mereu salvarea

De Alexandru Matei, 8 nov. 2026 · 11 vizualizări · 3 like-uri

Postat 8 nov. 2026
typescript
import { PrismaClient } from '@prisma/client';

const prisma = new PrismaClient();

// 1. Detectare rapidă N+1 folosind $metrics
async function trackQueries<T>(fn: () => Promise<T>): Promise<T> {
  const before = (await prisma.$metrics.json()).counters;
  const startQueries = before.find(c => c.key === 'prisma_client_queries_total')?.value ?? 0;
  
  const result = await fn();
  
  const after = (await prisma.$metrics.json()).counters;
  const endQueries = after.find(c => c.key === 'prisma_client_queries_total')?.value ?? 0;
  
  const diff = endQueries - startQueries;
  if (diff > 5) console.warn(`Posibil N+1 detectat: ${diff} queries rulate!`);
  
  return result;
}

// 2. Select smart: doar id-uri, date necesare și count nativ
export async function getUsersOptimized() {
  return prisma.user.findMany({
    take: 50,
    select: {
      id: true,
      email: true,
      _count: {
        select: { orders: true } // agregare direct în DB, fără OOM
      },
      orders: {
        take: 3,
        orderBy: { createdAt: 'desc' },
        select: { id: true, total: true, status: true }
      }
    }
  });
}

ORM-urile moderne te mint frumos până când producția începe să gâfâie. Am pățit-o acum vreo șase luni pe un endpoint de dashboard: local rula impecabil cu 15 rânduri de test, dar pe staging cu 4.000 de înregistrări timpul de răspuns sărise direct la 1.8 secunde. Problema era clasică: N+1 queries mascate de abstracțiile promise-urilor din Prisma.

Cum am prins buba cu $metrics

Mulți developeri lasă log: ['query'] activat în development și se uită cum curge terminalul. E drăguț la început, dar devine complet inutil când ai zeci de request-uri simultane. Nu mai înțelegi care query de unde provine.

Prisma are o metodă mult mai curată adăugată de ceva vreme: prisma.$metrics.json(). Poți măsura exact numărul de interogări generate de un anumit block de cod sau poți expune datele direct în Prometheus.

Am împachetat execuția handler-ului cu o verificare rapidă a contorului prisma_client_queries_total. Rezultatul a fost ridicol: un singur request către /api/users/overview genera 142 de interogări SQL separate. De ce? Cineva scrisese un Promise.all peste utilizatori, iar în interior apela user.orders() și order.items(). Prisma nu face batching automat magic pentru relații chemate individual într-o buclă asincronă.

Capcana lui include generic

Reflexul imediat e să rescrii totul cu include: tragi utilizatorii și pui include: { orders: { include: { items: true } } }.

Da, funcționează. Numărul de interogări a scăzut de la 142 la doar 2 interogări optimizate cu IN (...). Timpul de răspuns a picat instant de la 1.8 secunde la 65ms. O victorie aparentă, dar care vine la pachet cu un trade-off pervers despre care se vorbește prea puțin.

Când dai include: true, Prisma selectează absolut toate coloanele din tabelele relaționate. Dacă tabela de orders are coloane de tip JSONB cu date de livrare sau note lungi, muți latența din rețea direct în memoria Node.js. Pe un container de 512MB RAM, la 40-50 de request-uri concurente, riști un Out-Of-Memory fără să clipești. Practic, transformi o problemă de latență de bază de date într-o problemă de memorie pe serverul de aplicație.

Include smart și agregări native

Ca să rezolvi elegant problema fără să umfli heap-ul procesului, renunță la include complet pe relații extinse și treci la select chirurgical. Selectezi strict coloanele de care ai nevoie în UI.

Mai mult, dacă scopul relației era doar să afișeze o cifră (de exemplu: câte comenzi are userul sau valoarea lor), nu aduce modelele întregi în memorie ca să le numeri cu .length în JavaScript. Am văzut asta de zeci de ori în code review-uri. Prisma oferă _count nativ, care împinge agregarea direct în Postgres și returnează un simplu număr.

Voi cum monitorizați interogările de genul ăsta în producție? Aveți alerte pe metrici de query count sau vă bazați doar pe tracing din APM?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

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