Релизы и Source Maps

Что такое релиз в Хоуке?

Релиз связывает событие с конкретной версией приложения. Это помогает понять, в какой версии появилась ошибка, корректно показать исходный код через Source Maps и связать событие с последними коммитами.

Как настроить релизы?

При каждой сборке или публикации новой версии отправляйте информацию о релизе в Хоук и передавайте тот же идентификатор релиза при инициализации SDK. Названия должны совпадать, иначе событие не будет связано с нужной версией.

Для Vite и Webpack доступны плагины. Релизы и коммиты также можно отправлять из CI/CD.

Что такое Source Maps и зачем они нужны?

Source Maps связывают минифицированный JavaScript-код с исходными файлами. Без них stack trace production-сборки может указывать на сжатые файлы и быть неудобным для расследования.

Когда нужно загружать Source Maps?

После каждой новой frontend-сборки. Source Maps должны соответствовать конкретному релизу, а идентификатор релиза в событии должен совпадать с релизом, для которого загружены карты.

Безопасно ли публиковать Source Maps?

Не размещайте Source Maps в открытом доступе без необходимости. Загружайте их в систему мониторинга во время CI/CD и ограничивайте доступ к токенам интеграции.

Как проверить, что Source Maps работают?

Создайте тестовую ошибку в production-подобной сборке и откройте stack trace. В нём должны отображаться исходные имена файлов, функции и строки кода, а не только минифицированный bundle.