L24 · Publicación · 5 min
Después de publicar: alertas de errores y supervisión
En una frase
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.
Piénsalo así
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 Definiciónproducción (Production)La versión publicada de tu app, la que ve todo el mundo. Sale de `main`.Abrir en el glosario →, 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 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 → en Definiciónvariable de entornoUn hueco con nombre, como `TOKENTIDE_API_KEY`, que guarda un ajuste o un secreto fuera de tu código.Abrir en el glosario →. Cada vez que un fallo inesperado llega a un Definiciónlímite de error (error boundary)Una red de seguridad de tu app que atrapa errores inesperados y muestra un mensaje amable con «Reintentar».Abrir en el glosario → o a una ruta del servidor, Sentry recoge la Definicióntraza de error (stack trace)La lista de pasos que llevaron a un error. Útil para tu agente; nunca se enseña a tus usuarios.Abrir en el glosario → y te envía un aviso.
Junto con las alertas, tu app escribe logs estructurados: una línea JSON por evento en tu 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 → 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 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 →, 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 Definiciónerror (bug)Un fallo en el código que hace que la app se comporte mal.Abrir en el glosario →, arregle la causa en una DefiniciónramaUna copia segura de tu proyecto donde se preparan los cambios. `main` es la publicada.Abrir en el glosario → y añada un DefinicióntestUn pequeño programa que comprueba que tu app hace lo que debe, para que un arreglo no se rompa sin avisar más adelante.Abrir en el glosario →.
Cómo se ve 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 Definiciónvista previa (Preview)Un enlace privado de prueba que Vercel crea para cada cambio, para probarlo antes de publicarlo.Abrir en el glosario → para ver llegar el aviso y comprobar que no aparece ningún dato personal ni secreto en el informe.
Copia para tu agente
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.
Comprobación rápida · 1 pregunta