Buglapse

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

1. Создайте проект ​

Зарегистрируйтесь, создайте организацию и проект. Один проект — одно приложение: например, отдельно фронтенд и отдельно бэкенд. Так у каждого свои ошибки, фильтры и настройки.

2. Подключите SDK ​

  • Сайт или фронтенд — скопируйте готовый script-тег из Настройки → Скрипт загрузчика и вставьте в <head>.
  • Сборка через npm, Vue, Nuxt, Node.js — см. Установка SDK.
  • Уже стоит Sentry SDK — просто смените DSN, см. Переход с Sentry.

Укажите окружение (production, staging) — так события разных стендов не смешаются.

3. Отправьте тестовую ошибку ​

ts
Buglapse.captureException(new Error('Проверка Buglapse'))

Через несколько секунд она появится в разделе Исключения, а в Инцидентах — сгруппированная запись о ней. Если ничего не пришло — см. Не приходят события.

4. Укажите пользователя ​

ts
Buglapse.setUser({ id: user.id, email: user.email })

Тогда видно, у скольких людей возникает ошибка и у кого именно. См. Пользователи и контекст.

5. Уберите шум ​

В Настройки → Фильтры включите фильтры краулеров, ошибок гидратации и загрузки чанков. Ошибки расширений браузера отсекаются «Входящими фильтрами». См. Фильтрация шума.

6. Проверьте, что не уходит лишнего ​

Пароли, токены и номера карт сервер вычищает сам. Если в событиях могут оказаться другие личные данные — добавьте свои поля в Настройки → Безопасность и приватность. См. Чувствительные данные.

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

Алерты о новых ошибках и регрессиях включены по умолчанию и приходят всем участникам на email. Каждый может выбрать нужные в Профиль → Уведомления, а также получать их в Telegram или MAX — в личном чате с ботом или в группе команды. См. Алерты и уведомления.

8. Подключите релизы и source maps ​

Передавайте версию сборки в SDK и загружайте source maps из CI — тогда стектрейсы будут указывать на ваш исходный код, а регрессии будут привязаны к версиям. См. Релизы.

9. Пригласите команду ​

Добавьте коллег в Настройки организации → Участники. Участники видят все проекты организации и получают алерты. Инцидент можно назначить на конкретного человека.

10. Дополнительно ​