Saltar al contenido

Lección 10 de 12 · Lectura y práctica

Logging util (no spam)

Logging Logs utiles responden: que paso, a quien, cuando y por que fallo. Sin eso, debug es adivinanza. Conceptos clave request id niveles (info/warn/error) no loguear secretos Ejemplo Log minimo: method, path, status,.

Del concepto a la práctica

Taller de esta lección

Un log accionable permite relacionar una solicitud con su resultado sin registrar cuerpos sensibles. El mínimo útil combina identificador de petición, método, ruta, estado y duración; el nivel debe reflejar la gravedad, no la cantidad de mensajes.

Ejemplo resuelto

js
console.log(JSON.stringify({
  request_id: 'r-104', method: 'GET', path: '/courses/7',
  status: 200, duration_ms: 18
}));

Este registro permite buscar la petición y comparar latencias. No incluye autorización, contraseña ni cuerpo completo.

La espera25ms es una entrada de simulación y puede resultar mayor por planificación; comprueba no negativo y rango tolerado, sin fallar por no medir25 exacto. Usa rutas normalizadas como /courses/:id cuando no quieras registrar IDs y evita parámetros sensibles de query. Valida longitud/formato de request_id del cliente para impedir contaminación de logs y nunca lo uses como prueba de identidad.

Pruébalo

  1. Genera un identificador por solicitud o acepta uno validado.

  2. Mide desde la entrada hasta finish.

  3. Emite un registro para 200 y otro para 500, conservando campos comunes.

Error frecuente: imprimir req.headers completo para depurar. Corrige seleccionando campos permitidos y enmascarando cualquier secreto necesario.

Ejercicio: crea una solicitud que tarde 25 ms y registra su resultado.

Comprueba tu resultado

duration_ms es un número no negativo cercano a 25, aparecen método, ruta y estado, y no aparece el valor de Authorization.

Navegador, API y base de datos conectados por solicitudes, consultas y respuestas en sentidos opuestos.
CursaloMapa de práctica
Del navegador a los datos

El navegador envía una solicitud a la API. El servidor valida la operación y consulta los datos; después devuelve una respuesta que el navegador puede mostrar. La base de datos se comunica con el servidor y no directamente con el navegador.

Ver la infografía en tamaño completo ↗

Logging

Logs utiles responden: que paso, a quien, cuando y por que fallo. Sin eso, debug es adivinanza.

Conceptos clave

  • request id
  • niveles (info/warn/error)
  • no loguear secretos

Ejemplo

Log minimo: method, path, status, duration_ms, user_id (si aplica).

Ejercicio

  • Agrega duration_ms a tus logs.
  • Enmascara tokens/keys si aparecen.

Checklist de mastery

  • Mis logs son accionables.
  • No exfiltrado secretos en logs.

Sigue con Node.js y APIs con Express

Esta lección forma parte de un curso de Cursalo. Revisa su programa y elige entre la compra individual o el acceso a toda la escuela.

Si ya tenías acceso a este curso, entra con tu cuenta: tus derechos y tu progreso se conservan. No necesitas comprarlo de nuevo.

01 / ELEGIR UNA RUTA

El próximo paso

Aprende IA mientras construyes algo que sí necesitas.

Empieza por el curso inicial o explora el catálogo para encontrar una práctica alineada con tu trabajo.