Tu primer problema
Rompe algo a propósito y síguelo por Sypnia, desde la falla hasta la sesión, la grabación, la frase y el arreglo.
Esta página es para quien ya terminó un inicio rápido y quiere ver el ciclo completo una vez, con una falla que controla. Sirve en Sypnia Cloud y en un motor en alojamiento propio; los pasos que cambian están marcados.
Al final tendrás: un problema en Sypnia que causaste tú, la sesión donde pasó, su grabación y el prompt que le entrega el arreglo a tu agente de código.
Antes de empezar: Sypnia ya debe recibir eventos de tu aplicación. Si no, haz primero uno de los inicios rápidos: Sypnia Cloud o alojamiento propio.
Agrega un botón que falla
Agrega un botón a cualquier página de tu aplicación. Al hacerle clic lanza un error, como lo haría la página de pago de la tienda si faltara el total del carrito.
HTML
any-page.html <button id="sypnia-test">Test Sypnia</button> <script> document.getElementById('sypnia-test').addEventListener('click', () => { throw new Error('Sypnia test: the cart total is missing'); }); </script>React
AnyPage.tsx export function SypniaTest() { return ( <button onClick={() => { throw new Error('Sypnia test: the cart total is missing'); }} > Test Sypnia </button> ); }No necesitas llamar a Sypnia en este código. El SDK del navegador reporta por su cuenta los errores que nadie atrapó.
Deberías verUn botón «Test Sypnia» en la página. Al hacerle clic no se ve nada en pantalla, y aparece un error en la consola del navegador.Hazle clic tres veces, rápido
Abre la página y haz clic en el botón tres veces en menos de un segundo. Después quédate en la página unos 15 segundos, para que el SDK del navegador alcance a enviar lo que registró.
Pasaron tres cosas, y Sypnia vio cada una:
- Un error. Lo causaste tres veces, pero el SDK cuenta el mismo error una sola vez dentro de 5 segundos, así que Sypnia registra una ocurrencia.
- Un clic de rabia: tres clics o más en el mismo punto dentro de un segundo.
- Un clic muerto: un clic en un botón después del cual nada cambió en la página.
Como la sesión tuvo un error, el SDK también empezó a subir su grabación, desde 30 a 60 segundos antes del primer error, o desde el inicio de la sesión si es más corta que eso.
Deberías verEn la pestaña Network de las herramientas de desarrollo del navegador, solicitudes a tu dirección de ingesta que reciben una respuesta exitosa.Espera dos minutos
Un problema nuevo aparece dentro de los 2 minutos siguientes a su primer evento. La lista de sesiones está completa dentro de 10 minutos, y una grabación se puede ver cuando su sesión lleva 2 minutos sin actividad o ya terminó. Así que deja la página quieta un momento.
Deberías verDespués de 2 minutos, un problema nuevo en el entornodevelopment. Un poco después, tu sesión en la lista de sesiones, marcada con un error, un clic de rabia y una grabación.Abre el problema
Abre la lista de problemas y elige el entorno
development. En Sypnia Cloud es la aplicación enapp.sypnia.com. En un motor en alojamiento propio es la Consola, o la API, la CLI o tu agente de código por MCP.Hay un problema nuevo. Antes de que el agente lo analice, o si el agente está apagado, su título es el técnico:
Text Error: Sypnia test: the cart total is missingCuando el agente ya corrió, el título es una frase en palabras claras, como «Hacer clic en Test Sypnia falla siempre: la página lanza un error de prueba.» Debajo encuentras:
- A quién afectó: 1 persona, 1 sesión.
- Desde cuándo: la hora de tu primer clic, y la versión si tu aplicación reporta una.
- Dónde: el archivo y la línea del
throw, en tu propio código fuente si subiste source maps. Sin ellos ves el archivo compilado y su línea. Mira Versiones y source maps. - Las sesiones donde pasó.
Haz clic otra vez mañana y el conteo del problema sube; no aparece un segundo problema. Problemas explica qué hace que dos fallas sean el mismo problema.
Deberías verUn problema, marcado «nuevo», con 1 persona y 1 ocurrencia.Mira lo que pasó
Abre la sesión desde el problema. La línea de tiempo lista lo que hiciste: la página que abriste, los tres clics, el clic de rabia, el clic muerto y el error. La grabación empieza poco antes del primer error y muestra la página como la viste.
Deberías verLa grabación reproduce tus tres clics, con el momento del error marcado.Entrégaselo a tu agente de código
Cada problema llega listo para tu agente de código.
- El prompt. Cópialo desde el problema y pégalo en tu agente de código. Dice qué pasa, dónde, por qué, qué hacer y cómo comprobar el arreglo. Mira El prompt.
- MCP. Si tu agente de código está conectado a Sypnia, pregúntale «¿qué está fallando en mi entorno de desarrollo?». Mira Conectar.
- Un pull request. Nube Si instalaste la GitHub App de Sypnia, Sypnia puede abrir un pull request con el cambio y una prueba. Mira Pull requests.
Para esta prueba, el arreglo es borrar el botón.
Deberías verTu agente de código propone quitar elthrow, o el botón de prueba.
Lo que acabas de ver, con un problema real
En la historia de la tienda el camino es el mismo, con clientes reales. Tres personas hacen clic en Pagar, el pago se rechaza porque la página de pago sigue leyendo cart.total, y Sypnia te dice:
3 personas intentaron pagar hoy y no pudieron. El botón Pagar no hace nada desde el cambio de ayer.
La diferencia es que no tuviste que estar ahí, y que en producción Sypnia te envía una alerta.
Sigue con
- Qué es un problema, y cuándo es nuevo, está creciendo, está resuelto o volvió.
- Qué es una sesión, y qué registra la grabación.
- Cuándo te avisa Sypnia, y cómo.