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