تحديد المشاكل وحلّها في Crashlytics والأسئلة الشائعة بشأنها
تقدّم هذه الصفحة مساعدة في تحديد المشاكل وحلّها وإجابات عن الأسئلة الشائعة.
حول استخدام Crashlytics. إذا كنت
يتعذّر عليك العثور على ما تبحث عنه أو تحتاج إلى مزيد من المساعدة، يُرجى الاتصال
دعم Firebase:
الإجراءات العامّة لتحديد المشاكل وحلّها/الأسئلة الشائعة
ظهور تنسيقات مختلفة
(و "الاختلافات أحيانًا") في بعض المشاكل ضمن جدول المشاكل.
قد تلاحظ تنسيقين مختلفين للمشاكل المدرجة في جدول المشاكل.
في وحدة تحكُّم Firebase. وقد تلاحظ أيضًا ميزة تسمى
"المتغيرات" ضمن بعض مشكلاتك. إليك السبب.
في أوائل العام 2023، طرحنا محرّك تحليل محسّن لتجميع الأحداث
بالإضافة إلى تصميم محدّث وبعض الميزات المتقدمة للمشكلات الجديدة (مثل
من الأشكال المختلفة!). اطّلِع على أحدث فيديوهاتنا
مشاركة مدونة
عن جميع التفاصيل، ولكن يمكنك قراءة أدناه للحصول على النقاط البارزة.
يحلل Crashlytics جميع الأحداث في تطبيقك (مثل حالات التعطّل، والمحتوى غير الفادح،
وأخطاء ANR) وينشئ مجموعات من الأحداث باسم المشاكل، وهي كل الأحداث في
المشكلات لديك نقطة شائعة من الفشل.
لتجميع الأحداث في هذه المشاكل، يختبر محرك التحليل المحسّن الآن
على العديد من جوانب الحدث، بما في ذلك الإطارات في تقرير تتبُّع تسلسل استدعاء الدوال البرمجية،
ورسالة الاستثناء ورمز الخطأ والنظام الأساسي أو نوع الخطأ الآخر
وسماتها الشخصية.
ومع ذلك، في هذه المجموعة من الأحداث، يؤدي تتبع تسلسل استدعاء الدوال البرمجية إلى حدوث تعذُّر
قد يكون مختلفًا. وقد يؤدي اختلاف عملية تتبُّع تسلسل استدعاء الدوال البرمجية إلى سبب أساسي مختلف.
لتمثيل هذا الاختلاف المحتمل ضمن مشكلة، ننشئ الآن
خيارات المنتج ضمن المشاكل: كل صيغة هي مجموعة فرعية من الأحداث في مشكلة معيّنة
التي لها نقطة العطل نفسها وتتبُّع تسلسل استدعاء الدوال البرمجية مشابهًا. مع متغيرات
يمكنك تصحيح الأخطاء في عمليات تتبُّع تسلسل استدعاء الدوال البرمجية الأكثر شيوعًا ضمن المشكلة وتحديد ما إذا كان
الأسباب الجذرية المختلفة تؤدي إلى الإخفاق.
في ما يلي تجربتك هذه التحسينات:
البيانات الوصفية المجدَّدة المعروضة ضمن صف المشكلة أصبح من السهل فهم المشاكل وتصنيفها في تطبيقك.
انخفاض عدد المشاكل المكرّرة لا يؤدي تغيير رقم السطر إلى حدوث مشكلة جديدة.
تصحيح الأخطاء بسهولة أكبر في ما يتعلق بالمشاكل المعقّدة ذات الأسباب الجذرية المتنوعة استخدِم الصيغ لتصحيح أخطاء عمليات تتبُّع تسلسل استدعاء الدوال البرمجية الأكثر شيوعًا ضمن مشكلة معيّنة.
تنبيهات وإشارات أكثر فائدة تشير المشكلة الجديدة إلى خطأ جديد.
بحث أكثر فعالية تحتوي كل مشكلة على بيانات وصفية أكثر قابلية للبحث
مثل نوع الاستثناء واسم الحزمة.
في ما يلي طريقة طرح هذه التحسينات:
عندما نتلقّى أحداثًا جديدة من تطبيقك، سنتحقّق مما إذا كانت تتطابق مع حدث حالي.
المشكلة.
إذا لم يتم العثور على نتيجة مطابِقة، سنطبّق تلقائيًا طريقة التجميع الأذكى للأحداث إلى مجموعات
على الحدث وإنشاء مشكلة جديدة في البيانات الوصفية التي تم تجديدها
التصميم.
هذا هو أول تحديث مهم نجريه على تجميع الفعاليات. إذا كنت
إذا كانت لديك ملاحظات أو واجهت أي مشاكل، يُرجى إبلاغنا بها من خلال
تقديم بلاغ.
لا أرى
مقاييس خالية من الأعطال و/أو تنبيهات السرعة
إذا لم تظهر لك مقاييس خالية من الأعطال (مثل الجلسات والمستخدمين الذين لم تواجههم أعطال)
و/أو تنبيهات السرعة، فتأكد من استخدام
عدم ظهور سجلّات شريط التنقّل
إذا كنت لا ترى
سجلات شريط التنقل
ننصحك بالتحقّق من إعدادات تطبيقك في "إحصاءات Google"
احرص على استيفاء المتطلبات التالية:
لقد
إلى تطبيقك. يجب إضافة حزمة SDK هذه بالإضافة إلى إلى حزمة Crashlytics.
أنت تستخدم
لكل المنتجات التي تستخدمها في التطبيق.
من يمكنه عرض الملاحظات وكتابتها وحذفها حول مشكلة ما؟
تسمح الملاحظات لأعضاء المشروع بالتعليق على مشكلات معينة بشأن الأسئلة والحالة
والتحديثات وما إلى ذلك.
عندما ينشر أحد أعضاء المشروع ملاحظة، يتم تصنيفها بعنوان البريد الإلكتروني من Google
الحساب. عنوان البريد الإلكتروني هذا مرئي، بالإضافة إلى الملاحظة، لجميع المشاريع
الأعضاء الذين لديهم إمكانية الدخول لعرض الملاحظة.
في ما يلي وصف إذن الوصول المطلوب للاطّلاع عليه والكتابة والحذف.
ملاحظات:
يمكن لأعضاء المشروع الذين لديهم أي من الأدوار التالية عرض العناصر الحالية وحذفها.
الملاحظات وكتابة ملاحظات جديدة حول مشكلة ما.
من يمكنه عرض الملاحظات وكتابتها وحذفها حول مشكلة ما؟
تسمح الملاحظات لأعضاء المشروع بالتعليق على مشكلات معينة بشأن الأسئلة والحالة
والتحديثات وما إلى ذلك.
عندما ينشر أحد أعضاء المشروع ملاحظة، يتم تصنيفها بعنوان البريد الإلكتروني من Google
الحساب. عنوان البريد الإلكتروني هذا مرئي، بالإضافة إلى الملاحظة، لجميع المشاريع
الأعضاء الذين لديهم إمكانية الدخول لعرض الملاحظة.
في ما يلي وصف إذن الوصول المطلوب للاطّلاع عليه والكتابة والحذف.
ملاحظات:
يمكن لأعضاء المشروع الذين لديهم أي من الأدوار التالية عرض العناصر الحالية وحذفها.
الملاحظات وكتابة ملاحظات جديدة حول مشكلة ما.
يستخدم التطبيق أيضًا
حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لا تظهر أعطالاً
إذا كان مشروعك يستخدم Crashlytics إلى جانب حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"،
فمن المحتمل أن يتدخل مراسلو الحوادث
تسجيل معالجات الاستثناء. لإصلاح المشكلة، يمكنك إيقاف ميزة الإبلاغ عن الأعطال في
SDK لإعلانات الأجهزة الجوّالة من خلال طلب disableSDKCrashReporting.
أين توجد مجموعة بيانات BigQuery؟
بعد ربط Crashlytics بـ BigQuery، يتم إنشاء مجموعات البيانات
تقع تلقائيًا في الولايات المتحدة، بغض النظر عن موقع
مشروع على Firebase.
دعم المنصة
المشاكل التي تم التراجع عنها
ما معنى الانحدار
المشكلة؟
تراجعت المشكلة عندما أنهيت المشكلة في السابق ولكن
ستتلقّى Crashlytics تقريرًا جديدًا يفيد بحدوث هذه المشكلة مرة أخرى.
يعيد تطبيق Crashlytics تلقائيًا فتح هذه المشاكل التي تراجعت،
ومعالجتها بالشكل المناسب لتطبيقك.
إليك مثال على سيناريو يشرح كيفية تصنيف تطبيق Crashlytics
كانحدار:
يتلقّى تطبيق Crashlytics لأول مرة تقرير أعطال عن الأعطال.
"A". يفتح Crashlytics مشكلة ذات صلة بهذا العطل (المشكلة "أ").
إصلاح هذا الخطأ بسرعة، وإغلاق المشكلة "أ"، ثم طرح إصدار جديد من
تطبيقك.
Crashlytics يحصل على تقرير آخر عن المشكلة "أ" بعد إغلاق
المشكلة.
إذا كان التقرير من إصدار تطبيق سبق أن تعرّف عليه تطبيق Crashlytics
عندما أنهيت المشكلة (مما يعني أن الإصدار قد حدث عطل)
عن أي عطل على الإطلاق)، فلن تراعي Crashlytics
المشكلة على أنها تراجعت. ستظل المشكلة مغلقة.
إذا كان التقرير صادرًا من إصدار تطبيق لم ينفّذه Crashlytics
إلى معرفة عند إغلاق المشكلة (ما يعني أنّ الإصدار
لم يرسل أي تقرير أعطال على الإطلاق)، ثم
يعتبر Crashlytics أن المشكلة قد تراجعت وتعيد فتح
المشكلة.
عندما تتراجع إحدى المشكلات، نرسل تنبيه كشف الانحدار ونضيف
إشارة انحدار إلى المشكلة لإعلامك بأنّ Crashlytics
أعاد فتح المشكلة. إذا لم تكن ترغب في إعادة فتح أحد المشكلات بسبب
خوارزمية الانحدار، "كتم الصوت" المشكلة بدلاً من إغلاقها.
لماذا أرى تراجعًا
في إصدارات التطبيق القديمة؟
إذا كان التقرير من إصدار تطبيق قديم لم يسبق له إرسال أي تقارير أعطال في
عندما أغلقت المشكلة، سينظر Crashlytics في المشكلة
التراجع عنه وإعادة فتح المشكلة.
يمكن أن يحدث هذا الموقف في الموقف التالي: لقد أصلحت خطأً
بإصدار جديد من تطبيقك، ولكن لا يزال لديك مستخدمون تستخدم إصدارات قديمة
بدون إصلاح الخطأ. وإذا لم يتم إرسال إحدى هذه النُسخ السابقة مطلقًا، عن طريق الصدفة
على الإطلاق عند إغلاق المشكلة، ويبدأ هؤلاء المستخدمون
الخطأ، فإن تقارير الأعطال هذه ستؤدي إلى ظهور مشكلة تراجع التراجع.
إذا كنت لا تريد إعادة فتح المشكلة بسبب خوارزمية الانحدار، يمكنك استخدام "كتم الصوت"
المشكلة بدلاً من إغلاقها.
