Docs

Qué es Sypnia

Qué vigila Sypnia, para quién es, en qué se diferencia de un tablero y qué no hace.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. El ejemplo que usa esta documentación
  2. Qué vigila
  3. Qué lo hace distinto
  4. Para quién es
  5. Con qué funciona al lanzar
  6. Código abierto y de pago: la versión corta
  7. Qué no hace Sypnia
  8. Sigue con

Esta página es para quien está decidiendo si Sypnia le sirve a su aplicación. Aplica al motor de código abierto y a Sypnia Cloud; donde difieren, la página lo dice.

Sypnia es una plataforma de observabilidad de código abierto para quienes construyen software con IA. Vigila tu aplicación en producción. Cuando algo falla, te dice en palabras claras qué pasó, a quién y desde cuándo, y le entrega el arreglo al agente de código que escribió el código.

El ejemplo que usa esta documentación

Todas las páginas usan la misma historia, para que los ejemplos coincidan entre sí. Tienes una tienda pequeña con una página de pago. Ayer a las 18:40 desplegaste un cambio que le cambió el nombre al total del carrito, de cart.total a cart.totalCents. La página de pago sigue leyendo el nombre viejo, así que el pago sale sin monto y lo rechazan. Nada en la pantalla le avisa al cliente.

Un stack trace o una línea de log diría algo como POST /api/checkout 400. Sypnia dice:

3 personas intentaron pagar hoy y no pudieron. El botón Pagar no hace nada desde el cambio de ayer.

Después dice a quién afectó, qué estaban haciendo, desde cuándo, la causa probable con su evidencia y qué hacer. Esa frase, y todo lo que hay detrás, se llama un problema.

Qué vigila

Sypnia cubre lo esencial con una sola instalación. Todo esto está disponible al lanzar.

QuéEn una líneaMás
Errores agrupadosLa misma falla es un solo problema, no cuatrocientos correos.Problemas
Grabación de sesionesLa sesión como la vivió la persona, con el momento en que falló ya marcado.Sesiones y grabación
RendimientoQué páginas le cargan lento a la gente de verdad, y qué llamadas a tu API están lentas o fallando.Rendimiento
Clics de rabia y clics muertosDónde la gente hace clic una y otra vez, y en qué cosas hace clic sin que pase nada.Clics de rabia y clics muertos
Trazas de punta a puntaUna solicitud seguida desde el navegador hasta tu API y las llamadas que hay detrás.Trazas
DisponibilidadUna verificación desde afuera de que tu aplicación responde.Disponibilidad
Alertas y un resumen diarioUna alerta cuando no puede esperar, y un mensaje corto al día para lo demás.Alertas y el resumen diario

También disponible al lanzar, porque el sistema del que sale Sypnia ya lo tiene:

  • Mapas de clics: dónde hace clic la gente en cada página, con los clics de rabia y los clics muertos marcados. Mira Clics de rabia y clics muertos.
  • Personas y cuentas: quién está activo, sus sesiones y cuándo se le vio por última vez. Mira Sesiones y grabación.
  • Eventos propios y fallas de formularios: eventos a los que tu aplicación les pone nombre, y formularios que el navegador se negó a enviar. Mira Eventos.
  • Sugerencias semanales: mejoras de rendimiento y de experiencia que propone el agente, cada una con su evidencia. Mira Cómo funciona el análisis.

Qué lo hace distinto

Habla como una persona. Un problema se cuenta en una frase, con la gente a la que afectó. El análisis detrás de esa frase se llama el agente, y esta documentación explica qué lee y qué nunca lee en Cómo funciona el análisis.

Cierra el ciclo con tu agente de código. Cada problema llega listo para el agente que escribe tu código, de tres maneras:

  1. Un prompt que pegas en Cursor, Claude Code o cualquier agente que reciba texto. Mira El prompt.
  2. Un servidor MCP al que tu agente le puede preguntar «¿qué está fallando en producción?». Mira Conectar.
  3. Un pull request con el cambio y una prueba, abierto por la GitHub App de Sypnia. Una persona lo revisa y lo aprueba. Nube Mira Pull requests.

Es abierto. El motor que recibe, guarda y analiza tus datos es de código abierto, y acepta OpenTelemetry, así que puedes usarlo junto a otra herramienta o cambiarte después.

Para quién es

Sypnia está hecho primero para personas y equipos pequeños que lanzan con Lovable, Bolt, v0, Replit, Cursor o Claude Code, y que quieren saber si lo que lanzaron funciona sin aprender a leer tableros.

Es más estrecho que Sentry, Datadog o PostHog, a propósito. Si tu equipo ya vive en tableros y necesita logs, métricas propias o cientos de servicios, esas herramientas hacen más. Sypnia te dice en una frase qué está mal, para quién y cómo arreglarlo.

Con qué funciona al lanzar

  • Aplicaciones web, con el SDK del navegador @sypnia/browser, en cualquier framework. Mira Navegador.
  • Backends en Node y Next.js, con @sypnia/node y @sypnia/next. Mira Node y Next.js.
  • Cualquier otro backend que hable OpenTelemetry: apunta su exportador de trazas OTLP/HTTP a Sypnia. Mira OpenTelemetry.
  • Aplicaciones móviles hechas como vistas web funcionan con el SDK del navegador.

Los SDK nativos de iOS y Android, y los SDK para Python, PHP, Go y Rust, no están disponibles al lanzar. Están en la página Planeado. Mientras tanto, esos backends envían trazas por OpenTelemetry.

Código abierto y de pago: la versión corta

El motor de Sypnia y Sypnia Cloud, comparados
Motor de SypniaCódigo abierto, en tu propia infraestructuraSypnia CloudServicio pago, con un plan gratis
Qué esEl motor de código abierto: un programa que corres en tu propia infraestructura.El mismo motor, operado por nosotros, más cuentas, cobro, la aplicación completa y la GitHub App.
Cómo lo leesLa API HTTP, el servidor MCP, la CLI y la Consola (una página incluida: lista de problemas y visor de grabaciones).La aplicación completa: reproductor de grabaciones, rendimiento, disponibilidad, resumen diario, búsqueda y equipos.
El análisis del agenteFunciona con tu propia llave de modelo. Apagado hasta que pongas una.Incluido. No necesitas llave.
Pull requestsNo están en el motor. Usa el prompt o el servidor MCP con tu propio agente de código.Los abre la GitHub App de Sypnia.
AlertasQuedan registradas y se envían a un webhook si configuras uno. El despliegue por defecto no envía correo.Por correo y dentro de la aplicación, más un resumen diario por correo.
CostoGratis. Sin límites puestos por nosotros. Pagas tu propia infraestructura.Un plan gratis, y planes de pago desde USD 10 al mes (una propuesta; mira Planes y límites).

La tabla completa está en Código abierto y Sypnia Cloud.

Qué no hace Sypnia

  • No recoge logs, métricas propias ni tableros. Eso está planeado, no disponible.
  • No aprueba ni mezcla código. Un pull request espera a una persona.
  • No envía alertas a WhatsApp ni a Slack. Sypnia Cloud avisa por correo y dentro de la aplicación; el motor registra las alertas y llama a un webhook.
  • No es un tablero en vivo. Un problema nuevo aparece dentro de los 2 minutos siguientes a su primer evento, y los conteos y las cifras de rendimiento están completos dentro de 10 minutos. Cómo funciona tiene los tiempos de cada parte.
  • No graba lo que la gente escribe. Las contraseñas, los números de tarjeta y los códigos de un solo uso nunca se graban, y puedes enmascarar cualquier otra zona. Mira Qué se recoge.

Sigue con

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