Memoria personalizada (heap)

Node.js guarda los datos de tu aplicación (objetos, textos, cachés) en un espacio llamado heap, que tiene un tamaño máximo. Cuando se llena, la aplicación se detiene con JavaScript heap out of memory.

En tu servidor ese límite ya se ajusta solo al 83 % de la RAM de tu plan. Lo ves al iniciar, en el resumen de la Consola: por ejemplo, Memoria 512 MB · heap de Node: 427 MB (83 % automático). El 17 % restante queda para lo que Node.js usa fuera del heap: buffers, módulos nativos, conexiones. En la mayoría de los casos no necesitas tocar nada.

• Usas mucha memoria fuera del heap. Si procesas imágenes con sharp, manejas archivos grandes o ejecutas procesos hijos, y el servidor se apaga sin el error de heap, baja el porcentaje (70–75 %) para dejar más espacio libre.
• Quieres que un problema de memoria aparezca antes. Un límite menor hace que una fuga de memoria se note antes, en lugar de que el servidor se quede lento.

Calcula el valor para tu plan:

1. En el panel de control, abre tu servidor y ve a la pestaña Arranque.

2. En Opciones de Node, pega el valor que te dio la calculadora. Si ya tenías otras opciones, agrégalo separado por un espacio:

   --enable-source-maps --max-old-space-size=700

3. Reinicia el servidor.

Para volver al ajuste automático, borra --max-old-space-size=… de Opciones de Node y reinicia.

La Consola del panel de control muestra la memoria total del servidor. Para ver solo el heap desde tu código:

const mb = (n) => Math.round(n / 1024 / 1024);
setInterval(() => {
  const { heapUsed, heapTotal, rss } = process.memoryUsage();
  console.log(`heap ${mb(heapUsed)}/${mb(heapTotal)} MB · total ${mb(rss)} MB`);
}, 60_000);

Si heapUsed solo sube y nunca baja durante horas, hay una fuga de memoria. Las causas más comunes están en Mi bot se apaga o se reinicia solo.