# Los logs: el diario de tu app (y dónde encontrarlos)

> 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.

## Analogía

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 log 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 coding-agent, 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 secret, token, contraseña, datos personales (como correos o teléfonos) ni los prompts 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 frontend en pantalla, y **2. Tu terminal local** donde corre `npm run dev` para lo que ocurre en el backend.

Cuando tu app corre en vercel, 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.

## 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

```text
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.
```

---
Fuente: [Agentic Makers](https://agenticmakers.app/es/aprende/logs) · Licencia: CC BY 4.0