Що ви підключите
- Ваш проєкт Sentry або GlitchTip за допомогою DSN — одне поле підходить для обох сервісів.
- Вибрані типи подій Elido (прапорці зловживань, помилки TLS, помилки доставки вебхуків, аномалії стрибків трафіку), що пересилаються як інциденти Sentry.
- Чітке групування інцидентів за відбитками на основі ID робочої області, типу події та ID ресурсу.
Sentry та GlitchTip використовують однаковий протокол Sentry SDK. Налаштування з боку Elido ідентичне для обох — єдина різниця полягає в DSN, який ви вставляєте.
Цей посібник охоплює два напрямки: передачу сповіщень Elido у ваш трекер помилок (щоб проблеми зі зловживаннями / TLS / API відображалися як інциденти для подальшого опрацювання) та використання Elido разом із вашим існуючим налаштуванням Sentry, якщо ви вже самостійно хостите GlitchTip.
Навіщо їх підключати
Elido генерує операційні події, які корисні як інциденти Sentry:
abuse.flagged— наш сканер позначив цільовий URL як шкідливе ПЗ / фішинг.domain.tls_renewed(failure variant) — Caddy не зміг оновити сертифікат TLS.webhook.delivery_failed— ваша власна кінцева точка вебхука перестала відповідати.link.clicked.aggregated(anomaly variant) — раптовий 10-кратний стрибок трафіку за одним посиланням.
Ймовірно, ви не захочете бачити їх усі як інциденти — оберіть ті, що потребують реакції людини.
Додавання інтеграції
- Панель керування → Інтеграції → Sentry / GlitchTip.
- Вставте ваш Sentry DSN. DSN для GlitchTip мають той самий формат і працюють у тому ж полі.
- Оберіть типи подій для пересилання. За замовчуванням це лише
abuse.flaggedта помилки оновлення TLS. - Натисніть Send test event. Ви повинні побачити «тестовий інцидент» у вашому проекті Sentry протягом 10 секунд.
- Save.
Інтеграція працює на стороні сервера. Ми не завантажуємо Sentry browser SDK у вашій панелі керування — ваш DSN ніколи не потрапляє в браузер відвідувача.
Як виглядає інцидент
Кожна переслана подія стає інцидентом у форматі Sentry з:
event_id= ID події Elido (для дедуплікації).level=errorдля зловживань + помилок TLS,warningдля помилок доставки вебхуків,infoдля аномальних стрибків.fingerprint= ID робочої області + тип події + ID відповідного ресурсу, щоб повторні виклики того самого інциденту групувалися в Sentry.extra= повне корисне навантаження події Elido.tags=workspace,event_kind, плюс тег конкретного ресурсу (link_slug,domainтощо).
Примітки щодо GlitchTip
GlitchTip реалізує API прийому подій Sentry, але не повний набір функцій Sentry. Інтеграція лише надсилає події через кінцеву точку прийому, тому будь-які функції в межах цього обсягу (групування інцидентів, відбитки, пошук, сповіщення) також працюють у GlitchTip. Трасування продуктивності, повтори (replays) та профілювання не підтримуються, але Elido все одно їх не надсилає.
Вимкнення
Натисніть Disconnect на сторінці інтеграції. DSN буде видалено, і подальші події не надсилатимуться. Ваші існуючі інциденти Sentry не видаляються — вони залишаються у вашому проекті Sentry.
Обмеження
- 1 місце призначення Sentry на робочу область. Якщо вам потрібно розподіляти події на кілька проектів Sentry, використовуйте вебхуки та невеликий проксі.
- Ми дотримуємося стандартного ліміту швидкості Sentry у 50 запитів/с на проект. Аномальні стрибки фільтруються перед відправкою, щоб залишатися в межах ліміту.
Усунення несправностей
Тестова подія надходить, а реальні — ні. Перевірте, чи ви обрали правильні типи подій у налаштуваннях інтеграції. Вибір за замовчуванням є консервативним.
Події надходять, але tags порожні. Sentry іноді обрізає значення тегів довше 200 символів (слаги, домени) — вони стають unknown. Це обмеження Sentry, а не наше.
Кінцева точка прийому GlitchTip повертає помилку 429. Ваш екземпляр GlitchTip обмежує швидкість. Або збільште ліміт для проекту в адмінпанелі GlitchTip, або відфільтруйте типи подій до тих, що вам дійсно потрібні.
DSN було змінено, і тепер виникають помилки 401. Оновіть DSN на сторінці інтеграції. Автоматичного виявлення зміни DSN немає.