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
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
Genera un identificador por solicitud o acepta uno validado.
Mide desde la entrada hasta
finish.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.

Mapa de prácticaEl 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.