Registro en aplicaciones JavaScript: mejores prácticas y consejos

Registro en aplicaciones JavaScript: mejores prácticas

El registro no es solo escribir eventos en un archivo. En las aplicaciones modernas de Node.js, es una herramienta poderosa para monitoreo, depuración y auditoría. Sin un registro de calidad, encontrar la causa de una caída del servidor de producción se convierte en un juego de adivinanzas. En este artículo, analizaremos las mejores prácticas de registro en JavaScript (Node.js) que te ayudarán a construir sistemas confiables y mantenibles.

Por qué el console.log estándar es una mala práctica

Muchos desarrolladores principiantes usan console.log para depurar. Sin embargo, en producción esto genera problemas:

• Falta de niveles: no puedes separar mensajes informativos de errores críticos.
• Sin estructura: la salida en consola es solo una cadena difícil de analizar.
• Entrada/Salida bloqueante: la escritura síncrona puede ralentizar la aplicación.
• Sin rotación: los archivos de registro crecerán infinitamente.

En su lugar, usa bibliotecas especializadas como winston o pino. Estas proporcionan configuración flexible de transportes (salida a archivo, consola, servicios externos) y escritura asíncrona.

Elección de biblioteca de registro: winston vs pino

En el ecosistema Node.js hay dos líderes claros. Veamos sus características:

Winston

La biblioteca más popular. Soporta múltiples transportes (archivo, HTTP, MongoDB, Elasticsearch) y formatos personalizados. Ideal para aplicaciones monolíticas.

const winston = require('winston');

const logger = winston.createLogger({    level: 'info',    format: winston.format.json(),    transports: [        new winston.transports.File({ filename: 'error.log', level: 'error' }),        new winston.transports.File({ filename: 'combined.log' }),        new winston.transports.Console({ format: winston.format.simple() })    ]});

logger.info('Servidor iniciado en el puerto 3000');logger.error('Error de conexión a la BD', { db: 'mongo', code: 500 });

Pino

Biblioteca ultrarrápida, de 5 a 10 veces más rápida que winston. Ideal para sistemas de alta carga y microservicios. Por defecto, genera JSON.

const pino = require('pino');

const logger = pino({    level: process.env.LOG_LEVEL || 'info',    transport: {        target: 'pino/file',        options: { destination: './app.log' }    }});

logger.info({ user: 'admin' }, 'Usuario inició sesión');logger.error(new Error('Timeout'), 'Error en la solicitud');

Consejo: para la mayoría de proyectos elige winston por su flexibilidad. Si el rendimiento es crítico, usa pino.

Niveles de registro: cómo no ahogarse en mensajes

El uso correcto de niveles es la base de un buen registro. En Node.js se adopta la siguiente jerarquía (de menor a mayor criticidad):

• trace / silly — información de depuración extremadamente detallada (generalmente desactivada en producción).
• debug — mensajes de depuración para desarrolladores.
• info — confirmación de funcionamiento normal (solicitudes, inicio de servicios).
• warn — situación anómala, pero la aplicación sigue funcionando (por ejemplo, exceder el límite de solicitudes).
• error — error que requiere atención (fallo de solicitud, error de servicio externo).
• fatal — error crítico tras el cual la aplicación no puede continuar funcionando.

Configura el nivel de registro mediante variables de entorno:

const LOG_LEVEL = process.env.LOG_LEVEL || 'info';const logger = winston.createLogger({ level: LOG_LEVEL });

En desarrollo usa debug, en producción usa info. ```