Spot هو إضافة لمتصفح Chrome تجعل الإبلاغ عن الأخطاء سريعًا وبسيطًا بشكل مذهل.

باستخدام Spot، يمكنك بسهولة تسجيل الأخطاء مباشرة من متصفحك ومشاركتها على الفور مع فريقك. والنتيجة النهائية هي تقرير أخطاء كامل وجاهز للمشاركة بصيغة فيديو، يتضمن إجراءات المستخدم وسجلات وأخطاء وحدة التحكم وحمولات الشبكة وبيانات وكيل المستخدم. باختصار، تحصل على كل ما تحتاجه للإبلاغ عن خطأ أسرع من أي وقت مضى، وكل ما يحتاجه فريقك لإصلاحه بالسرعة نفسها.

• يأتي Spot مع كل خطة من خطط OpenReplay، من إصدارنا مفتوح المصدر إلى عروضنا للمؤسسات.
• Spot هو إضافة لمتصفح Chrome تعمل أيضًا على أي متصفح يعتمد على Chromium، بما في ذلك Microsoft Edge وBrave وArc.

تثبيت إضافة Spot لمتصفح Chrome سريع وسهل:

1. انتقل إلى صفحة إضافة Spot على متجر Chrome الإلكتروني وانقر على “إضافة إلى Chrome”.
2. ثبّت Spot على شريط أدوات Chrome للوصول إليه بسهولة مستقبلًا.

قبل أن تبدأ في استخدام Spot، تحتاج إما إلى تسجيل الدخول إلى حساب OpenReplay الحالي الخاص بك أو إنشاء حساب جديد:

• OpenReplay cloud

  Section titled OpenReplay cloud
  • المستخدمون الجدد:
    1. بعد تثبيت Spot، انقر على أيقونة Spot في شريط الأدوات.
    2. اختر Create Account.
    3. اختر حالة الاستخدام الأساسية لديك مع OpenReplay.
    • إذا اخترت “الإبلاغ عن الأخطاء عبر Spot” كحالة الاستخدام الأساسية لديك، فيمكنك لاحقًا الوصول إلى ميزات OpenReplay الكاملة بالنقر على Setup Tracker.
    
  • المستخدمون الحاليون:
    1. انقر على إضافة Spot المثبّتة في شريط الأدوات.
    2. اختر Log in وأدخل بيانات اعتماد OpenReplay الخاصة بك.
    • يمكنك العثور على تسجيلات Spot الخاصة بك في قائمة Spot في الشريط الجانبي الأيسر.
    

• OpenReplay self-host

  Section titled OpenReplay self-host
  • المستخدمون الجدد والحاليون:
    • حدّث نسخة OpenReplay الخاصة بك إلى أحدث إصدار (v1.20.0) الذي يدعم Spot.
    • بمجرد التحديث، ستظهر قائمة Spot في الشريط الجانبي الأيسر. وستُحفظ تسجيلات Spot الخاصة بك بأمان على نسختك.

الآن بعد أن سجّلت الدخول، أصبحت جاهزًا تمامًا لبدء رصد الأخطاء والإبلاغ عنها باستخدام Spot.

إليك كيفية استخدام الميزات الرئيسية لإضافة Spot لمتصفح Chrome:

• بدء التسجيل: انقر على أيقونة Spot في شريط الأدوات واختر Record Tab لالتقاط كل شيء في علامة التبويب النشطة.

• تفعيل الميكروفون: عند الحاجة، فعّل خيار الميكروفون لتضمين الصوت في تسجيلك.

• إيقاف التسجيل مؤقتًا: انقر على أيقونة الإيقاف المؤقت من لوحة التسجيل في أي وقت.

• إعادة بدء التسجيل: انقر على أيقونة إعادة البدء من لوحة التسجيل لإعادة بدء التسجيل.

• إيقاف التسجيل: انقر على أيقونة الإيقاف من لوحة التسجيل لإيقاف التسجيل.

• إضافة تعليقات: يمكنك إضافة تعليقات لتوفير سياق إضافي قبل الحفظ.

• حفظ Spot: بعد إيقاف التسجيل، سيُحفظ تلقائيًا مع جميع التفاصيل التقنية ذات الصلة، مثل سجلات وحدة التحكم وبيانات الشبكة.

  

• بدء التسجيل: انقر على أيقونة Spot واختر Record Desktop. اختر تسجيل شاشتك بالكامل أو نافذة محددة.

يتضمن Spot تلقائيًا بيانات DevTools في كل تسجيل خطأ، مما يوفر لمطوريك السياق الكامل لتصحيح المشكلات بكفاءة. يلتقط كل تسجيل ما يلي:

• سجلات وحدة التحكم: جميع مخرجات وحدة التحكم والتحذيرات ورسائل الخطأ أثناء جلسة التسجيل.
• طلبات الشبكة: سجلات لجميع أنشطة الشبكة، بما في ذلك:
  • رؤوس وأجسام الطلبات والاستجابات: البيانات المُرسلة والمُستلمة في كل طلب.
  • رموز الحالة: حدّد بسرعة الطلبات الفاشلة أو التي بها مشكلات.
• بيانات وكيل المستخدم: معلومات حول متصفح المستخدم وجهازه لمساعدة المطورين على إعادة إنشاء البيئة التي حدث فيها الخطأ.
• بيانات تفاعل المستخدم: تفاصيل حول نشاط المستخدم، مثل النقرات ومسارات التنقل، مما يتيح للمطورين فهم كيفية مواجهة المشكلة.

ملاحظة حول أخطاء GraphQL

عادةً ما يُرجع GraphQL رمز الحالة 200 OK لجميع الاستجابات، حتى عندما تكون هناك أخطاء موجودة في جسم الاستجابة (تُوضع عادةً داخل حقل errors). وهذا قد يجعل من الصعب رصد المشكلات بالاعتماد على رمز حالة HTTP وحده.

في Spot، نكتشف عندما تحتوي استجابة GraphQL على كائن errors في الجسم. وعند العثور على مثل هذا الخطأ، نضع علامة على الطلب برمز الحالة 400 بدلاً من 200. وهذا التعديل يُسهّل على المطورين تحديد طلبات GraphQL التي بها مشكلات وتصحيحها.

• الوصول إلى الإعدادات: انقر على أيقونة Spot في شريط الأدوات واختر أيقونة Settings.
• الانتقال إلى علامة تبويب Spot بعد الحفظ: فعّل هذا الخيار للانتقال إلى تسجيل Spot مباشرة بعد الحفظ.
• تضمين DevTools: فعّل هذا الخيار لتضمين سجلات وحدة التحكم واستدعاءات الشبكة وغيرها من معلومات التصحيح في تسجيلك.

• إرسال الدعوات: انقر على Preferences، وانتقل إلى Team، وانقر على Add Team Member. أدخل اسمهم الكامل وعنوان بريدهم الإلكتروني، ثم أرسل الدعوة.
• وصول الفريق: يمكن لجميع أعضاء الفريق عرض تسجيلات Spot في عرض Spots في OpenReplay

تسجيلات Spot غير مرتبطة بأي مشروع محدد.

• المشاركة الخاصة: يمكن مشاركة تسجيلات Spot عبر روابط خاصة للعرض الداخلي ضمن فريقك على OpenReplay.
• المشاركة العامة: يمكنك إنشاء روابط عامة للعرض الخارجي، يمكن الوصول إليها حتى بدون حساب OpenReplay.
• التكامل مع الأدوات: ضمّن هذه الروابط في أدوات تتبع الأخطاء أو التعاون مثل Slack أو Teams أو Jira أو Linear لتسهيل الوصول والعمل الجماعي.

إذا واجهت خطأ HTTP 520 Unknown Error عند محاولة حفظ تسجيلات Spot، فهذا يشير عادةً إلى أن حجم ملف الفيديو يتجاوز حد الحجم المقبول لدى Cloudflare. وقد يحدث هذا عند تسجيل spots أطول أو spots ذات تفاعلات معقدة.

لحل هذه المشكلة:

1. ادخل إلى إعدادات نشر OpenReplay الخاصة بك على المسار: scripts/helmcharts/vars.yaml
2. حدّد موقع المتغير proxy-body-size (حوالي السطر 109)
3. زِد القيمة من القيمة الافتراضية 10m لاستيعاب التسجيلات الأكبر حجمًا
   • على سبيل المثال، إذا كنت بحاجة إلى رفع ملفات بحجم حوالي 36MB، فعليك تعيينها إلى 40m على الأقل

مثال على تعديل الإعدادات:

proxy-body-size: 40m  # Increase this value based on your recording size needs

بعد تحديث الإعدادات، طبّق التغييرات على نشرك حتى تصبح سارية المفعول.

هل تواجه مشكلة في إعداد هذه الإضافة؟ يُرجى الانضمام إلى Slack الخاص بنا أو الاطلاع على المنتدى والحصول على المساعدة من مجتمعنا.