مراقبة الأداء استكشاف الأخطاء وإصلاحها والأسئلة الشائعة

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

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

2. قم بتحديث تطبيق الويب الخاص بك في المتصفح.

3. تحقق من رسائل السجل الخاصة بك بحثًا عن أي رسائل خطأ.

4. بعد بضع ثوانٍ ، ابحث عن مكالمة شبكة إلى firebaselogging.googleapis.com في أدوات مطور المتصفح. يُظهر وجود مكالمة الشبكة هذه أن المتصفح يرسل بيانات الأداء إلى Firebase.

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

تمت إضافة SDK إلى التطبيق ، ولكن لا تزال وحدة التحكم تقول إضافة SDK

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

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

تقول وحدة التحكم أنه تم اكتشاف SDK ، ولكن لا يتم عرض أي بيانات

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

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

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

إذا كنت لا ترى رسائل سجل لأحداث الأداء ، فجرّب الخطوات التالية لتحري الخلل وإصلاحه:

1. تأكد من تهيئة SDK لمراقبة الأداء بشكل صحيح في تطبيقك.

2. تأكد من عدم تعطيل SDK لمراقبة الأداء من خلال العلامة التالية:

   • performance.instrumentationEnabled

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

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

   إذا أضفت للتو SDK لمراقبة الأداء في تطبيقك ، فقد تحتاج إلى إعادة تشغيل التطبيق بالكامل حتى تبدأ SDK في العمل.

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

تفتقد لوحة معلومات الأداء بيانات تأخير الإدخال الأول

إذا كنت لا ترى بيانات لمقياس تأخير الإدخال الأول ، فجرّب خطوات تحرّي الخلل وإصلاحه التالية:

1. اعلم أن مراقبة الأداء تسجل فقط مقياس تأخير الإدخال الأول عندما ينقر المستخدم على صفحة الويب خلال أول 5 ثوانٍ بعد تحميل الصفحة.

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

   لاحظ أن إضافة مكتبة polyfill هذه ليست مطلوبة لمراقبة الأداء للإبلاغ عن مقاييس تطبيقات الويب الأخرى.

تفتقد لوحة معلومات الأداء إلى بيانات التتبع المخصصة

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

1. تحقق من إعداد آثار التعليمات البرمجية المخصصة التي تم تجهيزها عبر واجهة برمجة تطبيقات التتبع ، وخاصة ما يلي:

   • يجب أن تفي أسماء عمليات تتبع التعليمات البرمجية المخصصة والمقاييس المخصصة بالمتطلبات التالية: عدم وجود مسافة بيضاء سابقة أو لاحقة ، وعدم وجود حرف شرطة سفلية بادئة ( _ ) ، والحد الأقصى للطول هو 32 حرفًا.
   • يجب بدء جميع الآثار وإيقافها. لن يتم تسجيل أي تتبع لم يتم بدء تشغيله أو إيقافه أو إيقافه قبل البدء.

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

2. تأكد من عدم تعطيل جمع بيانات مراقبة الأداء من خلال العلامة التالية:

   • performance.dataCollectionEnabled

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

3. تحقق من رسائل السجل الخاصة بك للتأكد من أن "مراقبة الأداء" تقوم بتسجيل آثار التعليمات البرمجية المخصصة المتوقعة.

4. إذا كانت مراقبة الأداء تقوم بتسجيل الأحداث ، ولكن لا يتم عرض أي بيانات بعد 24 ساعة ، فاتصل بدعم Firebase .

تفتقد لوحة معلومات الأداء إلى بيانات طلب الشبكة

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

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

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

لا يتم تجميع بيانات طلب الشبكة بالشكل المتوقع

تعرف على المزيد حول كيفية قيام "مراقبة الأداء" بتجميع بيانات طلب الشبكة ضمن أنماط عنوان URL.

يمكنك أيضًا تجربة أنماط URL المخصصة !

ماذا حدث لأهم المشكلات في بطاقة الأداء في صفحة Project الرئيسية؟

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

يقوم محدد التطبيقات الموجود أعلى بطاقة الأداء بتصفية إدخالات التنبيه ضمن التنبيهات الأخيرة . يتم عرض أحدث ثلاثة تنبيهات فقط للتطبيق (التطبيقات) المحددة.

لمعرفة المزيد حول التنبيهات ، راجع إعداد التنبيهات لمشاكل الأداء .

ماذا حدث للقدرة على تعيين عتبات للمشكلات في وحدة التحكم؟

تدعم مراقبة الأداء تنبيهات المقاييس التي تتجاوز الحدود المحددة. لتجنب الالتباس مع هذه الحدود القابلة للتكوين لمقاييس الأداء ، أزلنا القدرة على تكوين عتبات المشكلات .

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

لقد استبدلنا صفحات التفاصيل والمقاييس بواجهة مستخدم مركزية (UI) أعيد تصميمها حديثًا لتحسين كيفية استكشاف المشكلات وإصلاحها. توفر واجهة المستخدم الجديدة لاستكشاف الأخطاء وإصلاحها نفس الوظيفة الأساسية التي قدمتها التفاصيل والمقاييس. لمعرفة المزيد حول استكشاف الأخطاء وإصلاحها ، راجع عرض المزيد من البيانات لتتبع محدد .

لماذا عدد العينات ليس كما أتوقع؟

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

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

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

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

  ترسل جلسات المستخدم بيانات إضافية ومفصلة من جهاز المستخدم ، مما يتطلب المزيد من الموارد لالتقاط البيانات وإرسالها. لتقليل تأثير جلسات المستخدم ، قد تقيد مراقبة الأداء أيضًا عدد الجلسات.

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

  • يمكن أن يختلف عدد الآثار عن عدد المرات التي تم فيها تنفيذ جزء من التعليمات البرمجية.
  • قد تحتوي الآثار التي تقترن بشكل وثيق في التعليمات البرمجية على عدد مختلف من العينات.

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

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

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

لقد أعدنا تصميم قسم مراقبة الأداء في وحدة تحكم Firebase بحيث تعرض علامة التبويب Dashboard مقاييسك الرئيسية وجميع آثارك في مساحة واحدة. كجزء من إعادة التصميم ، أزلنا صفحات الجهاز والشبكة .

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

اعرض آثارك في علامات التبويب الفرعية التالية لجدول التتبع:

• تتبع طلبات الشبكة (سواء الجاهزة أو المخصصة) - علامة التبويب الفرعية لطلبات الشبكة
• تتبعات التعليمات البرمجية المخصصة - علامة التبويب الفرعية للتتبعات المخصصة
• بدء التطبيق ، التطبيق في المقدمة ، تتبعات التطبيق في الخلفية - علامة التبويب الفرعية للتتبعات المخصصة
• تتبعات عرض الشاشة - علامة التبويب الفرعية لعرض الشاشة
• تتبعات تحميل الصفحة - علامة التبويب الفرعية تحميل الصفحة

للحصول على تفاصيل حول جدول التتبع وعرض المقاييس والبيانات ، تفضل بزيارة صفحة نظرة عامة على وحدة التحكم ( iOS + | Android | Web ).

لماذا عدد الإطارات البطيئة والمجمدة ليس كما توقعت؟

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

كيف يمكنني إضافة JS SDK (SDK "المستقل") إلى تطبيق الويب الخاص بي؟

If Performance Monitoring is the only Firebase product in your app, you can use the standalone Performance Monitoring SDK (and the recommended header script below) if you're interested in:

• using a namespaced library
• reducing your SDK package size
• delaying initialization of the SDK until after your page loads

To include the standalone Performance Monitoring SDK in your app and delay its initialization to after your page loads:

1. Add the following script to the header of your index file.
2. Make sure to add your app's Firebase project configuration object .

(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);

where,

• performance_standalone is 'https://www.gstatic.com/firebasejs/9.22.1/firebase-performance-standalone.js'
• firebaseConfig is your app's Firebase config object

The above script asynchronously loads the standalone SDK then initializes Firebase after the window's onload event fires. This tactic reduces the impact that the SDK could have on page load metrics since the browser has already reported its loading metrics when you initialize the 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);

What does "near real-time" performance data mean?

Firebase Performance Monitoring processes collected performance data as it comes in, which results in near real-time data display in the Firebase console. Processed data displays in the console within a few minutes of its collection, hence the term "near real-time".

To take advantage of near real-time data processing, make sure your app uses a real-time compatible SDK version .

How do I get near real-time performance data for my app?

To take advantage of near real-time data processing, you only need to make sure that your app uses a Performance Monitoring SDK version that's compatible with real-time data processing.

These are the real-time compatible SDK versions:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

Which versions of the Performance Monitoring SDK are considered real-time compatible?

These are the SDK versions compatible with real-time data processing:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

What if I don't update my app to use a real-time compatible SDK version?

If your app doesn't use a real-time compatible SDK version, you will still see all your app's performance data in the Firebase console. However, the display of performance data will be delayed by roughly 36 hours from the time of its collection.

I've updated to a real-time compatible SDK version, but some of my users are still on old versions of my app. Do I continue to see their performance data in the Firebase console?

Yes! Regardless of which SDK version an app instance uses, you'll see performance data from all your users.

However, if you're looking at recent data (less than roughly 36 hours old), then the displayed data is from users of app instances using a real-time compatible SDK version. The non-recent data, though, includes performance data from all versions of your app.