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.
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
tunnelde 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 Sentry | En Sypnia | Diferencia |
|---|---|---|
| Organización, equipo, miembro | Lo mismo, solo en Sypnia Cloud | El motor con alojamiento propio tiene proyectos y tokens, no usuarios. |
| Proyecto | Proyecto | Uno por app. El frontend y el backend de la misma app comparten proyecto, para que sus trazas se unan. |
| DSN | Llave 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 token | Token de API (sps_…) con permisos read, replay, admin | |
| Environment | Entorno | Las alertas cubren solo production por defecto. |
| Release | Versión (release) | Usa el commit corto de git. |
| Issue | Problema | Un problema se cuenta como una frase: qué pasó, a quién, desde cuándo, la causa probable. |
| Event | Ocurrencia de un problema | En Sypnia, «evento» es cualquier cosa que envía el SDK: un clic, una vista de página, un error. |
| Breadcrumbs | La línea de tiempo de la sesión | Se registra sin código: páginas, clics en palabras, peticiones, errores. |
| Session Replay | Grabación | Lo que se escribe siempre se enmascara, sin opción para desenmascarar. |
| Tracing, spans | Trazas, spans | Se traza cada petición; no hay tasa de muestreo de trazas. |
| Web Vitals | Rendimiento | Con el elemento detrás de cada valor. |
| User Feedback, Crons, Profiling, Logs, Metrics | Sin equivalente | Mira la última sección. |
| Seer, Autofix | El agente, el prompt, MCP, pull requests | Los pull requests están en Sypnia Cloud. |
Código
Navegador
- 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).
| Sentry | Sypnia | Notas |
|---|---|---|
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, withScope | Sin equivalente | Mira abajo. |
beforeSend | beforeSend | Se llama para todo evento, no solo para errores. |
ignoreErrors | ignoreErrors | |
denyUrls, allowUrls | appFrames | Los errores de scripts de otros orígenes se descartan por defecto; appFrames nombra tu CDN. |
tracePropagationTargets | traceTargets | Tu propio origen siempre está incluido. |
tunnel | endpoint con una ruta de tu propio dominio | La ruta de reenvío la escribes tú. |
replayIntegration({ maskAllText, blockAllMedia }) | maskAllText, data-sypnia-mask, data-sypnia-block | El 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.ErrorBoundary | Tu propio límite de errores que llama a reportError(error, { source: 'boundary' }) | Ejemplo. |
Sentry.showReportDialog | Sin equivalente |
Node
- 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' });| Sentry | Sypnia | Notas |
|---|---|---|
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ías | http, fetch, pg, Supabase y PostgREST al lanzar | Para otras usa span(), o instrumentaciones de OpenTelemetry con la entrada OTLP. |
Next.js
| Sentry | Sypnia |
|---|---|
withSentryConfig(nextConfig, options) | withSypnia(nextConfig, options) |
sentry.client.config.ts / instrumentation-client.ts | instrumentation-client.ts, tres líneas |
sentry.server.config.ts, sentry.edge.config.ts, instrumentation.ts | instrumentation.ts, una línea. El runtime Edge no se cubre al lanzar. |
global-error.tsx con Sentry.captureException | El mismo archivo con reportError(error, { source: 'boundary', digest: error.digest }) |
SENTRY_AUTH_TOKEN al compilar | SYPNIA_API_TOKEN al compilar |
La configuración completa está en Next.js.
Source maps
- sentry-cli sourcemaps inject dist && sentry-cli sourcemaps upload --release "$RELEASE" dist
+ npx sypnia sourcemaps upload dist --release "$RELEASE" --delete-afterSypnia 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
- Los paquetes:
@sentry/browser,@sentry/react,@sentry/node,@sentry/nextjs, los plugins del empaquetador,@sentry/cli. - Cada llamada
Sentry.. La mayoría desaparece en vez de reemplazarse:addBreadcrumb,setTag,setContext, la lista de integraciones. - Los archivos de configuración
sentry.*.config.tsy.sentryclirc, ywithSentryConfig. - Las variables
SENTRY_DSN,SENTRY_AUTH_TOKEN,SENTRY_ORG,SENTRY_PROJECTde tu proveedor y de tu CI. - Los hosts de Sentry de tu política de seguridad de contenido, y la ruta de
tunnelsi tenías una.
Lo que todavía no tiene equivalente
Dicho sin rodeos, para que decidas:
| En Sentry | En Sypnia |
|---|---|
| Etiquetas, contextos, datos extra y scopes en un error | No 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; tableros | No al lanzar. Las métricas propias y los tableros están Planeado. |
| SDK nativos: iOS, Android, React Native, Flutter, Unity, escritorio | Planeado para iOS y Android. Las vistas web funcionan con el SDK del navegador. |
| SDK para Python, PHP, Go, Rust, Ruby, Java, .NET | Planeado para Python, PHP, Go y Rust. Hoy: trazas por OpenTelemetry. |
| Logs | Planeado |
| Profiling | No. |
| 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 usuarios | No. |
| Adjuntos, minidumps, simbolización de fallos nativos | No. |
| Muestreo de trazas en el SDK | No: 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 tickets | Sypnia 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 owners | No. Un problema está abierto, resuelto o ignorado. |
| Inicio de sesión único (SSO) | Planeado |
| Importar tu historial desde Sentry | No. 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.