pino

Usa Pino para un registro JSON estructurado rápido en Node.js: loggers hijos para el contexto de la solicitud, redacción para secretos y un impacto mínimo en el bucle de eventos.

Receta

Tarjeta de receta de referencia rápida: lista para copiar y pegar.

import pino from "pino";
 
export const logger = pino({
  level: process.env.LOG_LEVEL ?? "info",
  redact: ["req.headers.authorization", "password"],
});
 
logger.info({ orderId: "o_1" }, "order created");

Cuándo usarlo:

• Cada servicio HTTP de Node en producción (Express, Fastify, NestJS).
• Reemplazar Winston o console.log para pipelines JSON.
• Necesitas campos con ámbito de solicitud sin pasar req por cada función.
• El volumen de logs excede 1k líneas/seg y el rendimiento es importante.

Ejemplo de trabajo

import pino from "pino";
import express from "express";
import { randomUUID } from "node:crypto";
 
const logger = pino({
  level: process.env.LOG_LEVEL ?? "info",
  base: { service: "billing-api" },
  redact: {
    paths: ["req.headers.authorization", "req.headers.cookie", "body.cardNumber"],
    censor: "[REDACTED]",
  },
  timestamp: pino.stdTimeFunctions.isoTime,
});
 
const app = express();
app.use(express.json());
 
app.use((req, res, next) => {
  const requestId = (req.headers["x-request-id"] as string) ?? randomUUID();
  const start = process.hrtime.bigint();
  (req as express.Request & { log: pino.Logger }).log = logger.child({ requestId });
 
  res.on("finish", () => {
    req.log.info({
      event: "request_complete",
      method: req.method,
      path: req.path,
      statusCode: res.statusCode,
      durationMs: Number(process.hrtime.bigint() - start) / 1e6,
    });
  });
  next();
});
 
app.post("/charges", async (req, res) => {
  req.log.info({ amount: req.body.amount }, "charge started");
  try {
    const result = await processCharge(req.body);
    req.log.info({ chargeId: result.id }, "charge succeeded");
    res.status(201).json(result);
  } catch (err) {
    req.log.error({ err }, "charge failed");
    res.status(500).json({ error: "Internal Server Error" });
  }
});
 
async function processCharge(body: { amount: number }) {
  return { id: "ch_1", amount: body.amount };
}
 
app.listen(3000);

Lo que esto demuestra:

• Logger raíz con metadatos de servicio base y marcas de tiempo ISO.
• Logger hijo por solicitud vinculado en middleware con requestId.
• El evento finish registra la duración y el estado sin bloquear la respuesta.
• Errores registrados con { err } antes de la respuesta genérica 5xx.

Análisis profundo

Cómo funciona

• Pino serializa objetos de log a cadenas JSON de forma asíncrona (hilo de trabajador por defecto en muchas configuraciones).
• Niveles numéricos: trace 10, debug 20, info 30, warn 40, error 50, fatal 60.
• Los loggers hijos heredan los enlaces del padre y añaden los suyos propios - cadena inmutable.
• La salida es una línea JSON por log - NDJSON para Loki/Datadog/CloudWatch.

Opciones de configuración

Impresión bonita para desarrollo

const logger = pino({
  transport: process.env.NODE_ENV === "development"
    ? { target: "pino-pretty", options: { colorize: true } }
    : undefined,
});

• Nunca uses pino-pretty en producción - bloquea el hilo principal.

Integración con NestJS

npm install nestjs-pino

// app.module.ts
import { LoggerModule } from "nestjs-pino";
 
@Module({
  imports: [LoggerModule.forRoot({ pinoHttp: { level: "info" } })],
})
export class AppModule {}

Errores comunes

• Registrar req y res completos - líneas enormes, riesgo de PII. Solución: serializadores personalizados con solo método, url, estado.
• pino-pretty en producción - colapso del rendimiento. Solución: JSON a stdout; bonito solo localmente.
• Destino síncrono bajo carga - pino.destination({ sync: true }) bloquea. Solución: destino asíncrono predeterminado.
• Falta el serializador de errores - log.error("msg", err) firma incorrecta. Solución: log.error({ err }, "msg").
• Logs de depuración siempre activados - costo y ruido. Solución: LOG_LEVEL=info en producción; muestrear depuración.
• Logger hijo no pasado a los servicios - se pierde el requestId en capas profundas. Solución: AsyncLocalStorage o parámetro explícito.

Alternativas

Preguntas frecuentes

Relacionado

• Conceptos básicos de registro - principios de registro estructurado
• IDs de correlación de solicitudes - propagación de requestId
• Redacción y cumplimiento de PII - rutas GDPR
• Registro con Pino en Fastify - hooks de Fastify

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.