Sentry of GlitchTip verbinden

Sentry en GlitchTip spreken beide hetzelfde Sentry-SDK-protocol. Aan de kant van Elido is de configuratie voor beide gelijk — het enige verschil is de DSN die je plakt.

Deze handleiding behandelt twee richtingen: Elido-meldingen doorsturen naar je errortracker (zodat misbruik-/TLS-/API-problemen als issues verschijnen die je kunt triëren), en Elido gebruiken naast je bestaande Sentry-opzet als je al zelf GlitchTip host.

Waarom verbinden

Elido genereert operationele gebeurtenissen die nuttig zijn als Sentry-issues:

• abuse.flagged — onze scanner markeerde een bestemmings-URL als malware/phishing.
• domain.tls_renewed (foutvariant) — Caddy kon een TLS-certificaat niet vernieuwen.
• webhook.delivery_failed — je eigen webhookendpoint reageerde niet meer.
• link.clicked.aggregated (anomaliëvariant) — plotselinge verkeerspiek van 10× op één link.

Je wilt waarschijnlijk niet alles als issue — kies de gebeurtenissen die een menselijke reactie vereisen.

De integratie toevoegen

1. Dashboard → Integrations → Sentry / GlitchTip.
2. Plak je Sentry-DSN. GlitchTip-DSN's gebruiken hetzelfde formaat en werken in hetzelfde veld.
3. Kies de gebeurtenistypes die worden doorgestuurd. Standaard zijn dit alleen abuse.flagged en TLS-vernieuwingsfouten.
4. Klik op Send test event. Je zou binnen 10 seconden een "test issue" moeten zien in je Sentry-project.
5. Opslaan.

De integratie draait server-side. We laden de Sentry-browser-SDK niet in je dashboard — je DSN bereikt nooit de browser van de bezoeker.

Hoe de issue eruitziet

Elke doorgestuurde gebeurtenis wordt een Sentry-geformatteerde issue met:

• event_id = Elido-gebeurtenis-ID (zodat je kunt dedupliceren).
• level = error voor misbruik- en TLS-fouten, warning voor webhookbezorgingsfouten, info voor piekanomalieën.
• fingerprint = workspace-ID + gebeurtenistype + relevante resource-ID, zodat herhalingen van dezelfde issue netjes worden gegroepeerd in Sentry.
• extra = volledige Elido-gebeurtenispayload.
• tags = workspace, event_kind, plus de resourcespecifieke tag (link_slug, domain, enz.).

GlitchTip-opmerkingen

GlitchTip implementeert de Sentry-API voor gebeurtenisinname, maar niet de volledige feature-set van Sentry. De integratie verstuurt gebeurtenissen alleen via het inname-endpoint, dus elke functie binnen dat bereik (issuegroepering, fingerprints, zoeken, alerting) werkt ook in GlitchTip. Performancetraces, replays en profiling niet, maar die stuurt Elido toch niet.

Uitschakelen

Klik op Disconnect op de integratiepagina. De DSN wordt gewist en er worden geen verdere gebeurtenissen verstuurd. Je bestaande Sentry-issues worden niet verwijderd — ze blijven in je Sentry-project staan.

Limieten

• 1 Sentry-bestemming per workspace. Moet je uitwaaieren naar meerdere Sentry-projecten, gebruik dan webhooks en een kleine proxy.
• We respecteren de standaard rate limit van Sentry van 50/s per project. Piekanomalieën worden vóór verzending bemonsterd om onder de limiet te blijven.

Probleemoplossing

Testgebeurtenis komt aan, maar echte gebeurtenissen niet. Controleer of je de juiste gebeurtenistypes hebt geselecteerd in de integratie-instellingen. De standaardselectie is behoudend.

Gebeurtenissen komen aan, maar tags zijn leeg. Sentry knipt soms tagwaarden langer dan 200 tekens af (slugs, domeinen) — ze eindigen dan als unknown. Dit is een beperking van Sentry, niet van ons.

GlitchTip-inname-endpoint weigert met 429. Je GlitchTip-instantie rate-limit je verzoeken. Verhoog de limiet per project in het beheerpaneel van GlitchTip, of beperk de gebeurtenistypes tot wat je nodig hebt.

DSN is gewijzigd en nu krijgen we 401's. Werk de DSN bij op de integratiepagina. Er is geen automatische detectie voor DSN-wijzigingen.