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 все одно їх не надсилає.
Якщо ви хостите GlitchTip самостійно в приватній мережі, надайте вихідним IP-адресам Elido доступ по HTTP. Повний список знаходиться на нашій сторінці довіри; коротка версія: 5.75.0.0/16 (Hetzner FRA) та 51.79.0.0/16 (OVH SGP).
Вимкнення#
Натисніть Disconnect на сторінці інтеграції. DSN буде видалено, і подальші події не надсилатимуться. Ваші існуючі інциденти Sentry не видаляються — вони залишаються у вашому проекті Sentry.
Обмеження#
- 1 місце призначення Sentry на робочу область. Якщо вам потрібно розподіляти події на кілька проектів Sentry, використовуйте вебхуки та невеликий проксі.
- Ми дотримуємося стандартного ліміту швидкості Sentry у 50 запитів/с на проект. Аномальні стрибки фільтруються перед відправкою, щоб залишатися в межах ліміту.
Усунення несправностей#
Тестова подія надходить, а реальні — ні. Перевірте, чи ви обрали правильні типи подій у налаштуваннях інтеграції. Вибір за замовчуванням є консервативним.
Події надходять, але tags порожні. Sentry іноді обрізає значення тегів довше 200 символів (слаги, домени) — вони стають unknown. Це обмеження Sentry, а не наше.
Кінцева точка прийому GlitchTip повертає помилку 429. Ваш екземпляр GlitchTip обмежує швидкість. Або збільште ліміт для проекту в адмінпанелі GlitchTip, або відфільтруйте типи подій до тих, що вам дійсно потрібні.
DSN було змінено, і тепер виникають помилки 401. Оновіть DSN на сторінці інтеграції. Автоматичного виявлення зміни DSN немає.