Connecter Sentry ou GlitchTip

Sentry et GlitchTip parlent tous deux le même protocole SDK Sentry. La configuration côté Elido est identique pour les deux — la seule différence est le DSN que vous collez.

Ce guide couvre deux directions : canaliser les alertes Elido dans votre error tracker (pour que les problèmes d'abus / TLS / API apparaissent comme des issues à trier), et utiliser Elido à côté de votre configuration Sentry existante si vous auto-hébergez déjà GlitchTip.

Pourquoi les connecter#

Elido émet des événements opérationnels utiles comme issues Sentry :

abuse.flagged — notre scanner a marqué une URL de destination comme malware / phishing.
domain.tls_renewed (variante échec) — Caddy n'a pas pu renouveler un certificat TLS.
webhook.delivery_failed — votre propre endpoint webhook a cessé de répondre.
link.clicked.aggregated (variante anomalie) — pic de trafic soudain de 10× sur un seul lien.

Vous ne voudrez probablement pas tous les recevoir comme issues — choisissez ceux qui nécessitent une intervention humaine.

Ajouter l'intégration#

Dashboard → Intégrations → Sentry / GlitchTip.
Collez votre DSN Sentry. Les DSNs GlitchTip utilisent le même format et fonctionnent dans le même champ.
Choisissez les types d'événements à transférer. Par défaut, seuls abuse.flagged et les échecs de renouvellement TLS.
Cliquez sur Envoyer un événement test. Vous devriez voir une "issue de test" dans votre projet Sentry dans les 10 secondes.
Enregistrer.

L'intégration fonctionne côté serveur. Nous ne chargeons pas le SDK navigateur Sentry dans votre tableau de bord — votre DSN n'atteint jamais le navigateur du visiteur.

À quoi ressemble l'issue#

Chaque événement transféré devient une issue au format Sentry avec :

event_id = ID d'événement Elido (pour la déduplication).
level = error pour les abus + échecs TLS, warning pour les échecs de livraison webhook, info pour les anomalies de pic.
fingerprint = ID workspace + type d'événement + ID de ressource pertinent, de sorte que les ré-occurrences de la même issue se regroupent proprement dans Sentry.
extra = charge utile complète de l'événement Elido.
tags = workspace, event_kind, plus le tag spécifique à la ressource (link_slug, domain, etc.).

Notes GlitchTip#

GlitchTip implémente l'API d'ingestion d'événements Sentry mais pas l'ensemble complet des fonctionnalités Sentry. L'intégration envoie uniquement des événements via l'endpoint d'ingestion, donc toute fonctionnalité dans cette portée (groupement d'issues, fingerprints, recherche, alerting) fonctionne également dans GlitchTip. Les traces de performance, les replays et le profiling non, mais Elido ne les envoie pas de toute façon.

Si vous auto-hébergez GlitchTip derrière un réseau privé, donnez aux IPs de sortie d'Elido l'accès HTTP. La liste complète est sur notre page trust ; en bref : 5.75.0.0/16 (Hetzner FRA) et 51.79.0.0/16 (OVH SGP).

Désactiver#

Cliquez sur Déconnecter sur la page d'intégration. Le DSN est effacé et plus aucun événement n'est envoyé. Vos issues Sentry existantes ne sont pas supprimées — elles restent dans votre projet Sentry.

Limites#

1 destination Sentry par workspace. Si vous avez besoin de redistribuer vers plusieurs projets Sentry, utilisez les webhooks et un petit proxy.
Nous respectons la limite de débit par défaut de Sentry de 50/s par projet. Les anomalies de pic sont échantillonnées avant envoi pour rester sous la limite.

Résolution des problèmes#

L'événement test arrive mais pas les vrais événements. Vérifiez que vous avez sélectionné les bons types d'événements dans les paramètres d'intégration. La sélection par défaut est conservatrice.

Les événements arrivent mais tags sont vides. Sentry tronque parfois les valeurs de tags de plus de 200 caractères (slugs, domaines) — ils finissent comme unknown. C'est une limite Sentry, pas la nôtre.

L'endpoint d'ingestion GlitchTip rejette avec 429. Votre instance GlitchTip applique un rate limiting. Soit augmentez la limite par projet dans l'admin GlitchTip, soit filtrez les types d'événements à ceux dont vous avez besoin.

Le DSN a été renouvelé et maintenant on reçoit des 401. Mettez à jour le DSN sur la page d'intégration. Il n'y a pas de détection automatique pour la rotation du DSN.