L17 · Construcción y vista previa · 5 min
Los logs: el diario de tu app (y dónde encontrarlos)
En una frase
Un log es el diario de tu app —una línea estructurada por cada evento importante con su nivel, ruta, identificador de petición y duración—, libre de secretos o datos personales y disponible en cuatro sitios: la consola del navegador, tu terminal local, los logs de construcción y los de ejecución en Vercel.
Piénsalo así
Piensa en el cuaderno de bitácora de un barco. En cada turno se anota una línea con la hora: el rumbo, el estado del mar y cualquier aviso. Si surge una avería, nadie adivina qué pasó: se abre el cuaderno en ese minuto exacto.
Cómo funciona
Un Definiciónlog (registro)El diario de tu app: una línea por evento. Cuando algo se rompe, los logs cuentan qué pasó.Abrir en el glosario → es el diario de tu app: una línea escrita cada vez que ocurre algo relevante. Para que puedas buscar en ellos con facilidad junto a tu Definiciónagente de programaciónUna IA que trabaja en la carpeta de tu proyecto: lee archivos, escribe código y ejecuta comandos, con tu permiso.Abrir en el glosario →, tu app escribe logs estructurados: una línea JSON por evento con el nivel (info para eventos normales, warn para avisos, error cuando algo falla), un mensaje claro, un identificador corto de petición, la ruta y cuánto tardó (duración).
Igual de importante es lo que nunca debe entrar en un log: jamás se registran un DefiniciónsecretoTodo lo que abre tus cuentas: claves de API, contraseñas, tokens. Solo se guarda en Vercel y en `.env.local`.Abrir en el glosario →, token, contraseña, datos personales (como correos o teléfonos) ni los DefiniciónpromptEl mensaje que le das a un modelo de IA. Un prompt claro da mejores resultados.Abrir en el glosario →s o respuestas de la IA. En las llamadas de IA, tu app anota solo el precio (X-Tokentide-Charge-USD), el identificador de petición, la función y qué proveedor respondió.
Mientras trabajas en tu equipo, los logs están en dos sitios: 1. La [[console]] del navegador (clic derecho → Inspeccionar → Console) para lo que pasa en el DefiniciónfrontendLa parte de una app que funciona en el navegador de quien la visita: lo que se ve y se pulsa.Abrir en el glosario → en pantalla, y 2. Tu [[terminal]] local donde corre npm run dev para lo que ocurre en el DefiniciónbackendLa parte de una app que funciona en un servidor: guarda datos, comprueba inicios de sesión y habla con otros servicios.Abrir en el glosario →.
Cuando tu app corre en DefiniciónVercelEl servicio que convierte tu código de GitHub en una web publicada, con una vista previa para cada cambio.Abrir en el glosario →, hay otros dos lugares: 3. Los logs de construcción de Vercel (npx vercel inspect <url> --logs), que explican por qué falló un despliegue al compilarse, y 4. Los logs de ejecución de Vercel (npx vercel logs <url>, guardados durante 1 hora en el plan Hobby), que muestran qué está haciendo el servidor en vivo o en vista previa.
Cómo se ve en tu proyecto
No tienes que rebuscar en los logs a mano. Dile a tu agente qué pasó y si fue en localhost o en un enlace de Vercel; él mismo mirará la terminal o ejecutará npx vercel logs y te resumirá qué dice el diario.
Copia para tu agente
Revisa cómo registra los logs nuestra app: asegúrate de que los eventos del servidor escriban una línea JSON estructurada (level, message, requestId, route, duration) y comprueba que nunca guardamos secretos, datos personales, prompts ni respuestas del modelo.
Comprobación rápida · 1 pregunta