جسر Sentry وBugsnag & Datadog RUM

سرّع سير الهندسة وضمان الجودة بربط استثناءات JavaScript الأمامية مباشرة بتسجيلات جلسات MousePlayer المرئية.

1. المشكلة: تتبعات المكدس لا تعرض سياق المستخدم

عند استثناء JavaScript غير معالج أو عطل شبكة، توفر أدوات مثل Sentry تتبعات جافة وسلاسل وكيل المتصفح. لكن المهندسين يظلون يسألون: «أي زر نقره المستخدم قبل العطل مباشرة؟» أو «ما البيانات التي أُدخلت في النموذج؟»

يحل جسر تتبع الأخطاء في MousePlayer ذلك تلقائيًا بربط روابط إعادة التشغيل البصرية بتقارير الأخطاء. عند الاستثناء ينقر المهندس رابطًا واحدًا في لوحة Sentry أو Bugsnag ويشاهد تسجيل شاشة المستخدم حتى ميلي ثانية العطل الدقيقة.

تكامل دون عبء إضافي: يعمل الجسر بهدوء كمراقب خلفي داخل mp.js. يكتشف SDK تتبع الأخطاء تلقائيًا دون عبء قابل للقياس أو أثر على Core Web Vitals.

2. التفعيل & ربط المزودين

فعّل الجسر من لوحة المعلومات أو برمجيًا بكائن إعداد SDK.

الطريقة أ: تفعيل من لوحة المعلومات (دون كود)

  1. سجّل الدخول لمساحة MousePlayer وافتح مواقعك.
  2. انقر زر الإعدادات / التكاملات بجانب الموقع المطلوب.
  3. في نافذة التكاملات غيّر إعداد جسر Sentry وBugsnag & Datadog RUM إلى ON.
  4. اختر مزودك (sentry، bugsnag، أو datadog) وانقر حفظ التغييرات.

الطريقة ب: إعداد يدوي

إن فضّلت تثبيت الإعداد في الكود، مرر error_bridge_active: true داخل كائن window.mp_config :

<!-- 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. جدول تنفيذ 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. العثور على إعادات التشغيل في تقارير الأخطاء

بعد التفعيل، تظهر الروابط فورًا في لوحات مراقبة الأخطاء كلما سُجّل عطل أمامي.

تفاصيل مشكلة Sentry

افتح أي مشكلة في مشروع Sentry ومرّر لقسم الوسوم . سترى وسمًا باسم mouseplayer_session_url. يمكنك أيضًا تصفية المشكلات باستخدام شريط استعلام البحث: mouseplayer_session_url:*.

علامات بيانات Bugsnag الوصفية

في تقرير خطأ Bugsnag، افحص علامات التنقل السفلية. تظهر علامة مخصّصة جديدة باسم MousePlayer تتضمن رابط session_url القابل للنقر.

مستكشف أخطاء Datadog RUM

في Datadog RUM، انتقل لأي جلسة خطأ مسجّلة وافحص شجرة JSON الخاصة بـ السياق العام / السمات . يُفهرس URL تحت @mouseplayer_session_url.

كل العلامات التجارية المذكورة ملك لأصحابها. لا تربط MousePlayer علاقة تجارية بهؤلاء المزودين.