Подключение Sentry или GlitchTip

Sentry и GlitchTip используют один и тот же протокол Sentry SDK. Настройка со стороны Elido одинакова для обоих — единственная разница заключается в DSN, который вы вставляете.

Это руководство охватывает два направления: перенаправление оповещений Elido в ваш трекер ошибок (чтобы проблемы со злоупотреблениями / TLS / API отображались как проблемы, которые вы можете сортировать) и использование Elido вместе с вашей существующей настройкой Sentry, если вы уже самостоятельно размещаете GlitchTip.

Зачем их подключать

Elido генерирует операционные события, которые полезны в качестве проблем Sentry:

• abuse.flagged — наш сканер пометил URL назначения как вредоносное ПО / фишинг.
• domain.tls_renewed (вариант сбоя) — Caddy не смог продлить сертификат TLS.
• webhook.delivery_failed — ваша собственная конечная точка webhook перестала отвечать.
• link.clicked.aggregated (вариант аномалии) — внезапный 10-кратный всплеск трафика по одной ссылке.

Вам, вероятно, не нужны все из них в качестве проблем — выберите те, которые требуют вмешательства человека.

Добавление интеграции

1. Dashboard → Integrations → Sentry / GlitchTip.
2. Вставьте свой Sentry DSN. DSN GlitchTip используют тот же формат и работают в том же поле.
3. Выберите типы событий для пересылки. По умолчанию это только abuse.flagged и сбои продления TLS.
4. Нажмите Send test event. Вы должны увидеть "тестовую проблему" в вашем проекте Sentry в течение 10 секунд.
5. Save.

Интеграция работает на стороне сервера. Мы не загружаем Sentry browser SDK в вашу панель управления — ваш DSN никогда не достигает браузера посетителя.

Как выглядит проблема

Каждое перенаправленное событие становится проблемой формата Sentry с:

• event_id = Elido event id (для дедупликации).
• level = error для злоупотреблений + сбоев TLS, warning для сбоев доставки webhook, info для аномалий всплесков.
• fingerprint = workspace ID + event kind + соответствующий resource ID, чтобы повторные срабатывания одной и той же проблемы группировались в Sentry.
• extra = полная полезная нагрузка события Elido.
• tags = workspace, event_kind, плюс тег, специфичный для ресурса (link_slug, domain и т.д.).

Заметки о GlitchTip

GlitchTip реализует Sentry event ingestion API, но не весь набор функций Sentry. Интеграция отправляет события только через конечную точку ingestion, поэтому любая функция в этой области (группировка проблем, fingerprints, поиск, оповещения) также работает в GlitchTip. Отслеживание производительности, воспроизведения и профилирование не работают, но Elido их в любом случае не отправляет.

Отключение

Нажмите Disconnect на странице интеграции. DSN будет удален, и дальнейшие события не будут отправляться. Ваши существующие проблемы Sentry не удаляются — они остаются в вашем проекте Sentry.

Ограничения

• 1 Sentry destination на workspace. Если вам нужно распределить события по нескольким проектам Sentry, используйте webhooks и небольшой прокси.
• Мы соблюдаем ограничение Sentry по умолчанию в 50/с на проект. Аномалии всплесков выбираются перед отправкой, чтобы оставаться в пределах лимита.

Устранение неполадок

Тестовое событие приходит, но реальные события нет. Убедитесь, что вы выбрали правильные типы событий в настройках интеграции. Выбор по умолчанию является консервативным.

События приходят, но tags пусты. Sentry иногда усекает значения тегов длиннее 200 chars (slugs, domains) — они отображаются как unknown. Это ограничение Sentry, а не наше.

Конечная точка ingest GlitchTip отклоняет запрос с 429. Ваш экземпляр GlitchTip ограничивает скорость. Либо увеличьте лимит на проект в админке GlitchTip, либо отфильтруйте типы событий до тех, которые вам нужны.

DSN был изменен, и теперь мы получаем 401s. Обновите DSN на странице интеграции. Автоматическое определение изменения DSN отсутствует.