os y process

node:os expone las capacidades del host; process expone el tiempo de ejecución actual de Node. Juntos impulsan el dimensionamiento del clúster, las cargas útiles de salud y la configuración del entorno.

Receta

import { availableParallelism, hostname, totalmem, freemem } from 'node:os';
 
console.log({
  host: hostname(),
  cpus: availableParallelism(),
  memFree: freemem(),
  memTotal: totalmem(),
  node: process.version,
  pid: process.pid,
});

Cuándo usarlo:

• Cargas útiles de diagnóstico /health y /ready
• Dimensionamiento de pools de worker_threads y forks de clúster
• Registro de la plataforma en el banner de inicio estructurado
• Detección de presión de memoria del contenedor antes de OOMKill

Ejemplo de trabajo

import { availableParallelism, hostname, loadavg, platform, arch } from 'node:os';
 
export function hostSnapshot() {
  return {
    hostname: hostname(),
    platform: platform(),
    arch: arch(),
    nodeVersion: process.version,
    pid: process.pid,
    ppid: process.ppid,
    uptimeSec: process.uptime(),
    cpuParallelism: availableParallelism(),
    loadavg1m: loadavg()[0],
    memory: process.memoryUsage(),
    env: process.env.NODE_ENV ?? 'development',
  };
}
 
export function assertProductionEnv(): void {
  if (process.env.NODE_ENV === 'production' && !process.env.DATABASE_URL) {
    throw new Error('DATABASE_URL required in production');
  }
}

import { monitorEventLoopDelay } from 'node:perf_hooks';
 
const h = monitorEventLoopDelay({ resolution: 20 });
h.enable();
 
setInterval(() => {
  console.log('eventLoopP99Ns', h.percentile(99), 'rss', process.memoryUsage().rss);
  h.reset();
}, 30_000).unref();

Lo que esto demuestra:

• availableParallelism respeta los límites de CPU de cgroup en contenedores mejor que el obsoleto cpus().length
• process.memoryUsage().rss rastrea el conjunto residente: correlaciona con los eventos OOM de K8s
• loadavg específico de Unix: útil en máquinas virtuales Linux, menos en Windows
• Valida el entorno crítico al inicio antes de aceptar tráfico

Inmersión profunda

Cómo funciona

• process.env es un mapa de cadenas mutable; cópialo al inicio para inmutabilidad si lo deseas.
• memoryUsage devuelve rss, heapTotal, heapUsed, external; no la huella completa del proceso, pero sí tendencias.
• cpuUsage tiempo de usuario/sistema en microsegundos para el proceso actual.
• os.networkInterfaces lista las direcciones de las NIC; filtra cuidadosamente antes de registrar (información de identificación personal/topología interna).

Campos útiles

Notas de TypeScript

import { env } from 'node:process';
 
const nodeEnv = env.NODE_ENV ?? 'development';

Errores comunes

• Registro completo de process.env - fuga de secretos. Solución: permite solo las claves necesarias en la salida de salud.
• Uso de cpus().length en contenedores - recuento incorrecto de vCPU. Solución: availableParallelism().
• Mutación de process.env en tiempo de ejecución - errores sutiles en las bibliotecas. Solución: trátalo como inmutable después del arranque.
• Confiar en el nombre de host para la seguridad - contexto falsificable. Solución: la autorización no debe basarse únicamente en el nombre de host.
• loadavg en Windows - devuelve ceros; no confíes en él de forma multiplataforma.

Alternativas

Preguntas frecuentes

Relacionado

• Conceptos básicos de procesos - pid y workers
• Instalación y gestión de versiones - motores
• Detección de bloqueo del bucle de eventos - perf_hooks
• Conceptos básicos de configuración - patrones de entorno

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.