Docs

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.

Aplica a Nube Al lanzar

Ver como Markdown
En esta página
  1. Crea un proyecto
  2. Agrega el SDK a tu app
  3. Abre tu app y comprueba que envía
  4. Mira tu primera sesión
  5. Causa tu primer problema
  6. Lo que tienes ahora
  7. Sigue con esto

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.

  1. 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í usan Shop.

    Deberías ver
    La página del proyecto muestra su llave de ingesta, que empieza por spk_, 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.

  2. Agrega el SDK a tu app

    npm

    npm install @sypnia/browser
    import { init } from '@sypnia/browser';
    
    init({ project: 'YOUR_PROJECT_KEY' });

    Pon la llamada a init donde 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 environment separa tus propias pruebas de tus clientes: en tu máquina la app reporta como development, y en cualquier otro lugar como production. Las alertas solo se envían para production.

    ¿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 ver
    Tu app compila y corre como antes. Nada se ve distinto.
  3. 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 ingest en el filtro.

    Deberías ver
    En menos de 10 segundos, una petición POST a https://ingest.sypnia.com/v1/ingest/events con estado 200. Su respuesta se ve como {"accepted": 5, "dropped": 0}.

    Si no hay petición, o sale en rojo, ve a Solución de problemas.

  4. Mira tu primera sesión

    Vuelve a Sypnia y abre Sesiones. Elige el entorno development.

    Deberías ver
    En 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.

  5. 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 ver
    En 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 reportError para 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 tenerHaz
El ciclo completo una vez, con un clic de rabia, una grabación y el arregloTu primer problema
«Desde el cambio de ayer», y los nombres de tus archivos en las pilasPon release y sube los source maps: Source maps en CI
«3 personas», con sus nombresIdentificar personas
La petición seguida hasta tu backendNode, Next.js u OpenTelemetry
Tu agente de código leyendo los problemas por su cuentaInstalar con tu agente de código
Saber qué se envía y qué nuncaPrivacidad y enmascarado

Cuando despliegues, tu app reporta como production y Sypnia empieza a enviar alertas y el resumen diario por correo.

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar