Sentry, Bugsnag & Datadog RUM Köprüsü

1. Sorun: Yığın izleri kullanıcı bağlamını göstermez

Web sitenizde yakalanmamış bir JavaScript istisnası veya ağ çökmesi oluştuğunda Sentry gibi hata izleme araçları yalnızca teknik yığın izleri ve tarayıcının kullanıcı aracısı dizelerini sunar. Ancak geliştiriciler şu soruları sormaya devam eder: “Kullanıcı çökmeden hemen önce hangi düğmeye tıkladı?” veya “Forma hangi veriler girildi?”

MousePlayer Hata Takibi Köprüsü , görsel yeniden oynatma URL'lerini doğrudan hata raporlarınıza aktararak bunu otomatik olarak çözer. Bir istisna oluştuğunda geliştiriciler Sentry veya Bugsnag gösterge panellerindeki tek bir bağlantıya tıklayabilir ve kullanıcının ekranının çökme anına kadar olan video kaydını milisaniye hassasiyetinde izleyebilir.

Ek Yük Getirmeyen Entegrasyon: Köprü, şu dosyanın içinde sessizce bir arka plan izleyicisi olarak çalışır: mp.js. Ölçülebilir bir ek yük oluşturmadan veya Core Web Vitals'ı etkilemeden hata takibi SDK'nızı otomatik olarak algılar.

2. Etkinleştirme & sağlayıcı eşleştirmesi

Hata takibi köprüsünü gösterge paneli arayüzünüzden veya SDK yapılandırma nesnemiz aracılığıyla programatik olarak etkinleştirebilirsiniz.

Yöntem A: Gösterge panelinden etkinleştirme (kod gerektirmez)

MousePlayer çalışma alanınıza giriş yapın ve şu bölümü açın: Siteleriniz.
Hedef web sitenizin yanındaki Ayarlar / Entegrasyonlar düğmesine tıklayın.
Entegrasyonlar penceresinde Sentry, Bugsnag & Datadog RUM Köprüsü seçeneğini şu duruma getirin: ON.
Sağlayıcınızı seçin (sentry, bugsnag veya datadog) ve Değişiklikleri Kaydet düğmesine tıklayın.

Yöntem B: Betiği elle yapılandırma

Yapılandırmayı doğrudan koda eklemeyi tercih ediyorsanız şu değeri iletin: error_bridge_active: true ; bunu şu nesnenin içine ekleyin: window.mp_config .

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

3. Teknik SDK yürütme tablosu

MousePlayer, seçtiğiniz sağlayıcıya bağlı olarak resmi JavaScript SDK etiketleme yöntemlerini otomatik olarak çalıştırır:

Sağlayıcı	Çalıştırılan JavaScript yöntemi	Eklenen üstveri anahtarı
Sentry	`window.Sentry.setTag(...)`	`mouseplayer_session_url`
Bugsnag	`window.Bugsnag.addMetadata('MousePlayer', { ... })`	`session_url`
Datadog RUM	`window.DD_RUM.setGlobalContextProperty(...)`	`mouseplayer_session_url`

4. Hata raporlarınızda yeniden oynatmalar nerede bulunur?

Etkinleştirildiğinde, ön yüzde bir çökme kaydedildiği anda yeniden oynatma URL'leri hata izleme gösterge panellerinizde görünür.

Sentry sorun ayrıntıları

Sentry projenizde herhangi bir sorunu açın ve aşağıdaki bölüme kaydırın: Etiketler . Şu ada sahip bir etiket göreceksiniz: mouseplayer_session_url. Ayrıca sorgu arama çubuğunu kullanarak Sentry sorunlarını filtreleyebilirsiniz: mouseplayer_session_url:*.

Bugsnag üstveri sekmeleri

Bugsnag hata raporunuzda alt gezinme sekmelerine bakın. Şu ada sahip yeni bir özel sekme görünür: MousePlayer . Bu sekmede tıklanabilir şu bağlantı bulunur: session_url .

Datadog RUM hata gezgini

Datadog RUM'da kayıtlı herhangi bir hata oturumuna gidin ve şu JSON ağacını inceleyin: Genel Bağlam / Nitelikler . URL şu anahtar altında dizine eklenir: @mouseplayer_session_url.

Nasıl yardımcı olabiliriz?