Inicio rápido: Sypnia Cloud
De cero a tu primera sesión y tu primer problema en Sypnia Cloud, en cinco pasos y unos diez minutos.
Nube Esta página es para quien tiene una app web y todavía no tiene Sypnia. Usa Sypnia Cloud, donde nosotros corremos el motor por ti: no hay nada que desplegar. Para correr el motor tú mismo, usa el inicio rápido con alojamiento propio; el fragmento en tu app es el mismo.
Al final tendrás: tu app enviando a Sypnia, tu propia visita listada como una sesión, y un problema que causaste a propósito.
Necesitas: una app web que puedas editar y correr, y unos diez minutos. El nivel gratis alcanza.
Crea un proyecto
Abre
https://app.sypnia.com, crea una cuenta y crea un proyecto. Ponle el nombre de tu app; los ejemplos de aquí usanShop.Deberías verLa página del proyecto muestra su llave de ingesta, que empieza porspk_, y dice que está esperando el primer evento. Deja la página abierta.La llave de ingesta es pública. Solo sirve para enviar datos a este proyecto, así que puede ir en el código de tu app.
Agrega el SDK a tu app
npm
npm install @sypnia/browserimport { init } from '@sypnia/browser'; init({ project: 'YOUR_PROJECT_KEY' });pnpm
pnpm add @sypnia/browserimport { init } from '@sypnia/browser'; init({ project: 'YOUR_PROJECT_KEY' });yarn
yarn add @sypnia/browserimport { init } from '@sypnia/browser'; init({ project: 'YOUR_PROJECT_KEY' });bun
bun add @sypnia/browserimport { init } from '@sypnia/browser'; init({ project: 'YOUR_PROJECT_KEY' });script tag
<script async src="https://ingest.sypnia.com/v1/sdk.js" data-project="YOUR_PROJECT_KEY"></script>Sin paso de compilación y sin llamar a
init: pégala antes de</head>. La etiqueta inicia Sypnia con la llave que va endata-project.Pon la llamada a
initdonde arranca tu app, antes de que pinte:src/main.ts,src/main.tsx,src/index.js. Luego reemplázala por esta versión más completa, con tu propia llave:src/main.ts import { init } from '@sypnia/browser'; init({ project: 'spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e', environment: location.hostname === 'localhost' ? 'development' : 'production', });La línea
environmentsepara tus propias pruebas de tus clientes: en tu máquina la app reporta comodevelopment, y en cualquier otro lugar comoproduction. Las alertas solo se envían paraproduction.¿Usas Next.js? Sigue Next.js para este paso y vuelve. ¿Usas un constructor de apps con IA? Mira Lovable, Bolt, v0 y Replit.
Deberías verTu app compila y corre como antes. Nada se ve distinto.Abre tu app y comprueba que envía
Corre tu app, ábrela en un navegador y haz clic en varias cosas. Abre las herramientas de desarrollo del navegador, pestaña Network (Red), y escribe
ingesten el filtro.Deberías verEn menos de 10 segundos, una peticiónPOSTahttps://ingest.sypnia.com/v1/ingest/eventscon estado200. Su respuesta se ve como{"accepted": 5, "dropped": 0}.Si no hay petición, o sale en rojo, ve a Solución de problemas.
Mira tu primera sesión
Vuelve a Sypnia y abre Sesiones. Elige el entorno
development.Deberías verEn menos de 10 minutos, una sesión: la tuya. Lista las páginas que abriste y en qué hiciste clic, en palabras: «Hizo clic en Agregar al carrito».La sesión es anónima: Sypnia no sabe quién eres hasta que tu app lo dice. Eso es una línea más, en Identificar personas.
Causa tu primer problema
Agrega una línea después de
init, guarda y recarga tu app una vez:src/main.ts import { init, reportError } from '@sypnia/browser'; init({ project: 'spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e', environment: location.hostname === 'localhost' ? 'development' : 'production', }); reportError(new Error('Sypnia test: the cart total is missing'));Luego abre Problemas en Sypnia, en el entorno
development.Deberías verEn menos de 2 minutos, un problema nuevo. Su primer título es el técnico,Error: Sypnia test: the cart total is missing. Un momento después el agente lo reemplaza por una frase en palabras simples y dice a quién afectó (1 persona), desde cuándo y en qué parte de tu código.Quita la línea. En el uso real nunca llamas a
reportErrorpara esto: los errores que nadie capturó se reportan solos.
Lo que tienes ahora
- Cada visita a tu app es una sesión, con sus páginas y sus clics.
- Los errores, las páginas lentas, las llamadas a la API lentas o fallidas, y los clics de rabia y clics muertos se capturan sin más código.
- Las sesiones donde algo sale mal se graban, con todo lo que una persona escribe enmascarado.
- Los problemas llegan como frases, con el prompt para tu agente de código.
Sigue con esto
| Para tener | Haz |
|---|---|
| El ciclo completo una vez, con un clic de rabia, una grabación y el arreglo | Tu primer problema |
| «Desde el cambio de ayer», y los nombres de tus archivos en las pilas | Pon release y sube los source maps: Source maps en CI |
| «3 personas», con sus nombres | Identificar personas |
| La petición seguida hasta tu backend | Node, Next.js u OpenTelemetry |
| Tu agente de código leyendo los problemas por su cuenta | Instalar con tu agente de código |
| Saber qué se envía y qué nunca | Privacidad y enmascarado |
Cuando despliegues, tu app reporta como production y Sypnia empieza a enviar alertas y el resumen diario por correo.