Интеграции

Одним из ключевых компонентов Хоука являются Кэтчеры. С их помощью ваш код начинает автоматически отправлять ошибки и события в Хоук.

Что такое Кэтчер

Кэтчер — это небольшая библиотека, которую вы подключаете к приложению. Она перехватывает ошибки в рантайме и отправляет их в Хоук.

Благодаря кэтчерам вы можете отслеживать как необработанные ошибки, так и события, которые отправляете вручную (например, важные бизнес-события или кастомные исключения).

Доступные кэтчеры

Мы поддерживаем несколько официальных SDK (кэтчеров)

👉 Если вы не нашли подходящего кэтчера для своего языка или фреймворка — вы можете создать его сами.

См. раздел Как создать кэтчер.

Возможности кэтчера

Глобальный перехват ошибок

Кэтчер подключается к глобальному обработчику ошибок и отправляет в Хоук все необработанные исключения.

Ручная отправка событий

Вы можете в любой момент отправить событие в Хоук:

hawk.send(new Error('Что-то пошло не так')) hawk.send('Сообщение без ошибки')

Добавление контекста

Вместе с событием можно отправлять произвольные данные (context). Это помогает при отладке:

hawk.send(error, { userId: 42, feature: 'checkout' })

Данные о пользователе

После инициализации Хоука можно глобально прикрепить информацию о пользователе (id, email, имя).

Автоматические Addons

Кэтчер сам собирает дополнительную информацию об окружении (браузер, версия ОС, версия приложения). Если нужны кастомные данные — используйте context.

Фильтрация чувствительных данных

Перед отправкой события вы можете очистить объект от персональных или финансовых данных (номера карт, токены и т. д.) с помощью хука beforeSend.

Подробнее см. раздел Фильтрация чувствительных данных.

Миграция с Sentry

Если вы ранее использовали 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' // ... });