Table of contents

Переход с Sentry

Да. Хоук поддерживает формат Sentry. Для совместимой интеграции создайте проект в Хоуке, скопируйте DSN и укажите его в конфигурации существующего Sentry SDK.

Если вы ранее использовали Sentry, перейти на Хоук просто:

  • замените параметр dsn в конфигурации SDK на DSN Хоука, который можно скопировать в Project Settings → Integration.
  • см. подробное руководство: Миграция с Sentry
import * as Sentry from '@sentry/browser'; Sentry.init({ - dsn: 'https://1234567890abcdef1234567890abcdef@o123456.ingest.sentry.io/9876543', + dsn: 'https://3c59d1984e6646849ff59cd5e230627f7385883f29c645ae8e2a94afb2b8a281@k1.hawk.so/0' // ... });

Во многих случаях достаточно заменить значение DSN. Перед переключением production-проекта проверьте совместимость используемого языка, версии SDK и необходимых полей.

Новые события будут отправляться в Хоук. Замена DSN сама по себе не переносит историю событий, пользователей, правила уведомлений, релизы и настройки проекта из Sentry.

Да. Создайте отдельный проект Хоука и подключите к нему один сервис, приложение или тестовое окружение. Так можно оценить качество событий и интерфейс без массовой миграции.

Возможность одновременно отправлять одно событие в два DSN зависит от конкретного SDK. Для параллельной отправки проверьте документацию SDK или используйте отдельное окружение.

Верните прежний DSN в конфигурацию Sentry SDK и выпустите новую версию приложения. Поэтому перед переключением сохраните предыдущую конфигурацию и проверьте процедуру отката на staging.

Нет, обычная замена DSN влияет только на новые события. Если необходим импорт исторических данных, заранее уточните возможность и формат переноса у команды Хоука.

Да. Для связи событий с версиями приложения передавайте идентификатор релиза в SDK Хоука. Source Maps необходимо загружать в Хоук после каждой сборки с помощью поддерживаемого плагина или другого предусмотренного способа.

1. Создайте отдельный проект в Хоуке.

2. Получите DSN для Sentry-интеграции.

3. Замените DSN в тестовом окружении.

4. Сгенерируйте контролируемую ошибку.

5. Проверьте заголовок, stack trace и контекст.

6. Проверьте фильтрацию чувствительных данных.

7. При необходимости настройте релиз и Source Maps.

8. Настройте уведомление.

9. Только после проверки переносите production-трафик.