Подключение 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-кратный всплеск трафика по одной ссылке.

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

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

Dashboard → Integrations → Sentry / GlitchTip.
Вставьте свой Sentry DSN. DSN GlitchTip используют тот же формат и работают в том же поле.
Выберите типы событий для пересылки. По умолчанию это только abuse.flagged и сбои продления TLS.
Нажмите Send test event. Вы должны увидеть "тестовую проблему" в вашем проекте Sentry в течение 10 секунд.
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 их в любом случае не отправляет.

Если вы самостоятельно размещаете GlitchTip за частной сетью, предоставьте HTTP-доступ исходящим IP-адресам Elido. Полный список находится на нашей странице доверия; краткая версия: 5.75.0.0/16 (Hetzner FRA) и 51.79.0.0/16 (OVH SGP).

Отключение#

Нажмите 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 отсутствует.