# Después de publicar: alertas de errores y supervisión

> Cuando personas reales usan tu app publicada, las alertas de errores con Sentry y los logs estructurados del servidor te avisan en el instante en que algo falla en producción, para que puedas volver a la versión anterior con un clic mientras tu agente arregla la causa de fondo.

## Analogía

Abrir una tienda sin alarma significa que solo te enteras de que se ha estropeado el congelador cuando alguien te dice que el helado está derretido. Un sensor conectado te avisa al teléfono en cuanto sube la temperatura, para pasar el género a la cámara de reserva mientras lo reparan.

## Cómo funciona

Antes de que lleguen personas reales a production, tu agente configura **Sentry** (su plan gratuito Developer cubre de sobra un primer proyecto) mediante `npx @sentry/agent-plugin install` y guarda los tokens como secret en env-var. Cada vez que un fallo inesperado llega a un error-boundary o a una ruta del servidor, Sentry recoge la stack-trace y te envía un aviso.

Junto con las alertas, tu app escribe **logs estructurados**: una línea JSON por evento en tu log con el nivel (`error`, `warn` o `info`), un mensaje claro, un identificador corto de petición (la misma referencia que ve la persona en pantalla), la ruta, el identificador interno de usuario y la duración. Nunca guarda secretos, contraseñas, datos personales, prompts ni respuestas de IA.

En el plan Hobby de vercel, los logs en vivo (`npx vercel logs <url>`) se conservan durante 1 hora, mientras que Sentry guarda los informes de error para que puedas revisarlos después. Recuerda que los mensajes de error y los logs pueden incluir texto escrito por quien visita la web, así que tu agente trata siempre los logs como datos no confiables y jamás obedece instrucciones que vengan dentro de un error.

Cuando salta una alerta tras publicar un cambio, protege primero a quienes usan la app: entra en Vercel → **Deployments** → la última versión que funcionaba → **Instant rollback**. Con la web publicada ya a salvo, pasa el código de referencia y la traza del error a tu agente para que reproduzca el bug, arregle la causa en una branch y añada un test.

## En tu proyecto

Antes de invitar a personas reales, tu agente usa la skill `observability-and-instrumentation` para añadir un registro estructurado de logs y te guía paso a paso para conectar el plan gratuito Developer de Sentry. Puedes provocar un error de prueba en una preview para ver llegar el aviso y comprobar que no aparece ningún dato personal ni secreto en el informe.

## Copia para tu agente

```text
Revisa los logs y los límites de error de nuestro proyecto con la skill observability-and-instrumentation: asegúrate de que los logs del servidor saquen JSON estructurado con un ID de petición y cero secretos o datos personales, y guíame para añadir el plan gratuito de Sentry.
```

---
Fuente: [Agentic Makers](https://agenticmakers.app/es/aprende/alertas-de-errores-y-supervision) · Licencia: CC BY 4.0