Міст Sentry, Bugsnag & Datadog RUM

1. Проблема: трасування стека не показують контексту користувача

Коли на сайті виникає необроблений виняток JavaScript або збій мережі, інструменти моніторингу помилок на кшталт Sentry надають сухі трасування стека й рядки user-agent браузера. Але розробникам залишається запитати: «Яку кнопку користувач натиснув безпосередньо перед збоєм?» або «Які дані було введено у форму?»

Цей міст відстеження помилок MousePlayer автоматично розв’язує проблему, додаючи URL візуального відтворення безпосередньо до звітів про помилки. Коли виникає виняток, розробники можуть натиснути одне посилання на панелі Sentry чи Bugsnag і переглянути відеозапис екрана користувача до точної мілісекунди збою.

2. Увімкнення & зіставлення постачальників

Міст відстеження помилок можна ввімкнути через панель показників або програмно через об’єкт конфігурації нашого SDK.

Спосіб A: увімкнення на панелі показників (без коду)

1. Увійдіть у робочий простір MousePlayer і відкрийте Ваші сайти.
2. Натисніть кнопку Налаштування / Інтеграції поруч із потрібним сайтом.
3. У вікні інтеграцій переведіть перемикач Міст Sentry, Bugsnag & Datadog RUM у стан ON.
4. Виберіть постачальника (sentry, bugsnag або datadog) і натисніть Зберегти зміни.

Спосіб B: ручне налаштування скрипту

Якщо ви хочете прописати конфігурацію безпосередньо в коді, передайте error_bridge_active: true всередині об’єкта window.mp_config:

3. Технічна таблиця виконання SDK

Залежно від вибраного постачальника MousePlayer автоматично виконує офіційні методи маркування JavaScript SDK:

Постачальник	Виконуваний метод JavaScript	Доданий ключ метаданих
Sentry	window.Sentry.setTag(...)	mouseplayer_session_url
Bugsnag	window.Bugsnag.addMetadata('MousePlayer', { ... })	session_url
Datadog RUM	window.DD_RUM.setGlobalContextProperty(...)	mouseplayer_session_url

4. Де знайти відтворення у звітах про помилки

Після ввімкнення URL відтворення одразу з’являються на панелях моніторингу помилок щоразу, коли реєструється клієнтський збій.

Відомості про проблему в Sentry

Відкрийте будь-яку проблему у своєму проєкті Sentry й прокрутіть до розділу Теги. Ви побачите тег із назвою mouseplayer_session_url. Також можна фільтрувати проблеми Sentry через пошуковий рядок запиту: mouseplayer_session_url:*.

Вкладки метаданих Bugsnag

У звіті про помилку Bugsnag перевірте нижні вкладки навігації. З’явиться нова власна вкладка з назвою MousePlayer, що міститиме клікабельне гіперпосилання session_url.

Провідник помилок Datadog RUM

У Datadog RUM перейдіть до будь-якого записаного сеансу з помилкою та перегляньте дерево JSON Глобальний контекст / Атрибути. URL індексується під ключем @mouseplayer_session_url.