Buglapse

Релиз — это строка, которая обозначает одну сборку: версия (1.4.2), git SHA или номер билда. Если передавать её в SDK, Buglapse покажет:

  • какие инциденты появились в этом релизе;
  • какие решённые инциденты вернулись (регрессии);
  • долю сессий без падений по каждому релизу;
  • раскодированные стектрейсы — если загружены source maps той же сборки.

1. Передайте релиз в SDK ​

html
<script
    src="https://app.buglapse.com/cdn/{project-token}/buglapse.min.js"
    data-release="1.4.2"
    data-environment="production"
    async
></script>
ts
init({
    dsn: '{dsn}',
    release: import.meta.env.VITE_RELEASE, // или process.env.GIT_SHA
    environment: 'production',
})

Значение подставляйте при сборке — из package.json, тега или SHA коммита. Как только придёт первое событие с новым релизом, он появится в разделе Релизы проекта.

2. Загрузите source maps ​

Продакшен-сборки минифицированы, и без source maps стектрейс указывает на index-a1b2c3.js:1:48213. Проще всего загружать их плагином сборщика @buglapse/bundler-plugin (Vite, webpack, Rollup, Rspack, esbuild): он сам загрузит карты и запишет релиз. Пошагово — на странице Source maps. Source maps доступны на платных тарифах.

Название должно совпадать

Релиз в SDK и релиз при загрузке source maps должны совпадать до символа. Иначе кадры стека останутся минифицированными, без какой-либо ошибки.

3. Опишите релиз из CI (необязательно) ​

Чтобы на странице релиза были коммит, ссылка на сборку и дата выкатки, вызовите API из того же шага CI:

bash
curl -X POST "https://app.buglapse.com/api/0/projects/{organization}/{project}/releases" \
    -H "Authorization: Bearer $BUGLAPSE_AUTH_TOKEN" \
    -F "version=$BUILD_RELEASE" \
    -F "ref=$GIT_SHA" \
    -F "url=https://github.com/acme/app/commit/$GIT_SHA" \
    -F "deployed_at=$(date -u +%Y-%m-%dT%H:%M:%SZ)"

Токен создаётся в Профиль → Токены со скоупом project:releases. Это не DSN: он даёт право записи и должен храниться только в секретах CI.

Если к проекту подключён репозиторий (Настройки → Репозиторий), кадры стека будут ссылаться на строки кода именно в этом коммите — см. Ссылки на код.

Что видно на странице релиза ​

  • Здоровье релиза — доля сессий и пользователей без падений. Сессии учитывает браузерный SDK, они не расходуют квоту.
  • Новые инциденты — ошибки, которые впервые появились в этом релизе.
  • Source maps — загруженные файлы карт, их можно удалить.
  • Заметки — что вошло в релиз, известные проблемы.

Старые релизы можно отправить в архив, чтобы они не мешали в списке.

Регрессии и «решён в следующем релизе» ​

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