Запись сессии (что делал посетитель до ошибки)
Запись сессии отвечает на вопрос, который разработчик задаёт после каждого невнятного баг-репорта: что именно человек делал перед сбоем? В Bugfix посетитель нажимает одну кнопку в форме отчёта, повторяет проблему на странице, и запись уходит к команде вместе с сообщением.
Как Bugfix записывает действия посетителя
Запись сессии в Bugfix начинается с кнопки 🎬 в форме баг-репорта. Она записывает действия посетителя на странице библиотекой rrweb. rrweb не снимает экран на видео. Она фиксирует изменения самой страницы, то есть DOM: дерева элементов, которое браузер строит из страницы, с её кнопками, текстами и формами.
- Посетитель открывает форму плавающей кнопкой виджета.
- Он нажимает 🎬 и действует на странице.
- Он отправляет сообщение.
- Запись попадает в приватное хранилище
bug-replaysи привязывается к этому сообщению.
Запись сессии в сообщении: что видит разработчик
Запись приходит не одна. В том же сообщении разработчик находит:
- скриншот экрана;
- отмеченный элемент с его селектором и рамкой;
- ошибки консоли;
- сетевые запросы;
- последние шаги пользователя.
Вместе это показывает, что человек делал до появления проблемы, поэтому разработчик читает последовательность действий, а не жалобу в одну строку. Сообщения собираются в дашборде разработчика по адресу /dashboard.html, он открывается по токену.
Кто может открыть запись
Записи приватные. Файл лежит в закрытом хранилище bug-replays и привязан к одному сообщению. Он открывается через защищённую функцию просмотра вложений, а не по публичной ссылке, и без токена владельца не открывается совсем.
Это правило действует для любых приватных вложений Bugfix: скриншоты, записи экрана и голосовые сообщения отдаются через ту же функцию.
Когда пригодится запись шагов посетителя
- Ошибка зависит от порядка действий. Фраза «страница зависает» ничего не говорит о пути к зависанию. Запись сессии этот путь показывает, а рядом лежат последние шаги пользователя.
- Посетитель не умеет описать шаги. Записывать их словами не нужно: достаточно повторить действия при включённой записи.
- Проблема связана с устройством или браузером. Устройство и браузер входят в то же сообщение, так что разработчик видит, где сделана запись.
Как включить запись сессии на сайте
Кнопка записи — часть формы отчёта, поэтому запись сессии появляется на сайте вместе с виджетом Bugfix. Виджет подключается одним тегом script, в котором ключ вашего сайта стоит в data-project, а загрузчик поддерживает его актуальным на каждом сайте.
Если политика безопасности сайта строгая, разрешите blob: в img-src и media-src. Без этого превью записи не покажется.
Ограничения записи
- Запись начинается только после нажатия посетителем на 🎬: скрипт записи до этого даже не загружается. Обычный технический контекст отчёта — ошибки консоли, сетевые запросы, последние шаги — прикладывается к сообщению отдельно.
- Приватные вложения не открываются без токена владельца.
- Политика безопасности сайта должна разрешать вспомогательные ресурсы вида
blob:, иначе превью останется пустым. - Запись — это журнал изменений страницы, а не видео. Картинку экрана даёт скриншот из того же сообщения.
Частые вопросы
Запись сессии в Bugfix — это видео экрана?
Нет. rrweb записывает изменения DOM, то есть структуры страницы, а не видео экрана. Картинку экрана даёт скриншот, приложенный к тому же сообщению.
Записывает ли Bugfix сессию посетителя без его ведома?
Нет. Запись страницы запускается только нажатием посетителя на кнопку 🎬 в форме отчёта, и скрипт записи загружается именно в этот момент. Обычный технический контекст отчёта — ошибки консоли, сетевые запросы, последние шаги — идёт с сообщением отдельно.
Где хранится запись и кто может её открыть?
Она хранится в приватном хранилище bug-replays и привязана к сообщению. Открывается через защищённую функцию просмотра по токену владельца, а не по публичной ссылке.