Migrar tus proyectos de Sentry a GlitchTip en menos de una hora

En agosto de 2026, tres issues acumularon suficientes reportes en el repositorio getsentry/self-hosted para constituir una señal de migración clara. El issue #4301 documenta un deadlock del consumidor Kafka ingest-monitors tras actualizar a 26.4.1: el grupo de consumidores permanece unido pero CURRENT-OFFSET deja de avanzar. La consecuencia directa es que todos los monitores de crons cambian a estado de error con backfill perdido, y la función Crons queda inoperativa a nivel de toda la organización. El problema solo se manifiesta en instancias con datos acumulados (más de 1,2 millones de filas en sentry_monitorcheckin). El issue #4306 informa que todos los consumidores de Snuba imprimen en bucle el error 'Failed to read directory /etc/sentry-options/values' — cerrado sin corrección oficial con el estado 'not planned'. El issue #4321 afecta a la versión 26.4.2: los contenedores seaweedfs-1 y web-1 se reportan como unhealthy al iniciar en instalaciones x86_64, impidiendo arrancar Sentry de forma fiable. Estas tres regresiones combinadas forman un argumento sólido para salir del ciclo de actualizaciones de Sentry self-hosted, al menos temporalmente.

Esta guía asume que GlitchTip ya está desplegado y en funcionamiento en tu VPS. Si no es así, consulta primero el artículo 'Autoalojar GlitchTip v6 en VPS con Docker Compose'. Para la migración en sí, necesitas tres cosas concretas: acceso de administrador a tu instancia Sentry self-hosted (para leer los DSN existentes y exportar la configuración de alertas), acceso de administrador a tu instancia GlitchTip (para crear los proyectos equivalentes y obtener los nuevos DSN), y la lista de variables de entorno o archivos de configuración de cada aplicación que contiene el valor SENTRY_DSN o equivalente. La migración se realiza proyecto a proyecto. Si tienes cinco proyectos en Sentry, crearás cinco en GlitchTip y cambiarás cinco variables. Reserva unos diez minutos por proyecto la primera vez; los siguientes toman dos o tres minutos cada uno.

GlitchTip no reimplementa los SDK: consume el mismo protocolo de red que Sentry, lo que significa que cualquier SDK oficial de Sentry funciona sin modificación. Los lenguajes y frameworks más comunes están cubiertos de forma nativa. En Python, sentry-sdk se integra con Django, Flask, FastAPI y Celery. En JavaScript y TypeScript, @sentry/browser, @sentry/node, @sentry/nextjs y @sentry/vue funcionan directamente. En Ruby están soportados sentry-rails y sentry-ruby. Go tiene getsentry/sentry-go. PHP puede usar sentry/sentry-laravel o sentry/sentry-symfony. Java y Android tienen sus SDK oficiales. La única opción que hay que desactivar en algunos SDK es auto_session_tracking — GlitchTip no soporta el seguimiento de sesiones en tiempo real, pero esto no afecta al reporte de errores.

Los eventos no llegan a GlitchTip. Primero verifica que el DSN sea sintácticamente correcto: la forma esperada es https://<key>@your-domain.com/<id>. Si tu instancia de GlitchTip está detrás de un reverse proxy, asegúrate de que las cabeceras X-Forwarded-For y X-Forwarded-Proto se transmiten — un proxy mal configurado puede devolver errores 400 o 413 silenciosos en el lado de la aplicación. Revisa los logs del contenedor GlitchTip (docker compose logs web) para confirmar la recepción. El DSN es rechazado con error 401 o 403. Lo más habitual es que la clave pública del DSN no coincida con el proyecto de GlitchTip de destino. Verifica que copiaste el DSN desde el proyecto correcto. La agrupación de errores no se parece a Sentry. GlitchTip usa su propio algoritmo de fingerprinting. Los errores del mismo tipo se agruparán, pero la correspondencia con los grupos de Sentry no está garantizada, especialmente para excepciones con stacktraces dinámicos. Es un comportamiento esperado, no un error.

Si aún no tienes una instancia de GlitchTip en producción y quieres salir de Sentry self-hosted sin pasarte a otra herramienta compleja de operar, un VPS de 2 GB de RAM es suficiente para ejecutar GlitchTip v6 en configuración todo-en-uno. La instalación completa — Docker Compose, nginx como reverse proxy, certificado TLS, variables de entorno — está documentada en el artículo dedicado. Una vez lista la instancia, la migración desde Sentry sigue el procedimiento descrito en este artículo: crear proyectos, obtener DSN, intercambiar variables. El tiempo total desde la creación del VPS hasta recibir el primer evento en GlitchTip es generalmente inferior a una hora, incluyendo la instalación y la migración de dos o tres proyectos.