Table of contents

Как начать

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

Создайте аккаунт с помощью электронной почты и войдите в интерфейс Хоука.

Воркспейс объединяет проекты и участников одной команды, компании или подразделения. Укажите понятное название, например название компании или продукта.

Проект соответствует отдельному приложению, сервису или его окружению. Для удобства используйте названия вроде:

• Frontend — production;

• Frontend — staging;

• Auth API;

• Mobile Android.

Для разных частей системы и окружений лучше создавать отдельные проекты.

Откройте настройки проекта или выберите интеграцию из каталога. Скопируйте токен, который будет использоваться SDK для отправки событий.

Откройте раздел «Интеграции» и выберите язык или фреймворк проекта. Установите пакет и добавьте инициализацию по инструкции.

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

До отправки реальных событий проверьте, какие данные формирует SDK. Удалите лишние поля через beforeSend и не добавляйте секреты в пользовательский контекст.

При помощи hawk.test() Вы можете отправить тестовое событие в Ваш проект.

Убедитесь, что в Хоуке отображаются:

• правильный проект и окружение;

• заголовок ошибки;

• stack trace;

• нужный контекст;

• версия приложения или релиз, если он настроен;

• отсутствие секретных и лишних персональных данных.

Выберите подходящий канал: email, Telegram, Slack или Webhook. Начните с одного полезного правила, чтобы не создавать лишний шум.

Для frontend-проектов настройте отправку релизов и Source Maps из сборки или CI/CD. Проверьте production-подобную ошибку и убедитесь, что stack trace показывает исходный код.

Добавьте разработчиков и других участников, которым нужен доступ к событиям. Для корпоративной авторизации при необходимости настройте SSO.

После проверки на staging выпустите изменение в production. В первые дни следите за количеством событий, качеством группировки и месячным лимитом.

После этих шагов Хоук будет принимать события проекта. Дальше можно добавлять другие приложения, настраивать дополнительные правила уведомлений, подключать релизы и выбирать тариф по фактическому объёму событий.