Co połączysz
- Twój projekt Sentry lub GlitchTip przy użyciu DSN — to samo pole działa dla obu usług.
- Wybrane typy zdarzeń Elido (flagi nadużyć, awarie TLS, błędy dostarczania webhooków, anomalie skoków ruchu) przekazywane jako zgłoszenia Sentry.
- Czyste grupowanie zgłoszeń przez fingerprints oparte na ID workspace, typie zdarzenia i ID zasobu.
Sentry i GlitchTip obsługują ten sam protokół Sentry SDK. Konfiguracja po stronie Elido jest identyczna dla obu — jedyną różnicą jest DSN, który wklejasz.
Ten przewodnik obejmuje dwa kierunki: kierowanie alertów Elido do Twojego trackera błędów (żeby problemy z nadużyciami / TLS / API pojawiały się jako zgłoszenia do triażu) oraz używanie Elido obok istniejącej konfiguracji Sentry jeśli już samodzielnie hostujesz GlitchTip.
Dlaczego je łączyć
Elido emituje zdarzenia operacyjne przydatne jako zgłoszenia Sentry:
abuse.flagged— nasz skaner oznaczył docelowy URL jako malware / phishing.domain.tls_renewed(wariant failure) — Caddy nie mógł odnowić certyfikatu TLS.webhook.delivery_failed— Twój endpoint webhooka przestał odpowiadać.link.clicked.aggregated(wariant anomalii) — nagły 10× skok ruchu na jednym linku.
Prawdopodobnie nie chcesz wszystkich jako zgłoszeń — wybierz te, które wymagają ludzkiej odpowiedzi.
Dodaj integrację
- Dashboard → Integracje → Sentry / GlitchTip.
- Wklej swój Sentry DSN. DSN-y GlitchTip używają tego samego formatu i działają w tym samym polu.
- Wybierz typy zdarzeń do przekazywania. Domyślnie to tylko
abuse.flaggedi failure odnowienia TLS. - Kliknij Wyślij zdarzenie testowe. Powinieneś zobaczyć "testowe zgłoszenie" w swoim projekcie Sentry w ciągu 10 sekund.
- Zapisz.
Integracja działa po stronie serwera. Nie ładujemy Sentry browser SDK w Twoim dashboardzie — Twój DSN nigdy nie dociera do przeglądarki odwiedzającego.
Jak wygląda zgłoszenie
Każde przekazywane zdarzenie staje się zgłoszeniem w formacie Sentry z:
event_id= ID zdarzenia Elido (do de-duplikacji).level=errordla nadużyć + failure TLS,warningdla failure dostarczania webhooków,infodla anomalii skoku.fingerprint= ID workspace + typ zdarzenia + ID odpowiedniego zasobu, żeby ponowne wyzwolenia tego samego zgłoszenia grupowały się poprawnie w Sentry.extra= pełny ładunek zdarzenia Elido.tags=workspace,event_kind, plus tag specyficzny dla zasobu (link_slug,domain, itp.).
Uwagi dotyczące GlitchTip
GlitchTip implementuje API ingestii zdarzeń Sentry, ale nie pełny zestaw funkcji Sentry. Integracja wysyła zdarzenia tylko przez endpoint ingestii, więc każda funkcja w tym zakresie (grupowanie zgłoszeń, fingerprints, wyszukiwanie, alerting) działa też w GlitchTip. Traces wydajności, replaye i profilowanie nie — ale Elido i tak ich nie wysyła.
Wyłącz
Kliknij Odłącz na stronie integracji. DSN jest usuwany i nie są wysyłane dalsze zdarzenia. Istniejące zgłoszenia Sentry nie są usuwane — pozostają w Twoim projekcie Sentry.
Limity
- 1 cel Sentry na workspace. Jeśli potrzebujesz rozsyłać do wielu projektów Sentry, użyj webhooków i małego proxy.
- Respektujemy domyślny limit szybkości Sentry 50/s na projekt. Anomalie skoku są próbkowane przed wysłaniem, żeby pozostać poniżej limitu.
Rozwiązywanie problemów
Zdarzenie testowe dociera, ale prawdziwe zdarzenia nie. Sprawdź, czy wybrałeś właściwe typy zdarzeń w ustawieniach integracji. Domyślny wybór jest konserwatywny.
Zdarzenia docierają, ale tags są puste. Sentry czasami obcina wartości tagów dłuższe niż 200 znaków (slugi, domeny) — stają się unknown. To ograniczenie Sentry, nie nasze.
Endpoint ingestii GlitchTip odrzuca z 429. Twoja instancja GlitchTip stosuje rate limiting. Albo podnieś limit per projekt w adminie GlitchTip, albo odfiltruj typy zdarzeń do tych, których potrzebujesz.
DSN był rotowany i teraz dostajemy 401. Zaktualizuj DSN na stronie integracji. Nie ma auto-detect dla rotacji DSN.