Conectar Sentry o GlitchTip

Sentry y GlitchTip utilizan el mismo protocolo de SDK de Sentry. La configuración del lado de Elido es la misma para ambos — la única diferencia es el DSN que se pega.

Esta guía cubre dos direcciones: canalizar alertas de Elido hacia tu rastreador de errores (para que los problemas de abuso, TLS o API aparezcan como issues que puedes clasificar), y usar Elido junto a tu configuración existente de Sentry si ya alojas GlitchTip por tu cuenta.

Por qué conectarlos

Elido emite eventos operativos que son útiles como issues de Sentry:

• abuse.flagged — nuestro escáner marcó una URL de destino como malware/phishing.
• domain.tls_renewed (variante de fallo) — Caddy no pudo renovar un certificado TLS.
• webhook.delivery_failed — tu propio endpoint de webhook dejó de responder.
• link.clicked.aggregated (variante de anomalía) — pico repentino de tráfico 10× en un solo enlace.

Probablemente no querrás todos como issues — elige los que requieren intervención humana.

Añadir la integración

1. Dashboard → Integrations → Sentry / GlitchTip.
2. Pega tu DSN de Sentry. Los DSN de GlitchTip tienen el mismo formato y funcionan en el mismo campo.
3. Elige los tipos de evento a reenviar. Por defecto, solo abuse.flagged y los fallos de renovación TLS.
4. Haz clic en Send test event. Deberías ver un "issue de prueba" en tu proyecto de Sentry en 10 segundos.
5. Save.

La integración funciona del lado del servidor. No cargamos el SDK del navegador de Sentry en tu dashboard — tu DSN nunca llega al navegador del visitante.

Cómo se ve el issue

Cada evento reenviado se convierte en un issue con formato de Sentry con:

• event_id = ID de evento de Elido (para deduplicación).
• level = error para abuso y fallos TLS, warning para fallos en la entrega de webhooks, info para anomalías de pico.
• fingerprint = workspace ID + tipo de evento + ID del recurso relevante, para que los reenvíos del mismo issue se agrupen correctamente en Sentry.
• extra = payload completo del evento de Elido.
• tags = workspace, event_kind, más la etiqueta específica del recurso (link_slug, domain, etc.).

Notas sobre GlitchTip

GlitchTip implementa la API de ingesta de eventos de Sentry pero no el conjunto completo de funciones de Sentry. La integración solo envía eventos a través del endpoint de ingesta, por lo que cualquier función en ese ámbito (agrupación de issues, fingerprints, búsqueda, alertas) también funciona en GlitchTip. Las trazas de rendimiento, las repeticiones y el profiling no funcionan, pero Elido no los envía de todas formas.

Desactivar

Haz clic en Disconnect en la página de integración. El DSN se elimina y no se envían más eventos. Tus issues existentes en Sentry no se eliminan — permanecen en tu proyecto de Sentry.

Límites

• 1 destino Sentry por workspace. Si necesitas enviar a varios proyectos de Sentry, usa webhooks y un pequeño proxy.
• Respetamos el límite de frecuencia predeterminado de 50/s por proyecto de Sentry. Las anomalías de pico se muestrean antes del envío para mantenerse por debajo del límite.

Solución de problemas

El evento de prueba llega pero los eventos reales no. Comprueba que has seleccionado los tipos de evento correctos en la configuración de la integración. La selección predeterminada es conservadora.

Los eventos llegan pero tags están vacíos. Sentry a veces trunca los valores de etiquetas de más de 200 caracteres (slugs, dominios) — aparecen como unknown. Este es un límite de Sentry, no nuestro.

El endpoint de ingesta de GlitchTip responde con 429. Tu instancia de GlitchTip está limitando la frecuencia. Aumenta el límite por proyecto en el admin de GlitchTip, o filtra los tipos de evento que necesitas.

El DSN fue rotado y ahora recibimos 401. Actualiza el DSN en la página de integración. No hay detección automática para la rotación de DSN.