Docs

Venir desde Sentry

Cómo se corresponden los conceptos y las llamadas de Sentry con los de Sypnia, qué quitar de tu código, y una lista honesta de lo que todavía no tiene equivalente.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Primero corre los dos
  2. Conceptos
  3. Código
  4. Navegador
  5. Node
  6. Next.js
  7. Source maps
  8. Otros backends
  9. Qué quitar, cuando termines
  10. Lo que todavía no tiene equivalente

Esta guía es para un equipo que usa Sentry en una app web y quiere probar Sypnia, o pasarse. Aplica a Sypnia Cloud y a un motor con alojamiento propio.

Sentry es excelente y amplio. Sypnia es más angosto a propósito: está hecho para decirte en una frase qué anda mal, para quién y cómo arreglarlo, y para entregarle eso a tu agente de código. Algunas cosas que Sentry hace, Sypnia no las hace, y esta página dice cuáles.

Al final tendrás: Sypnia corriendo en tu app, junto a Sentry o en su lugar, y una lista clara de lo que ganas y lo que dejas.

Primero corre los dos

Nada en el SDK de Sypnia choca con el de Sentry. Los dos pueden escuchar errores, los dos pueden agregar encabezados de traza (usan encabezados distintos además del estándar traceparent), y cada uno envía a su propia dirección. Instala Sypnia, compara los dos una o dos semanas con tráfico real, y quita Sentry cuando estés conforme.

Dos cosas que conviene saber mientras corren ambos:

  • Los dos graban sesiones, así que la página paga por dos grabadoras. Apaga la grabación en uno de ellos durante la comparación.
  • Si usas el tunnel de Sentry o una política de seguridad de contenido estricta, agrega también la dirección de Sypnia. Mira Solución de problemas.

Conceptos

En SentryEn SypniaDiferencia
Organización, equipo, miembroLo mismo, solo en Sypnia CloudEl motor con alojamiento propio tiene proyectos y tokens, no usuarios.
ProyectoProyectoUno por app. El frontend y el backend de la misma app comparten proyecto, para que sus trazas se unan.
DSNLlave de ingesta (spk_…)Pública y solo de escritura, como un DSN. La dirección va aparte: la opción endpoint, que solo hace falta con alojamiento propio.
Auth tokenToken de API (sps_…) con permisos read, replay, admin
EnvironmentEntornoLas alertas cubren solo production por defecto.
ReleaseVersión (release)Usa el commit corto de git.
IssueProblemaUn problema se cuenta como una frase: qué pasó, a quién, desde cuándo, la causa probable.
EventOcurrencia de un problemaEn Sypnia, «evento» es cualquier cosa que envía el SDK: un clic, una vista de página, un error.
BreadcrumbsLa línea de tiempo de la sesiónSe registra sin código: páginas, clics en palabras, peticiones, errores.
Session ReplayGrabaciónLo que se escribe siempre se enmascara, sin opción para desenmascarar.
Tracing, spansTrazas, spansSe traza cada petición; no hay tasa de muestreo de trazas.
Web VitalsRendimientoCon el elemento detrás de cada valor.
User Feedback, Crons, Profiling, Logs, MetricsSin equivalenteMira la última sección.
Seer, AutofixEl agente, el prompt, MCP, pull requestsLos pull requests están en Sypnia Cloud.

Código

src/main.ts
- import * as Sentry from '@sentry/browser';
+ import { init } from '@sypnia/browser';

- Sentry.init({
-   dsn: 'https://abc123@o123456.ingest.sentry.io/7890123',
-   environment: 'production',
-   release: '4f2a91c',
-   integrations: [Sentry.browserTracingIntegration(), Sentry.replayIntegration()],
-   tracesSampleRate: 0.2,
-   replaysSessionSampleRate: 0.1,
-   replaysOnErrorSampleRate: 1.0,
- });
+ init({
+   project: 'spk_7d1f0c9e4b8a2f6d3c5e1a9b0f4d8c2e',
+   environment: 'production',
+   release: '4f2a91c',
+ });

No hay integraciones que listar ni tasas de muestreo en el código: los errores, los clics, las peticiones, el rendimiento y la grabación vienen encendidos, y la parte de las sesiones que se graba es un ajuste del proyecto (10 % por defecto, más toda sesión donde algo sale mal).

SentrySypniaNotas
Sentry.init({ dsn })init({ project })Todas las opciones.
Sentry.captureException(error)reportError(error)
Sentry.captureMessage(text)track(name, props), o reportError(new Error(text))Un mensaje que no es un fallo es un evento propio.
Sentry.setUser({ id, email, username })identify({ person: { id, email, name } })Más una account opcional. Sentry.setUser(null) es identify(null).
Sentry.addBreadcrumb(…)Casi siempre nada. track(name, props) para lo que Sypnia no puede ver.Los clics, las navegaciones y las peticiones ya están en la línea de tiempo.
Sentry.setTag, setContext, setExtra, withScopeSin equivalenteMira abajo.
beforeSendbeforeSendSe llama para todo evento, no solo para errores.
ignoreErrorsignoreErrors
denyUrls, allowUrlsappFramesLos errores de scripts de otros orígenes se descartan por defecto; appFrames nombra tu CDN.
tracePropagationTargetstraceTargetsTu propio origen siempre está incluido.
tunnelendpoint con una ruta de tu propio dominioLa ruta de reenvío la escribes tú.
replayIntegration({ maskAllText, blockAllMedia })maskAllText, data-sypnia-mask, data-sypnia-blockEl texto de la página se graba como se ve por defecto; lo que se escribe, nunca. Si dependías de que Sentry enmascara todo el texto por defecto, pon maskAllText: true.
Sentry.ErrorBoundaryTu propio límite de errores que llama a reportError(error, { source: 'boundary' })Ejemplo.
Sentry.showReportDialogSin equivalente

Node

src/instrument.ts
- import * as Sentry from '@sentry/node';
+ import { init } from '@sypnia/node';

- Sentry.init({ dsn: process.env.SENTRY_DSN, tracesSampleRate: 0.2 });
+ init({ project: process.env.SYPNIA_PROJECT_KEY, service: 'shop-api' });
SentrySypniaNotas
Sentry.setupExpressErrorHandler(app)Un middleware que llama a reportError(error) y a next(error)Por framework.
Sentry.startSpan({ name }, fn)span(name, fn)
Sentry.flush(ms), Sentry.close(ms)flush(ms), shutdown(ms)
Instrumentación automática de muchas libreríashttp, fetch, pg, Supabase y PostgREST al lanzarPara otras usa span(), o instrumentaciones de OpenTelemetry con la entrada OTLP.

Next.js

SentrySypnia
withSentryConfig(nextConfig, options)withSypnia(nextConfig, options)
sentry.client.config.ts / instrumentation-client.tsinstrumentation-client.ts, tres líneas
sentry.server.config.ts, sentry.edge.config.ts, instrumentation.tsinstrumentation.ts, una línea. El runtime Edge no se cubre al lanzar.
global-error.tsx con Sentry.captureExceptionEl mismo archivo con reportError(error, { source: 'boundary', digest: error.digest })
SENTRY_AUTH_TOKEN al compilarSYPNIA_API_TOKEN al compilar

La configuración completa está en Next.js.

Source maps

Script de compilación
- sentry-cli sourcemaps inject dist && sentry-cli sourcemaps upload --release "$RELEASE" dist
+ npx sypnia sourcemaps upload dist --release "$RELEASE" --delete-after

Sypnia no inyecta ids en tus archivos: empareja un marco de la pila con su source map por la versión y la ruta del archivo. Quita los plugins del empaquetador (@sentry/vite-plugin, @sentry/webpack-plugin) cuando quites Sentry. Mira Source maps en CI.

Otros backends

Si tus servicios en Python, Go, PHP, Rust o Java reportan a Sentry con sus SDK, la respuesta de Sypnia hoy es OpenTelemetry: agrega el SDK de OpenTelemetry del lenguaje y apunta su exportador a Sypnia. Los SDK nativos de Sypnia para estos lenguajes están Planeado. Mira OpenTelemetry.

Qué quitar, cuando termines

  1. Los paquetes: @sentry/browser, @sentry/react, @sentry/node, @sentry/nextjs, los plugins del empaquetador, @sentry/cli.
  2. Cada llamada Sentry.. La mayoría desaparece en vez de reemplazarse: addBreadcrumb, setTag, setContext, la lista de integraciones.
  3. Los archivos de configuración sentry.*.config.ts y .sentryclirc, y withSentryConfig.
  4. Las variables SENTRY_DSN, SENTRY_AUTH_TOKEN, SENTRY_ORG, SENTRY_PROJECT de tu proveedor y de tu CI.
  5. Los hosts de Sentry de tu política de seguridad de contenido, y la ruta de tunnel si tenías una.

Lo que todavía no tiene equivalente

Dicho sin rodeos, para que decidas:

En SentryEn Sypnia
Etiquetas, contextos, datos extra y scopes en un errorNo al lanzar. Un error lleva su sesión, persona, cuenta, versión, ruta y traza. Pon tus propios datos en un evento track() junto a él, o cambia el evento en beforeSend.
Búsqueda y vistas guardadas sobre etiquetas arbitrarias; Discover; tablerosNo al lanzar. Las métricas propias y los tableros están Planeado.
SDK nativos: iOS, Android, React Native, Flutter, Unity, escritorioPlaneado para iOS y Android. Las vistas web funcionan con el SDK del navegador.
SDK para Python, PHP, Go, Rust, Ruby, Java, .NETPlaneado para Python, PHP, Go y Rust. Hoy: trazas por OpenTelemetry.
LogsPlaneado
ProfilingNo.
Monitoreo de tareas programadas (crons)No. Los chequeos de disponibilidad te dicen que una URL dejó de responder, no que una tarea no corrió.
Widget de comentarios de usuariosNo.
Adjuntos, minidumps, simbolización de fallos nativosNo.
Muestreo de trazas en el SDKNo: se traza cada petición. Usa ignoreRoutes para dejar rutas fuera; el muestreo de peticiones exitosas está Planeado.
Reglas de alerta con muchas condiciones; integraciones con herramientas de chat y de ticketsSypnia tiene un conjunto fijo de alertas con umbrales que puedes ajustar. Llegan por correo y dentro de la app en Sypnia Cloud, y por webhook en cualquier motor. No hay integraciones de chat ni de tickets: construye sobre el webhook.
Asignación de issues, reglas de propiedad, code ownersNo. Un problema está abierto, resuelto o ignorado.
Inicio de sesión único (SSO)Planeado
Importar tu historial desde SentryNo. Sypnia empieza el día que lo instalas.

Lo que recibes a cambio está en Qué es Sypnia: problemas como frases, el elemento detrás de las páginas lentas, clics de rabia y clics muertos, y el arreglo entregado a tu agente de código como prompt, por MCP o como pull request.

La lista completa de lo planeado, sin fechas, está en Planeado.

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