Conectați Sentry sau GlitchTip

Sentry și GlitchTip vorbesc amândouă același protocol SDK Sentry. Configurarea din partea Elido este identică pentru oricare dintre ele — singura diferență este DSN-ul pe care îl lipiți.

Acest ghid acoperă două direcții: transmiterea alertelor Elido către instrumentul dumneavoastră de urmărire a erorilor (astfel încât problemele de abuz / TLS / API să apară ca probleme pe care le puteți tria) și folosirea Elido alături de configurația dumneavoastră Sentry existentă, dacă găzduiți deja GlitchTip.

De ce să le conectați

Elido emite evenimente operaționale utile ca probleme Sentry:

• abuse.flagged — scanerul nostru a marcat un URL de destinație ca malware / phishing.
• domain.tls_renewed (varianta de eșec) — Caddy nu a putut reînnoi un certificat TLS.
• webhook.delivery_failed — endpoint-ul dumneavoastră webhook a încetat să răspundă.
• link.clicked.aggregated (varianta de anomalie) — vârf brusc de trafic 10× pe un singur link.

Probabil nu doriți toate ca probleme — alegeți-le pe cele care necesită un răspuns uman.

Adăugați integrarea

1. Dashboard → Integrations → Sentry / GlitchTip.
2. Lipiți DSN-ul dumneavoastră Sentry. DSN-urile GlitchTip folosesc același format și funcționează în același câmp.
3. Alegeți tipurile de evenimente de transmis. Implicit sunt doar abuse.flagged și eșecurile de reînnoire TLS.
4. Faceți clic pe Send test event. Ar trebui să vedeți o „problemă de test” în proiectul dumneavoastră Sentry în decurs de 10 secunde.
5. Save.

Integrarea rulează pe server. Nu încărcăm SDK-ul de browser Sentry în tabloul dumneavoastră de bord — DSN-ul dumneavoastră nu ajunge niciodată la browserul vizitatorului.

Cum arată problema

Fiecare eveniment transmis devine o problemă în format Sentry, cu:

• event_id = ID-ul evenimentului Elido (astfel încât să puteți elimina duplicatele).
• level = error pentru eșecurile de abuz și TLS, warning pentru eșecurile de livrare webhook, info pentru anomaliile de vârf.
• fingerprint = ID-ul workspace-ului + tipul evenimentului + ID-ul resursei relevante, astfel încât reapariția aceleiași probleme se grupează curat în Sentry.
• extra = payload-ul complet al evenimentului Elido.
• tags = workspace, event_kind, plus tag-ul specific resursei (link_slug, domain etc.).

Note despre GlitchTip

GlitchTip implementează API-ul de ingestie a evenimentelor Sentry, dar nu întregul set de funcționalități Sentry. Integrarea trimite evenimente doar prin endpoint-ul de ingestie, astfel încât orice funcționalitate din acel domeniu (gruparea problemelor, amprentele, căutarea, alertarea) funcționează și în GlitchTip. Urmele de performanță, redările (replays) și profilarea nu funcționează, dar Elido oricum nu le trimite.

Dezactivare

Faceți clic pe Disconnect în pagina de integrare. DSN-ul este șters, iar niciun eveniment ulterior nu mai este trimis. Problemele dumneavoastră Sentry existente nu sunt șterse — rămân în proiectul dumneavoastră Sentry.

Limite

• O singură destinație Sentry per workspace. Dacă aveți nevoie să distribuiți către mai multe proiecte Sentry, folosiți webhook-uri și un mic proxy.
• Respectăm limita implicită Sentry de 50/s per proiect. Anomaliile de vârf sunt eșantionate înainte de trimitere pentru a rămâne sub limită.

Depanare

Evenimentul de test sosește, dar cele reale nu. Verificați că ați selectat tipurile corecte de evenimente în setările integrării. Selecția implicită este conservatoare.

Evenimentele sosesc, dar tags sunt goale. Sentry uneori trunchiază valorile tag-urilor mai lungi de 200 de caractere (slug-uri, domenii) — acestea ajung ca unknown. Aceasta este o limită a Sentry, nu a noastră.

Endpoint-ul de ingestie GlitchTip respinge cu 429. Instanța dumneavoastră GlitchTip limitează ratele. Fie măriți limita per proiect din panoul de administrare GlitchTip, fie filtrați tipurile de evenimente doar la cele de care aveți nevoie.

DSN-ul a fost rotit și acum primim erori 401. Actualizați DSN-ul în pagina de integrare. Nu există detectare automată pentru rotația DSN-ului.