Sentry und GlitchTip sprechen beide dasselbe Sentry-SDK-Protokoll. Die Elido-Seite ist für beides dieselbe Konfiguration — der einzige Unterschied ist der DSN, den Sie einfügen.
Dieser Leitfaden behandelt zwei Richtungen: Elido-Benachrichtigungen in Ihren Error-Tracker einzuspeisen (damit Missbrauch / TLS / API-Probleme als Issues erscheinen, die Sie triage können), und Elido neben Ihrem bestehenden Sentry-Setup zu verwenden, wenn Sie GlitchTip bereits selbst hosten.
Warum verbinden#
Elido gibt operative Ereignisse aus, die als Sentry-Issues nützlich sind:
abuse.flagged— unser Scanner hat eine Ziel-URL als Malware / Phishing markiert.domain.tls_renewed(Fehlervariante) — Caddy konnte ein TLS-Zertifikat nicht erneuern.webhook.delivery_failed— Ihr eigener Webhook-Endpunkt hat aufgehört zu antworten.link.clicked.aggregated(Anomalievariante) — plötzlicher 10×-Traffic-Spike bei einem einzelnen Link.
Sie möchten wahrscheinlich nicht alle davon als Issues — wählen Sie die aus, die eine menschliche Reaktion erfordern.
Integration hinzufügen#
- Dashboard → Integrationen → Sentry / GlitchTip.
- Fügen Sie Ihren Sentry-DSN ein. GlitchTip-DSNs verwenden dasselbe Format und funktionieren im selben Feld.
- Wählen Sie die weiterzuleitenden Ereignistypen. Standard ist nur
abuse.flaggedund TLS-Erneuerungsfehler. - Klicken Sie auf Testereignis senden. Sie sollten innerhalb von 10 Sekunden ein "Test-Issue" in Ihrem Sentry-Projekt sehen.
- Speichern.
Die Integration läuft serverseitig. Wir laden das Sentry-Browser-SDK nicht in Ihr Dashboard — Ihr DSN gelangt nie in den Browser des Besuchers.
Wie das Issue aussieht#
Jedes weitergeleitete Ereignis wird zu einem Sentry-formatierten Issue mit:
event_id= Elido-Ereignis-ID (zum De-Duplizieren).level=errorfür Missbrauch + TLS-Fehler,warningfür Webhook-Lieferfehler,infofür Spike-Anomalien.fingerprint= Workspace-ID + Ereignistyp + relevante Ressourcen-ID, sodass erneute Auslösungen desselben Issues in Sentry sauber gruppiert werden.extra= vollständige Elido-Ereignis-Nutzlast.tags=workspace,event_kind, plus das ressourcenspezifische Tag (link_slug,domain, usw.).
GlitchTip-Hinweise#
GlitchTip implementiert die Sentry-Ereignis-Ingestion-API, aber nicht den vollständigen Sentry-Funktionsumfang. Die Integration sendet Ereignisse nur über den Ingestion-Endpunkt, sodass alle Features in diesem Bereich (Issue-Gruppierung, Fingerprints, Suche, Alerting) auch in GlitchTip funktionieren. Performance Traces, Replays und Profiling nicht, aber Elido sendet diese sowieso nicht.
Wenn Sie GlitchTip hinter einem privaten Netzwerk selbst hosten, geben Sie den Elido-Egress-IPs HTTP-Zugriff. Die vollständige Liste befindet sich auf unserer Trust-Seite; kurz gesagt: 5.75.0.0/16 (Hetzner FRA) und 51.79.0.0/16 (OVH SGP).
Deaktivieren#
Klicken Sie auf Trennen auf der Integrationsseite. Der DSN wird gelöscht und keine weiteren Ereignisse werden gesendet. Ihre bestehenden Sentry-Issues werden nicht gelöscht — sie verbleiben in Ihrem Sentry-Projekt.
Limits#
- 1 Sentry-Ziel pro Workspace. Wenn Sie an mehrere Sentry-Projekte weiterleiten müssen, verwenden Sie Webhooks und einen kleinen Proxy.
- Wir respektieren Sentrys Standard-Rate-Limit von 50/s pro Projekt. Spike-Anomalien werden vor dem Senden gesampelt, um unter dem Limit zu bleiben.
Fehlerbehebung#
Testereignis kommt an, aber echte Ereignisse nicht. Stellen Sie sicher, dass Sie in den Integrationseinstellungen die richtigen Ereignistypen ausgewählt haben. Die Standardauswahl ist konservativ.
Ereignisse kommen an, aber tags sind leer. Sentry kürzt manchmal Tag-Werte, die länger als 200 Zeichen sind (Slugs, Domains) — sie landen als unknown. Dies ist ein Sentry-Limit, nicht unseres.
GlitchTip-Ingest-Endpunkt lehnt mit 429 ab. Ihre GlitchTip-Instanz drosselt. Erhöhen Sie entweder das pro-Projekt-Limit in GlitchTips Admin oder filtern Sie die Ereignistypen auf die herunter, die Sie benötigen.
DSN wurde rotiert und jetzt erhalten wir 401s. Aktualisieren Sie den DSN auf der Integrationsseite. Es gibt keine automatische Erkennung für DSN-Rotation.