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 su rastreador de errores (para que los problemas de abuso, TLS o API aparezcan como issues que puede clasificar), y usar Elido junto a su configuración existente de Sentry si ya aloja GlitchTip por su 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 — su 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á todos como issues — elija los que requieren intervención humana.

Añadir la integración#

1. Dashboard → Integrations → Sentry / GlitchTip.
2. Pegue su DSN de Sentry. Los DSN de GlitchTip tienen el mismo formato y funcionan en el mismo campo.
3. Elija los tipos de evento a reenviar. Por defecto, solo abuse.flagged y los fallos de renovación TLS.
4. Haga clic en Send test event. Debería ver un "issue de prueba" en su 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 su dashboard — su 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.

Si aloja GlitchTip detrás de una red privada, conceda a las IPs de salida de Elido acceso HTTP. La lista completa está en nuestra página de confianza; en resumen: 5.75.0.0/16 (Hetzner FRA) y 51.79.0.0/16 (OVH SGP).

Desactivar#

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

Límites#

• 1 destino Sentry por workspace. Si necesita enviar a varios proyectos de Sentry, use 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. Compruebe que ha 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. Su instancia de GlitchTip está limitando la frecuencia. Aumente el límite por proyecto en el admin de GlitchTip, o filtre los tipos de evento que necesita.

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