Formations — 1 037 leçons en français

Accueil › Node.js › La mémoire, vraie limite d'une instance

La mémoire, vraie limite d'une instance

Performance et montée en chargeavance

Sur une instance Node, c'est presque toujours la mémoire qui cède avant le processeur. Un processus n'utilise qu'un cœur ; rien ne borne sa mémoire de la même façon.

Les deux chiffres à regarder

const m = process.memoryUsage();
console.log({
  tasUtilise: Math.round(m.heapUsed / 1e6),   // objets JavaScript vivants
  resident: Math.round(m.rss / 1e6),          // ce que le conteneur compte
  horsTas: Math.round(m.external / 1e6),      // tampons, compression, TLS
});

heapUsed qui monte sans jamais redescendre après un cycle de ramasse-miettes est une fuite. rss qui monte avec un heapUsed stable désigne des tampons hors du tas.

Les quatre suspects habituels

const cache = new Map();                       // 1. cache sans borne
for await (const m of source) sortie.write(m);  // 2. pas de contre-pression
emetteur.on("fin", gestionnaire);              // 3. écouteur jamais retiré
const journaux = [];                           // 4. « au cas où »

Dans l'ordre de fréquence : un cache sans borne, une accumulation de tampons faute de contre-pression, un écouteur jamais retiré, et un tableau de journaux gardé « au cas où ». Aucun n'est un oubli de libération — JavaScript n'en a pas. Ce sont des oublis d'oubli.

Ce qu'une fuite donne en production

14:02  rss 180 Mo
15:40  rss 390 Mo
17:10  rss 512 Mo → OOMKilled, redémarrage

Un redémarrage régulier, toutes les quelques heures, dont la période raccourcit quand le trafic monte. Les requêtes en vol sont perdues à chaque fois.

La méthode

Deux instantanés du tas, pris à une heure d'écart, comparés par type d'objet. Ce qui a grandi est la fuite. node --inspect puis l'onglet Mémoire de l'inspecteur suffit.

Les termes à connaître

Tas

La zone où V8 range les objets JavaScript. heapUsed dit ce qui y est vivant, heapTotal ce que V8 a réservé pour l'instant.

Mémoire résidente

rss : tout ce que le processus occupe en mémoire physique, y compris les tampons hors du tas et le code. C'est ce que le conteneur compte.

Fuite de mémoire

Une référence conservée vers un objet devenu inutile. En JavaScript, elle n'est jamais un oubli de libération mais un oubli d'oubli.

Dépassement de mémoire

OOMKilled dans un conteneur, ou heap out of memory dans V8. Le processus est tué, les requêtes en vol sont perdues.

Tampon

Un Buffer vit hors du tas JavaScript. Il n'apparaît donc pas dans heapUsed, mais il compte dans la mémoire résidente.

Instantané du tas

Un cliché de tout ce qui est vivant. Deux instantanés comparés disent ce qui a grandi entre les deux, et c'est la méthode de diagnostic.

Référence faible

WeakMap et WeakRef n'empêchent pas le ramasse-miettes de collecter leur clé. Utiles pour attacher des données à un objet sans le retenir.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.