os e process

node:os expõe as capacidades do host; process expõe o runtime do Node atual - juntos, eles impulsionam o dimensionamento de clusters, payloads de saúde e configuração do ambiente.

Receita

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

Quando usar isso:

• Payloads de diagnóstico /health e /ready
• Dimensionamento de pools de worker_threads e forks de cluster
• Plataforma de log em banner de inicialização estruturado
• Detecção de pressão de memória do contêiner antes do OOMKill

Exemplo de Trabalho

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();

O que isso demonstra:

• availableParallelism respeita os limites de CPU do cgroup em contêineres melhor do que o legado cpus().length
• process.memoryUsage().rss rastreia o conjunto residente - correlacione com eventos OOM do K8s
• loadavg é específico do Unix - útil em VMs Linux, menos no Windows
• Valide o ambiente crítico na inicialização antes de aceitar tráfego

Mergulho Profundo

Como Funciona

• process.env é um mapa de strings mutável - copie na inicialização para imutabilidade, se desejado.
• memoryUsage retorna rss, heapTotal, heapUsed, external - não a pegada completa do processo, mas tendências.
• cpuUsage tempo de usuário/sistema em microssegundos para o processo atual.
• os.networkInterfaces lista os endereços NIC - filtre cuidadosamente antes de registrar (PII/topologia interna).

Campos Úteis

Notas TypeScript

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

Armadilhas

• Registrar todo o process.env - vazamento de segredos. Correção: crie uma lista de permissões de chaves na saída de saúde.
• Usar cpus().length em contêineres - contagem incorreta de vCPUs. Correção: availableParallelism().
• Mutar process.env em tempo de execução - bugs sutis em bibliotecas. Correção: trate como imutável após a inicialização.
• Confiar no hostname para segurança - contexto falsificável. Correção: autorização não baseada apenas no hostname.
• loadavg no Windows - retorna zeros - não confie multiplataforma.

Alternativas

FAQs

Relacionado

• Noções Básicas de Processos - pid e workers
• Instalação e Gerenciamento de Versão - engines
• Detecção de Bloqueio do Event-Loop - perf_hooks
• Noções Básicas de Configuração - padrões de env

Versões da Stack: Esta página foi escrita para Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 e NestJS 11.