Penghubung Sentry, Bugsnag & Datadog RUM

Percepat aliran kerja kejuruteraan dan QA anda dengan memautkan pengecualian JavaScript bahagian hadapan terus ke rakaman sesi video MousePlayer.

1. Masalah: jejak tindan tidak menunjukkan konteks pengguna

Apabila pengecualian JavaScript tidak dikendalikan atau ranap rangkaian berlaku pada laman web anda, alat pemantauan ralat seperti Sentry menyediakan jejak tindan dan rentetan ejen pengguna pelayar semata-mata. Namun, jurutera masih bertanya: “Butang manakah yang diklik pengguna tepat sebelum ranap?” atau “Data apakah yang dimasukkan ke dalam borang?”

Penghubung Penjejakan Ralat MousePlayer menyelesaikannya secara automatik dengan menghubungkan URL main semula visual terus ke laporan ralat anda. Apabila pengecualian berlaku, jurutera boleh mengklik satu pautan dalam papan pemuka Sentry atau Bugsnag dan menonton rakaman video skrin pengguna hingga milisaat tepat ranap berlaku.

Integrasi tanpa beban tambahan: Penghubung berjalan secara senyap sebagai pemerhati latar belakang dalam mp.js. Ia mengesan SDK penjejakan ralat anda secara automatik tanpa menambah beban yang boleh diukur atau menjejaskan Core Web Vitals.

2. Pengaktifan & pemetaan penyedia

Anda boleh mengaktifkan penghubung penjejakan ralat melalui antara muka papan pemuka atau secara pengaturcaraan melalui objek konfigurasi SDK kami.

Cara A: pengaktifan papan pemuka (Tanpa kod)

  1. Daftar masuk ke ruang kerja MousePlayer anda dan buka Aset web anda.
  2. Klik butang Tetapan / Integrasi di sebelah laman web sasaran anda.
  3. Dalam tetingkap Integrasi, tukar Penghubung Sentry, Bugsnag & Datadog RUM kepada ON.
  4. Pilih penyedia anda (sentry, bugsnag, atau datadog) dan klik Simpan perubahan.

Cara B: konfigurasi skrip manual

Jika anda lebih suka menetapkan konfigurasi terus dalam kod, hantar error_bridge_active: true dalam objek window.mp_config anda:

<!-- MousePlayer SDK with Error Tracking Bridge Enabled --> <script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', error_bridge_active: true, error_provider: 'sentry' // 'sentry', 'bugsnag', or 'datadog' }; </script>

3. Jadual pelaksanaan SDK teknikal

Bergantung pada penyedia dipilih, MousePlayer melaksanakan kaedah pengetagan SDK JavaScript rasmi secara automatik:

Penyedia Kaedah JavaScript dilaksanakan Kunci metadata disisipkan
Sentry window.Sentry.setTag(...) mouseplayer_session_url
Bugsnag window.Bugsnag.addMetadata('MousePlayer', { ... }) session_url
Datadog RUM window.DD_RUM.setGlobalContextProperty(...) mouseplayer_session_url

4. Tempat mencari main semula dalam laporan ralat

Setelah aktif, URL main semula muncul serta-merta dalam papan pemuka pemantauan ralat apabila ranap bahagian hadapan direkodkan.

Butiran isu Sentry

Buka mana-mana isu dalam projek Sentry anda dan tatal ke bawah ke bahagian Tags . Anda akan melihat tag bernama mouseplayer_session_url. Anda juga boleh menapis isu Sentry menggunakan bar carian pertanyaan: mouseplayer_session_url:*.

Tab metadata Bugsnag

Dalam laporan ralat Bugsnag, semak tab navigasi bawah. Tab tersuai baharu bernama MousePlayer akan muncul, mengandungi hiperpautan boleh diklik session_url .

Datadog RUM Error Explorer

Dalam Datadog RUM, navigasi ke mana-mana sesi ralat dirakam dan periksa pepohon JSON Global Context / Attributes . URL diindeks di bawah @mouseplayer_session_url.

Semua tanda dagangan yang disebut di sini milik pemilik masing-masing. MousePlayer tidak mempunyai hubungan perniagaan dengan penyedia ini.