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

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

1. افتح أدوات المطوّرين في المتصفّح (على سبيل المثال، علامة التبويب "الشبكة" في "أدوات مطوّري برامج Chrome" أو في Network Monitor for Firefox).

2. أعِد تحميل تطبيق الويب في المتصفّح.

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

4. بعد بضع ثوانٍ، ابحث عن طلب بيانات من الشبكة موجَّه إلى firebaselogging.googleapis.com في أدوات المطوّرين في المتصفّح. يشير توفّر طلب البيانات هذا إلى أنّ المتصفّح يرسل بيانات الأداء إلى 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. تأكَّد من أنّه تم إعداد حزمة تطوير البرامج (SDK) لنظام التشغيل Performance Monitoring بشكلٍ صحيح في تطبيقك.

2. تأكَّد من أنّ حزمة تطوير البرامج (SDK) لنظام التشغيل Performance Monitoring لم يتم إيقافها من خلال العلامة التالية:

   • performance.instrumentationEnabled

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

4. أغلِق علامة تبويب صفحة الويب ثم أعِد فتحها. يُرجى التحقّق من إمكانية تسجيل الدخول مرة أخرى.

   إذا أضفت للتو حزمة تطوير البرامج (SDK) لمنصة Performance Monitoring في تطبيقك، قد تحتاج إلى إعادة تشغيل تطبيقك بالكامل لكي تبدأ حزمة SDK في العمل.

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

لوحة بيانات الأداء لا تتضمّن بيانات مهلة الاستجابة لأوّل إدخال

إذا لم تظهر لك بيانات مقياس "وقت استجابة الإدخال الأول"، جرِّب folgermed الخطوات التالية لتحديد المشاكل وحلّها:

1. يُرجى العِلم أنّ Performance Monitoring لا يسجِّل مقياس أول تأخّر في الإدخال إلا عندما يُقرِّر أحد المستخدِمين النقر على صفحة الويب خلال أوّل 5 ثوانٍ بعد تحميل الصفحة.

2. تأكَّد من إعداد تطبيقك لقياس هذا المقياس. يتطلّب مقياس مهلة الاستجابة لأوّل إدخال إعدادًا يدويًا. وعلى وجه التحديد، عليك إضافة مكتبة polyfill لهذا المقياس. للحصول على تعليمات التركيب، يُرجى الرجوع إلى مستندات المكتبة.

   يُرجى العِلم أنّ إضافة مكتبة polyfill هذه ليست مطلوبة لكي تتمكّن Performance Monitoring من إعداد تقارير عن مقاييس تطبيقات الويب الأخرى.

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

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

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

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

   يُرجى العلم أنّه إذا كنت تستخدم الطريقة record() ، لن تحتاج إلى بدء عملية التتبُّع أو إيقافها بشكل صريح.

2. تأكَّد من أنّه لم يتم إيقاف جمع بيانات Performance Monitoring من خلال العلامة التالية:

   • performance.dataCollectionEnabled

     تتحكّم هذه العلامة في جمع البيانات لتتبُّع الرموز البرمجية المخصّصة فقط (وليس كل البيانات).

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

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

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

إذا لم تتوفّر لديك بيانات طلبات الشبكة، يُرجى مراعاة ما يلي:

• يجمع Performance Monitoring تلقائيًا مقاييس طلبات الشبكة التي يتم الإبلاغ عنها من قِبل واجهة برمجة تطبيقات المتصفّح. ولا تتضمّن هذه التقارير طلبات الشبكة التي تعذّر إكمالها.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

كيف يمكنني إضافة حزمة تطوير البرامج (SDK) الأصغر حجمًا وذات مساحة الاسماء Performance Monitoring JS (حزمة SDK "المستقلة") إلى تطبيق الويب الخاص بي؟

إذا كان Performance Monitoring هو منتج Firebase الوحيد في تطبيقك، يمكنك استخدام حزمة تطوير البرامج (SDK) المستقلة لـ Performance Monitoring (ورمز النص البرمجي المقترَح للعنوان أدناه) إذا كنت مهتمًا بما يلي:

• باستخدام مكتبة مستندة إلى مساحة اسم
• تقليل حجم حزمة حزمة تطوير البرامج (SDK)
• تأخير بدء حزمة تطوير البرامج (SDK) إلى ما بعد تحميل صفحتك

لتضمين حزمة تطوير البرامج (SDK) المستقلة Performance Monitoring في تطبيقك وتأخير بدء معالجة ملفها إلى ما بعد تحميل صفحتك:

1. أضِف النص البرمجي التالي إلى عنوان ملف الفهرس.
2. احرص على إضافة عنصر إعدادات مشروع Firebase لتطبيقك.

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

حيث

• performance_standalone هو 'https://www.gstatic.com/firebasejs/11.0.2/firebase-performance.js'
• firebaseConfig هو عنصر إعدادات Firebase في تطبيقك.

يحمِّل النص البرمجي أعلاه حزمة تطوير البرامج (SDK) المستقلة بشكل غير متزامن، ثمّ يُنشئ بعد تنشيط حدث onload للنافذة. تقلِّل هذه الطريقة من أثر حزمة SDK في مقاييس تحميل الصفحة لأنّ المتصفّح قد أبلغ من قبل عن مقاييس التحميل عند بدء حزمة SDK.

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

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

تعالج 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 متوافقًا مع الوقت الفعلي. في المقابل، تتضمّن البيانات غير الحديثة بيانات الأداء من جميع إصدارات تطبيقك.