تحديد المشاكل وحلّها في ميزة "مراقبة الأداء" والأسئلة الشائعة

كيفية عرض رسائل السجلّ لأحداث الأداء

1. فعِّل ميزة تسجيل معلومات تصحيح الأخطاء باتّباع الخطوات التالية:

   1. في Xcode (الإصدار 15.2 بحد أدنى)، اختَر المنتج > المخطّط > تعديل المخطّط.
   2. انقر على تشغيل من القائمة اليمنى، ثمّ انقر على علامة التبويب الوسيطات.
   3. في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed on Launch)، أضِف -FIRDebugEnabled.

2. راجِع رسائل السجلّ بحثًا عن أي رسائل خطأ.

3. تضع Performance Monitoring علامة Firebase/Performance على رسائل السجلّ كي تتمكّن من فلترة رسائل السجلّ.

4. تحقّق من أنواع السجلّات التالية التي تشير إلى أنّ Performance Monitoring يُسجِّل أحداث الأداء:

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

5. انقر على عنوان URL لعرض بياناتك في وحدة تحكُّم Firebase. قد يستغرق تعديل البيانات في لوحة البيانات بضع ثوانٍ.

إذا لم يكن تطبيقك يسجّل أحداث الأداء، راجِع نصائح تحديد المشاكل وحلّها.

Added the SDK to app, but console still says to add SDK

يمكن لمنصّة Firebase رصد ما إذا كنت قد أضفت حزمة تطوير البرامج (SDK) لنظام التشغيل Performance Monitoring إلى تطبيقك بنجاح، وذلك عند تلقّيها معلومات عن الأحداث (مثل التفاعلات مع التطبيق) من تطبيقك. وعادةً ما تظهر رسالة "تم رصد حزمة SDK" في لوحة بيانات الأداء لوحة تحكّم Firebase خلال 10 دقائق من بدء تشغيل تطبيقك. بعد ذلك، في غضون 30 دقيقة، تعرض لوحة البيانات البيانات الأولية التي تمت معالجتها.

إذا مرّ أكثر من 10 دقائق على إضافة أحدث إصدار من حزمة تطوير البرامج (SDK) إلى تطبيقك، ولم يظهر أي تغيير بعد، يمكنك الاطّلاع على رسائل logging للتأكّد من أنّ Performance Monitoring يسجّل الأحداث. جرِّب خطوات تحديد المشاكل وحلّها المناسبة كما هو موضّح أدناه لتحديد سبب تأخُّر ظهور رسالة رصد حزمة SDK وحلّ المشكلة.

تشير Console إلى أنّه تم رصد حزمة SDK ، ولكن لا يتم عرض أي بيانات.

تعالج Performance Monitoring بيانات أحداث الأداء قبل عرضها في لوحة بيانات الأداء.

إذا مرّ أكثر من 24 ساعة على ظهور رسالة "تم رصد حزمة تطوير البرامج (SDK)"، وما زال لا تظهر لك البيانات، يُرجى التحقّق من لوحة بيانات حالة Firebase في حال حدوث تعطُّل معروف. إذا لم يكن هناك انقطاع في الخدمة، يُرجى التواصل مع فريق دعم Firebase.

لا يسجِّل التطبيق أحداث الأداء.

إذا لم تظهر لك رسائل السجلّ لأحداث الأداء، جرِّب خطوات تحديد المشاكل وحلّها التالية:

1. تأكَّد من أنّ حزمة Performance Monitoring SDK لم يتم إيقافها باستخدام أيّ من العلامتَين التاليتَين في ملف Info.plist:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. تأكَّد من أنّ Performance Monitoring غير مُوقوف أثناء التشغيل (Swift | Obj-C).

3. إذا لم تتمكّن من العثور على أي ميزة تم إيقافها في تطبيقك، تواصَل مع فريق دعم Firebase.

لوحة بيانات الأداء لا تتضمّن بيانات تتبُّع الشاشة

إذا كانت بيانات تتبُّع عرض الشاشة غير متوفّرة، جرِّب الخطوات التالية لتحديد المشاكل وحلّها:

1. تأكَّد من استخدام أحدث إصدار من حزمة تطوير البرامج (SDK) لمنصّات Apple (الإصدار 11.6.0). لا تتوفّر عمليات تتبُّع عرض الشاشة إلا مع الإصدار 5.0.0 أو الإصدارات الأحدث.

2. لا يُنشئ Performance Monitoring عمليات تتبُّع لعرض الشاشة في عناصر التحكّم في عرض الحاوية (مثل UINavigationController وUITabBarController). إذا كانت البيانات مفقودة لهذه الشاشات فقط، هذا السلوك المتوقّع.

لوحة بيانات الأداء لا تتضمّن بيانات التتبّع المخصّصة

هل تظهر لك بيانات الأداء للمسارات التي يتم جمعها تلقائيًا ولكن ليس لمسار الرموز البرمجية المخصّصة؟ يُرجى اتّباع الخطوات التالية لتحديد المشاكل وحلّها:

1. تحقَّق من إعداد عمليات تتبُّع الرموز المخصّصة التي تمّ إعدادها من خلال Trace API، ولا سيما ما يلي:

   • يجب أن تستوفي أسماء عمليات تتبُّع الرموز البرمجية المخصّصة والمقاييس المخصّصة المزدوجة المتطلبات التالية: عدم استخدام مسافات بيضاء في بداية الاسم أو نهايته، وعدم استخدام علامة تحت خط (_) في بداية الاسم، ويجب ألا يزيد طول الاسم عن 32 حرفًا.
   • يجب بدء جميع عمليات التتبّع وإيقافها. ولن يتم تسجيل أيّ عملية تتبُّع لم يتم بدؤها أو إيقافها أو إيقافها قبل بدؤها.

2. تحقَّق من رسائل السجلّ للتأكّد من أنّ Performance Monitoring يسجِّل عمليات تتبُّع الرموز المخصّصة المتوقّعة.

3. إذا كان Performance Monitoring يسجّل الأحداث، ولكن لا تظهر أي بيانات بعد 24 ساعة، يُرجىالتواصل مع فريق دعم Firebase.

لا تتوفّر بيانات طلبات الشبكة في لوحة بيانات الأداء

إذا لم تتوفّر لديك بيانات طلبات الشبكة، جرِّب خطوات تحديد المشاكل وحلّها التالية:

1. تحقَّق من عدم توافق مكتبة الشبكة. Performance Monitoring تجمع تلقائيًا مقاييس طلبات الشبكة التي تستخدِم مكتبات الشبكة التالية:

   • بالنسبة إلى Swift: URLSession وURLConnection
   • بالنسبة إلى Objective-C: NSURLSession وNSURLConnection

   يُرجى العِلم أنّه يمكنك إضافة ميزة تتبُّع مخصّصة لطلبات الشبكة.

2. يُرجى مراعاة ما يلي:

   • استنادًا إلى سلوك الرمز البرمجي ومكتبات الشبكات المستخدَمة في الرمز البرمجي، قد لا يُبلغ Performance Monitoring إلا عن طلبات الشبكة التي تم إكمالها. وهذا يعني أنّ اتصالات HTTP/S التي تبقى مفتوحة قد لا يتم تسجيلها.

   • لا يُبلغ Performance Monitoring عن طلبات الشبكة التي تحتوي على عناوين Content-Type غير صالحة. ومع ذلك، سيظلّ قبول طلبات الشبكة التي لا تتضمّن عناوين Content-Type.

لا يتم تجميع بيانات طلبات الشبكة على النحو المتوقّع.

اطّلِع على مزيد من المعلومات عن كيفية تجميع Performance Monitoring لข้อมูล طلبات الشبكة ضمن أنماط عناوين URL.

يمكنك أيضًا تجربة أنماط عناوين URL المخصّصة.

ما الذي حدث لأبرز المشاكل في بطاقة "الأداء" على صفحة المشروع الرئيسية؟

لقد استبدلنا أهمّ المشاكل بـ التنبيهات الأخيرة في إطار متابعة الميزات التي طرحناها مؤخرًا للتنبيهات، والتي تُعلمك تلقائيًا عند تجاوز الحدود التي تحدّدها. تم إيقاف المشاكل نهائيًا وتم استبدالها بالتنبيهات.

تصفِّح أداة اختيار التطبيقات في أعلى بطاقة "الأداء" إدخالات التنبيهات ضمن التنبيهات الأخيرة. لا يتم عرض سوى آخر ثلاثة تنبيهات للتطبيقات التي تم اختيارها.

لمزيد من المعلومات عن التنبيهات، اطّلِع على مقالة إعداد تنبيهات بشأن مشاكل الأداء.

ما الذي حدث لإمكانية ضبط الحدود القصوى للمشاكل في وحدة التحكّم؟

تتيح Performance Monitoring التنبيهات للمقاييس التي تتجاوز الحدود الدنيا المحدّدة. لتجنُّب حدوث التباس مع هذه الحدود القابلة للضبط ومقاييس الأداء، أزلنا إمكانية ضبط الحدود القصوى لالمشاكل.

ما الذي حدث لمعلومات "التفاصيل والمقاييس" في وحدة تحكّم Firebase؟

لقد استبدلنا صفحتَي "التفاصيل" و"المقاييس" بواجهة مستخدم (UI) مركزية تمت إعادة تصميمها حديثًا لتحسين طريقة تحديد المشاكل وحلّها. توفّر واجهة مستخدِم تحديد المشاكل وحلّها الجديدة هذه الوظائف الأساسية نفسها التي كانت توفّرها "التفاصيل" و"المقاييس". لمزيد من المعلومات عن تحديد المشاكل وحلّها، يُرجى الاطّلاع على مقالة عرض المزيد من البيانات لتتبُّع معيّن.

لماذا لا يكون عدد العيّنات على النحو المتوقّع؟

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

لإدارة حجم البيانات التي نجمعها، يستخدم Performance Monitoring خيارات أخذ العينات التالية:

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

• التحليل الديناميكي: Performance Monitoring يجمع عددًا محدودًا من عمليات تتبُّع الرموز البرمجية وعمليات تتبُّع طلبات الشبكة لكل تطبيق يوميًا على مستوى جميع مستخدمي التطبيق. يتم جلب معدّل قياس ديناميكي على الأجهزة (باستخدام Firebase Remote Config) لتحديد ما إذا كان يجب على جهاز عشوائي تسجيل عمليات التتبّع وإرسالها. لا يُرسِل أي جهاز لم يتم اختياره لتحليل عيّنات أي أحداث. يكون معدّل أخذ العينات الديناميكي متعلقًا بالتطبيق ويتم تعديله لضمان بقاء إجمالي حجم البيانات التي يتم جمعها تحت الحدّ المسموح به.

  تحصل المشاريع التي فعّلت دمج BigQuery على حدّ أقصى أعلى ل عدد عمليات تتبُّع طلبات الشبكة.

  تُرسِل جلسات المستخدمين بيانات إضافية ومفصّلة من جهاز المستخدم، ما يتطلّب مزيدًا من الموارد لتسجيل البيانات وإرسالها. للحدّ من تأثير جلسات المستخدِمين، قد يفرض Performance Monitoring أيضًا قيودًا على عدد الجلسات.

• وضع حدود للمعدل من جهة الخادم: لضمان عدم تجاوز التطبيقات حدود تحليل عيّنات الأداء، قد تستخدم Performance Monitoring تحليل عيّنات الأداء من جهة الخادم لحذف بعض الأحداث التي يتم تلقّيها من الأجهزة. على الرغم من أنّ هذا النوع من التقييد لا يغيّر فعالية مقاييسنا، إلا أنّه قد يتسبب في حدوث تغييرات طفيفة في الأنماط، بما في ذلك ما يلي:

  • يمكن أن يختلف عدد عمليات التتبّع عن عدد المرات التي تم فيها تنفيذ قطعة من الرمز البرمجي.
  • قد تحتوي كل عملية تتبُّع مرتبطة ارتباطًا وثيقًا في الرمز البرمجي على عدد مختلف من عيّنات.

ماذا حدث لعلامة التبويب المشاكل في وحدة التحكّم؟

لقد استبدلنا علامة التبويب "المشاكل" بميزة "التنبيهات" التي تُعلمك تلقائيًا عند تجاوز الحدود التي تحدّدها. لم يعد عليك الاطّلاع يدويًا على وحدة تحكّم Firebase لتحديد حالة الحدّ الأدنى. للتعرّف على التنبيهات، اطّلِع على إعداد تنبيهات بشأن مشاكل الأداء.

ماذا حدث لعلامتَي التبويب على الجهاز والشبكة في وحدة التحكّم؟ كيف يمكنني عرض عمليات التتبّع التي كانت على هذه الصفحات؟

أعدنا تصميم قسم Performance Monitoring في وحدة تحكّم Firebase لكي تعرض علامة التبويب لوحة البيانات المقاييس الرئيسية وجميع عمليات التتبّع في مساحة واحدة. في إطار عملية إعادة التصميم، أزلنا صفحتَي على الجهاز والشبكة.

يحتوي جدول عمليات التتبّع في أسفل علامة التبويب لوحة البيانات على كلّ المعلومات نفسها التي تعرضها علامتا التبويب على الجهاز والشبكة، ولكن مع بعض الميزات المضافة، بما في ذلك إمكانية ترتيب عمليات التتبّع حسب النسبة المئوية للتغيير لمقياس معيّن. لعرض جميع المقاييس والبيانات المتعلّقة بمسار traced معيّن، انقر على اسم المسار في جدول المسارات.

يمكنك الاطّلاع على عمليات التتبّع في علامات التبويب الفرعية التالية من جدول عمليات التتبّع:

• عمليات تتبُّع طلبات الشبكة (التلقائية والمخصّصة) - علامة التبويب الفرعية طلبات الشبكة
• عمليات تتبُّع الرموز البرمجية المخصّصة: علامة التبويب الفرعية عمليات التتبُّع المخصّصة
• عمليات تتبُّع بدء التطبيق والتطبيق الذي يعمل في المقدّمة والتطبيق الذي يعمل في الخلفية: علامة التبويب الفرعية عمليات التتبُّع المخصّصة
• عمليات تتبُّع عرض الشاشة: علامة التبويب الفرعية عرض الشاشة
• عمليات تتبُّع تحميل الصفحة - علامة التبويب الفرعية تحميل الصفحة

للاطّلاع على تفاصيل عن جدول عمليات التتبّع وعرض المقاييس والبيانات، يُرجى الانتقال إلى صفحة النظرة العامة على وحدة التحكّم (iOS والإصدارات الأحدث | Android | الويب).

لماذا لا يكون عدد اللقطات البطيئة والمجمّدة على النحو المتوقّع؟

يتم احتساب اللقطات التي يتم عرضها ببطء واللقطات المتوقّفة باستخدام معدل إعادة تحميل جهاز افتراضي يبلغ ‎60 هرتز. إذا كان معدّل تحديث الشاشة على الجهاز أقل من 60 هرتز، سيكون وقت عرض كل لقطة أبطأ لأنّه يتم عرض عدد أقل من اللقطات في الثانية. يمكن أن تؤدي أوقات العرض البطيئة إلى الإبلاغ عن المزيد من اللقطات البطيئة أو المتوقّفة لأنّ المزيد من اللقطات ستظهر بشكل أبطأ أو ستتوقّف. ومع ذلك، إذا كان معدل التحديث في الجهاز أعلى من 60 هرتز، سيكون وقت عرض كل لقطة أسرع. وقد يؤدي ذلك إلى الإبلاغ عن عدد أقل من اللقطات البطيئة أو المتوقّفة. هذا هو أحد القيود المفروضة حاليًا على حزمة SDK لنظام التشغيل Performance Monitoring.

يستغرق تصدير بيانات Performance Monitoring إلى BigQuery وقتًا أطول من المتوقّع. هل هذا ليس في الوقت الفعلي؟

إذا فعّلت عملية دمج BigQuery في Firebase Performance Monitoring، سيتم تصدير بياناتك إلى BigQuery بعد 12 إلى 24 ساعة من نهاية اليوم (بتوقيت тихоокеанي ).

على سبيل المثال، ستتوفّر بيانات 19 نيسان (أبريل) في BigQuery في 20 نيسان (أبريل) بين الساعة 12:00 بعد الظهر والتصفية منتصف الليل (جميع التواريخ والأوقات بالتوقيت الرسمي للمحيط الهادئ).

ما المقصود ببيانات الأداء "في وقت قريب من الوقت الفعلي"؟

تعالج Firebase Performance Monitoring بيانات الأداء التي يتم جمعها فور ورودها، ما يؤدي إلى عرض البيانات في وقت قريب من الوقت الفعلي في وحدة تحكّم Firebase. تظهر البيانات التي تمت معالجتها في وحدة التحكّم خلال بضع دقائق من جمعها، ومن هنا جاء المصطلح "في الوقت الفعلي التقريبي".

للاستفادة من ميزة معالجة البيانات في وقت قريب من الوقت الفعلي، تأكَّد من أنّ تطبيقك يستخدم إصدارًا من حزمة SDK متوافقًا مع الوقت الفعلي.

كيف يمكنني الحصول على بيانات الأداء في الوقت الفعلي تقريبًا لتطبيقي؟

للاستفادة من ميزة معالجة البيانات في الوقت الفعلي تقريبًا، ما عليك سوى التأكّد من أنّ تطبيقك يستخدم إصدارًا من Performance Monitoring SDK متوافقًا مع معالجة البيانات في الوقت الفعلي.

في ما يلي إصدارات حزمة SDK المتوافقة مع الوقت الفعلي:

• ‫iOS: الإصدار 7.3.0 أو إصدار أحدث
• tvOS: الإصدار 8.9.0 أو إصدار أحدث
• Android: الإصدار 19.0.10 أو إصدار أحدث (أو Firebase Android BoM الإصدار 26.1.0 أو إصدار أحدث)
• الويب: الإصدار 7.14.0 أو إصدار أحدث

يُرجى العِلم أنّنا ننصح دائمًا باستخدام أحدث إصدار من حزمة SDK، ولكن أي إصدار من الحزمة مُدرَج أعلاه سيتيح لتطبيق Performance Monitoring معالجة بياناتك في وقتٍ يقترب من الزمن الفعلي.

ما هي إصدارات حزمة تطوير البرامج (SDK) من Performance Monitoring التي تُعدّ متوافقة مع الوقت الفعلي؟

في ما يلي إصدارات حزمة SDK المتوافقة مع معالجة البيانات في الوقت الفعلي:

• ‫iOS: الإصدار 7.3.0 أو إصدار أحدث
• tvOS: الإصدار 8.9.0 أو إصدار أحدث
• Android: الإصدار 19.0.10 أو إصدار أحدث (أو Firebase Android BoM الإصدار 26.1.0 أو إصدار أحدث)
• الويب: الإصدار 7.14.0 أو إصدار أحدث

يُرجى العِلم أنّنا ننصح دائمًا باستخدام أحدث إصدار من حزمة SDK، ولكن أي إصدار من الحزمة مُدرَج أعلاه سيتيح لتطبيق Performance Monitoring معالجة بياناتك في وقتٍ يقترب من الزمن الفعلي.

ماذا يحدث إذا لم أتحّدث تطبيقي لاستخدام إصدار متوافق مع الوقت الفعلي من حزمة SDK؟

إذا كان تطبيقك لا يستخدم إصدارًا متوافقًا مع ميزة "الأداء في الوقت الفعلي"، سيظل بإمكانك الاطّلاع على جميع بيانات أداء تطبيقك في وحدة تحكّم Firebase. ومع ذلك، سيتم تأخير عرض بيانات الأداء لمدة 36 ساعة تقريبًا من وقت جمعها.

لقد أجريت تحديثًا إلى إصدار متوافق من حزمة SDK في الوقت الفعلي، ولكن لا يزال بعض المستخدمين يستخدمون إصدارات قديمة من تطبيقي. هل سيستمر ظهور بيانات أدائهم في وحدة تحكّم Firebase؟

نعم. بغض النظر عن إصدار حزمة SDK التي تستخدمها إحدى نُسخ التطبيق، ستظهر لك بيانات الأداء من جميع المستخدمين.

ومع ذلك، إذا كنت تطّلع على بيانات حديثة (أقل من 36 ساعة تقريبًا)، تكون البيانات المعروضة من مستخدمي نُسخ التطبيق التي تستخدم إصدارًا من حزمة SDK متوافقًا مع الوقت الفعلي. في المقابل، تتضمّن البيانات غير الحديثة بيانات الأداء من جميع إصدارات تطبيقك.