גשר Sentry, Bugsnag & Datadog RUM

האצת תהליכי הנדסה ו-QA באמצעות קישור חריגות JavaScript בצד הלקוח ישירות להקלטות וידאו של סשנים ב-MousePlayer.

1. הבעיה: עקבות מחסנית אינן מציגות הקשר משתמש

כשמתרחשת באתר חריגת JavaScript לא מטופלת או קריסת רשת, כלי ניטור שגיאות כגון Sentry מספקים עקבות מחסנית יבשות ומחרוזות סוכן משתמש של הדפדפן. אך המהנדסים עדיין שואלים: “על איזה כפתור המשתמש לחץ ממש לפני הקריסה?” או “אילו נתונים הוזנו בטופס?”

הגשר MousePlayer Error Tracking Bridge פותר זאת אוטומטית באמצעות קישור כתובות URL של הקלטות חזותיות ישירות לדוחות השגיאה. בעת חריגה, מהנדסים יכולים ללחוץ על קישור אחד בלוח המחוונים של 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. היכן נמצאות ההקלטות בדוחות השגיאה

לאחר ההפעלה, כתובות URL של הקלטות מופיעות מיד בלוחות ניטור השגיאות בכל רישום קריסה בצד הלקוח.

פרטי בעיה ב-Sentry

יש לפתוח בעיה כלשהי בפרויקט Sentry ולגלול לחלק Tags — יופיע תג בשם mouseplayer_session_url. ניתן גם לסנן בעיות Sentry באמצעות שורת חיפוש השאילתות: mouseplayer_session_url:*.

לשוניות מטא-נתונים ב-Bugsnag

בדוח השגיאה ב-Bugsnag יש לבדוק את לשוניות הניווט התחתונות. תופיע לשונית מותאמת חדשה בשם MousePlayer ובה הקישור הלחיץ session_url לצפייה בהקלטה.

Error Explorer ב-Datadog RUM

ב-Datadog RUM יש לעבור לסשן שגיאה מוקלט כלשהו ולבדוק את עץ JSON Global Context / Attributes ובו ה-URL מאונדקס תחת @mouseplayer_session_url.

כל הסימנים המסחריים המוזכרים כאן שייכים לבעליהם בהתאמה. ל-MousePlayer אין קשר עסקי עם ספקים אלה.