پل Sentry، Bugsnag & Datadog RUM

با پیوند مستقیم استثنای JavaScript سمت کاربر به ضبط دیداری نشست MousePlayer، کار مهندسی و QA را سریع کنید.

1. مسئله: رد پشته زمینهٔ کاربر را نشان نمی‌دهد

هنگام استثنای مدیریت‌نشدهٔ JavaScript یا خرابی شبکهٔ سایت، ابزار پایش خطا مانند Sentry رد پشتهٔ خشک و رشتهٔ user-agent مرورگر می‌دهد. اما مهندس هنوز می‌پرسد: «کاربر درست پیش از خرابی روی کدام دکمه کلیک کرد؟» یا «چه داده‌ای در فرم وارد شد؟»

این پل ردیابی خطای MousePlayer با افزودن مستقیم نشانی بازپخش دیداری به گزارش خطا خودکار مشکل را حل می‌کند. هنگام استثنا، مهندس با یک کلیک در داشبورد Sentry یا Bugsnag ضبط دیداری صفحهٔ کاربر را تا میلی‌ثانیهٔ دقیق خرابی می‌بیند.

یکپارچه‌سازی بدون سربار: پل بی‌صدا به‌شکل ناظر پس‌زمینه درون mp.js اجرا می‌شود. SDK ردیابی خطا را خودکار تشخیص می‌دهد، بدون افزودن سربار قابل اندازه‌گیری یا اثر بر Core Web Vitals.

2. فعال‌سازی & نگاشت ارائه‌دهنده

پل ردیابی خطا را از رابط داشبورد یا برنامه‌نویسی از شیء پیکربندی SDK فعال کنید.

روش A: فعال‌سازی داشبورد (بدون کد)

  1. وارد فضای کاری MousePlayer شوید و این بخش را باز کنید: املاک شما.
  2. روی دکمهٔ تنظیمات / یکپارچه‌سازی‌ها کنار سایت مقصد کلیک کنید.
  3. در پنجرهٔ یکپارچه‌سازی این گزینه را تغییر دهید: پل Sentry، Bugsnag & Datadog RUM به حالت ON.
  4. ارائه‌دهنده را انتخاب کنید (sentry، bugsnag یا datadog) و کلیک کنید: ذخیرهٔ تغییرات.

روش B: پیکربندی دستی اسکریپت

اگر پیکربندی مستقیم در کد را ترجیح می‌دهید، این را بدهید: 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. همچنین می‌توانید مسائل Sentry را با نوار جستجوی پرس‌وجو فیلتر کنید: mouseplayer_session_url:*.

برگهٔ فرادادهٔ Bugsnag

در گزارش خطای Bugsnag، برگه‌های پایین را ببینید. برگهٔ اختصاصی جدیدی با نام MousePlayer ظاهر می‌شود و دارای پیوند قابل کلیک با نام session_url است.

کاوشگر خطای Datadog RUM

در Datadog RUM به هر نشست خطای ثبت‌شده بروید و این درخت JSON را بررسی کنید: زمینهٔ سراسری / ویژگی‌ها . نشانی زیر این کلید نمایه می‌شود: @mouseplayer_session_url.

همهٔ علائم تجاری نام‌برده متعلق به مالکانشان‌اند. MousePlayer با این ارائه‌دهندگان رابطهٔ تجاری ندارد.