Возможности
Продакшен-сборки минифицированы, и сырой стек-трейс указывает на искажённые имена в бандле. Загрузите source maps, которые сборка и так создаёт, — и каждый фрейм будет показан как исходный файл, строка, колонка и функция.
Source maps
Фреймы расшифровываются автоматически на страницах ошибки и инцидента, вместе со строками исходника вокруг упавшей.
Один плагин генерирует и загружает карты прямо во время сборки — для Vite, Rollup, webpack, Rspack и esbuild. Отдельный шаг в CI поддерживать не нужно.
Карты загружаются для конкретного релиза, поэтому ошибка из сборки недельной давности расшифруется картами той недели, а не сегодняшними.
Фреймы расшифровываются до группировки ошибок, поэтому один и тот же баг остаётся в одном инциденте, хотя каждая сборка переименовывает минифицированные файлы.
Как это работает
Передайте в init релиз: версию, git-коммит или номер сборки, который однозначно определяет один деплой.
Укажите тот же релиз и персональный токен, который хранится в секретах сборки. Карты загрузятся во время сборки.
Следующая ошибка этого релиза покажет исходные файлы и строки. На самих страницах ничего менять не нужно.
import { defineConfig } from 'vite'
import { sourcemaps } from '@buglapse/bundler-plugin/vite'
export default defineConfig({
plugins: [sourcemaps({
url: 'https://app.buglapse.com',
authToken: process.env.BUGLAPSE_AUTH_TOKEN,
org: 'acme',
project: 'acme-web',
release: process.env.BUILD_RELEASE,
})],
})Подробнее
Расшифровка зависит от точного совпадения двух вещей: релиза, проставленного на ошибке, и имени минифицированного файла, на который указывает фрейм. Если что-то отличается, фрейм просто остаётся как есть — это не считается сбоем. Поэтому, когда стек остался минифицированным, первым делом проверьте, что сборка и SDK используют одну и ту же строку релиза. Без плагина карты можно загружать из CI через API.
Карты загружаются в Buglapse и браузерам не отдаются, поэтому публиковать их рядом с бандлами не нужно. Загрузка авторизуется персональным токеном с отдельным правом доступа. Он не связан с DSN проекта и должен лежать только в секретах сборки или CI, но не в клиентском коде. На тарифах со ссылками на код фреймы также ведут к файлу в вашем репозитории на GitHub или GitLab.
| Free | Pro | Team | |
|---|---|---|---|
| Source maps | Включено | Включено | Включено |
| Максимальный размер source map | 10 МБ | 30 МБ | 50 МБ |
| Ссылки из стека на код в репозитории | Включено | Включено | Включено |
Вопросы
Остались вопросы?
Напишите нам — поможем с подключением, тарифом или self-hosted.
Написать намили на почту hello@buglapse.com
Смотрите также
Каждая ошибка — один инцидент с читаемым стек-трейсом, хлебными крошками, шагами до ошибки и затронутыми пользователями.
Подробнее: Мониторинг ошибокДоля сессий и пользователей без падений по каждому релизу и новые инциденты каждого деплоя.
Подробнее: Здоровье релизовМониторинг ошибок, трейсинг, логи и реплеи сессий для браузерного JavaScript с любым фреймворком.
Подробнее: JavaScriptСоздайте проект на бесплатном тарифе и отправьте первое событие за пару минут.
Остались вопросы? Напишите на hello@buglapse.com