Most pro Sentry, Bugsnag a Datadog RUM

1. Problém: zásobník volání neukazuje kontext uživatele

Když na webu nastane neošetřená výjimka JavaScriptu nebo selhání sítě, nástroje pro sledování chyb, jako je Sentry, poskytnou strohé zásobníky volání a řetězce user-agent prohlížeče. Vývojáři se však stále ptají: „Na které tlačítko uživatel klikl těsně před pádem?“ nebo „Jaká data byla zadána do formuláře?“

Most MousePlayer pro sledování chyb to automaticky řeší připojením adres URL pro vizuální přehrávání přímo k chybovým hlášením. Při výjimce stačí vývojáři kliknout na jediný odkaz v dashboardu Sentry nebo Bugsnag a přehrát videozáznam obrazovky uživatele až do přesné milisekundy pádu.

Integrace bez měřitelné režie: Most tiše běží jako sledování na pozadí v mp.js. Automaticky rozpozná SDK pro sledování chyb bez měřitelné zátěže a bez vlivu na Core Web Vitals.

2. Aktivace & mapování poskytovatelů

Most pro sledování chyb můžete zapnout v dashboardu nebo programově pomocí konfiguračního objektu SDK.

Metoda A: aktivace v dashboardu (bez kódu)

Přihlaste se do pracovního prostoru MousePlayer a otevřete Vaše weby.
Klikněte na tlačítko Nastavení / Integrace vedle požadovaného webu.
V okně integrací přepněte Most pro Sentry, Bugsnag & Datadog RUM na ON.
Vyberte poskytovatele (sentry, bugsnagnebo datadog) a klikněte na Uložit změny.

Metoda B: ruční konfigurace skriptu

Pokud dáváte přednost konfiguraci přímo v kódu, předejte error_bridge_active: true v objektu window.mp_config následovně:

<script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', error_bridge_active: true, error_provider: 'sentry' // 'sentry', 'bugsnag', or 'datadog' }; </script>

3. Přehled technických volání SDK

Podle vybraného poskytovatele MousePlayer automaticky volá oficiální metody JavaScript SDK pro přidávání značek:

Poskytovatel	Volaná metoda JavaScriptu	Vložený klíč metadat
Sentry	`window.Sentry.setTag(...)`	`mouseplayer_session_url`
Bugsnag	`window.Bugsnag.addMetadata('MousePlayer', { ... })`	`session_url`
Datadog RUM	`window.DD_RUM.setGlobalContextProperty(...)`	`mouseplayer_session_url`

4. Kde najdete záznamy v chybových hlášeních

Po aktivaci se adresy URL záznamů okamžitě objeví v dashboardech sledování chyb pokaždé, když je zaznamenán pád frontendu.

Podrobnosti problému v Sentry

Otevřete libovolný problém v projektu Sentry a přejděte dolů do části Tags . Uvidíte značku s názvem mouseplayer_session_url. Problémy Sentry můžete také filtrovat pomocí vyhledávacího dotazu: mouseplayer_session_url:*.

Karty metadat v Bugsnag

V chybovém hlášení Bugsnag zkontrolujte navigační karty dole. Objeví se nová vlastní karta s názvem MousePlayer obsahující session_url jako klikací hypertextový odkaz.

Datadog RUM Error Explorer

V Datadog RUM otevřete libovolnou zaznamenanou relaci s chybou a prohlédněte strom JSON v části Global Context / Attributes . Adresa URL je indexována pod @mouseplayer_session_url.

Jak vám můžeme pomoci?