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

iOS+ Android الويب

تقدّم هذه الصفحة نصائح حول تحديد المشاكل وحلّها لبدء استخدام Performance Monitoring أو ميزات وأدوات Performance Monitoring.

عمليات التحقّق الأولى لتحديد المشاكل وحلّها

يُعدّ التحقّق من النقطتين التاليتين من أفضل الممارسات العامة التي يُنصح بها لأي مستخدم قبل مواصلة تحديد المشاكل وحلّها.

1. التحقّق من رسائل السجلّ بحثًا عن أحداث الأداء

راجِع رسائل السجلّ للتأكّد من أنّ حزمة تطوير البرامج (SDK) Performance Monitoring تسجّل أحداث الأداء.

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

1. فعِّل تسجيل تصحيح الأخطاء في Performance Monitoring في وقت الإنشاء من خلال إضافة عنصر <meta-data> إلى ملف AndroidManifest.xml في تطبيقك، كما يلي:

   <application>
       <meta-data
         android:name="firebase_performance_logcat_enabled"
         android:value="true" />
   </application>

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

3. تضع Performance Monitoring علامات على رسائل السجلّ باستخدام FirebasePerformance. باستخدام فلترة logcat، يمكنك الاطّلاع على تتبُّع المدة وتسجيل طلبات شبكة HTTP/S على وجه التحديد من خلال تنفيذ الأمر التالي:

   adb logcat -s FirebasePerformance

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

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

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

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

2- الاطّلاع على لوحة بيانات الحالة في Firebase

يُرجى الانتقال إلى لوحة البيانات الخاصة بالحالة في Firebase في حال حدوث انقطاع معروف في الخدمة في Firebase أو Performance Monitoring.

بدء استخدام Performance Monitoring

إذا كنت بصدد البدء في استخدام Performance Monitoring (iOS+ | Android | الويب)، يمكن أن تساعدك نصائح تحديد المشاكل وحلّها التالية في معالجة المشاكل التي تتضمّن رصد Firebase لحزمة SDK أو عرض أول بيانات أداء في وحدة تحكّم Firebase.

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

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

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

يسجّل التطبيق الأحداث: خطوات تحديد المشاكل وحلّها

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

1. تأكَّد من استخدام الإصدار 19.1.0 أو إصدار أحدث من Performance Monitoring حزمة تطوير البرامج (SDK) لنظام التشغيل Android (أو الإصدار 26.3.0 أو إصدار أحدث من Firebase BoM)، راجِع ملاحظات الإصدار.

2. إذا كنت لا تزال في مرحلة التطوير على الجهاز المحلي، جرِّب إنشاء المزيد من الأحداث لجمع البيانات:

   1. يمكنك إنشاء أحداث من خلال التبديل بين تشغيل تطبيقك في الخلفية وفي المقدّمة عدة مرات، والتفاعل مع تطبيقك من خلال التنقّل بين الشاشات، و/أو تشغيل طلبات الشبكة.

3. تأكَّد من أنّه تمّت إضافة ملف إعداد Firebase (google-services.json) بشكل صحيح إلى تطبيقك وأنّك لم تعدّل الملف. على وجه التحديد، تحقَّق مما يلي:

   • لا تتم إضافة أحرف إضافية إلى اسم ملف الإعداد، مثل (2).

   • يوجد ملف الإعداد في دليل الوحدة (على مستوى التطبيق) الخاص بتطبيقك.

   • أنّ معرّف تطبيق Android على Firebase (mobilesdk_app_id) المُدرَج في ملف الإعداد صحيح لتطبيقك. يمكنك العثور على معرّف تطبيقك على Firebase في بطاقة تطبيقاتك ضمن إعدادات مشروعك.

   إذا بدا أنّ هناك خطأ في ملف الإعداد في تطبيقك، جرِّب ما يلي:

   1. احذف ملف الإعداد المتوفّر حاليًا في تطبيقك.

   2. اتّبِع هذه التعليمات لتنزيل ملف إعداد جديد وإضافته إلى تطبيق Android.

4. إذا كانت حزمة تطوير البرامج (SDK) تسجّل الأحداث ويبدو أنّ كل شيء تم إعداده بشكل صحيح، ولكنّك لا تزال لا ترى رسالة رصد حزمة تطوير البرامج (SDK) أو البيانات المعالَجة (بعد 10 دقائق)، يُرجى التواصل مع فريق دعم Firebase.

التطبيق لا يسجّل الأحداث: خطوات تحديد المشاكل وحلّها

1. تحقَّق من إعداد Performance Monitoring Gradle plugin على النحو التالي:

   1. تأكَّد من إضافة المكوّن الإضافي بشكل صحيح. على وجه التحديد، تحقَّق مما يلي:

      • لقد أضفت المكوّن الإضافي (apply plugin: 'com.google.firebase.firebase-perf') في ملف الوحدة (على مستوى التطبيق) build.gradle.
      • لقد أدرجت تبعية مسار الفئة الخاصة بالمكوّن الإضافي (classpath 'com.google.firebase:perf-plugin:1.4.2') في ملف على مستوى المشروع build.gradle.

   2. تأكَّد من أنّ المكوّن الإضافي غير مفعّل من خلال أيّ من العلامتَين التاليتَين:

      • instrumentationEnabled في ملف الوحدة (على مستوى التطبيق) build.gradle
      • firebasePerformanceInstrumentationEnabled في ملف gradle.properties

2. تأكَّد من Performance Monitoring SDK غير مفعَّل باستخدام أي من العلامتَين التاليتَين في ملف AndroidManifest.xml:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. تأكَّد من أنّ Performance Monitoring غير مفعَّل في وقت التشغيل.

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

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

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

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

الإجراءات العامّة لتحديد المشاكل وحلّها

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

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

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

1. تحقَّق من إعداد Performance Monitoring Gradle plugin على النحو التالي:

   1. تأكَّد من إضافة المكوّن الإضافي بشكل صحيح. على وجه التحديد، تحقَّق مما يلي:

      • لقد أضفت المكوّن الإضافي (apply plugin: 'com.google.firebase.firebase-perf') في ملف الوحدة (على مستوى التطبيق) build.gradle.
      • لقد أدرجت تبعية مسار الفئة الخاصة بالمكوّن الإضافي (classpath 'com.google.firebase:perf-plugin:1.4.2') في ملف على مستوى المشروع build.gradle.

   2. تأكَّد من أنّ المكوّن الإضافي غير مفعّل من خلال أيّ من العلامتَين التاليتَين:

      • instrumentationEnabled في ملف الوحدة (على مستوى التطبيق) build.gradle
      • firebasePerformanceInstrumentationEnabled في ملف gradle.properties

2. تأكَّد من Performance Monitoring SDK غير مفعَّل باستخدام أي من العلامتَين التاليتَين في ملف AndroidManifest.xml:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

3. تأكَّد من أنّ Performance Monitoring غير مفعَّل في وقت التشغيل.

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

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

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

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

2. تأكَّد من أنّك لم توقف تسريع الأجهزة يدويًا لأي شاشة.

3. تأكَّد من عدم استخدام DexGuard أو Jack. Performance Monitoring غير متوافق مع سلاسل الأدوات هذه.

   • توقف DexGuard عملية الجمع التلقائي لعمليات تتبُّع بدء تشغيل التطبيق، والتطبيق في المقدّمة، والتطبيق في الخلفية. ومع ذلك، يجب أن تتصرف أي عمليات تتبُّع الرموز المخصّصة بشكل طبيعي إذا كان تطبيقك يستخدم DexGuard.

   • تم إيقاف Jack نهائيًا، ولا يُنصح باستخدامه في تطبيقك.

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

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

1. إذا كنت قد أضفت أدوات إلى عمليات تتبُّع الرموز المخصّصة من خلال Trace API، تحقَّق من إعداد عمليات التتبُّع، خاصةً ما يلي:

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

2. إذا كنت قد أضفت أدوات تتبُّع لرموز مخصّصة باستخدام @AddTrace الصيغة، تحقَّق من إعداد المكوّن الإضافي Performance Monitoring Gradle باتّباع الخطوات التالية:

   1. تأكَّد من إضافة المكوّن الإضافي بشكل صحيح. على وجه التحديد، تحقَّق مما يلي:

      • لقد أضفت المكوّن الإضافي (apply plugin: 'com.google.firebase.firebase-perf') في ملف الوحدة (على مستوى التطبيق) build.gradle.
      • لقد أدرجت تبعية مسار الفئة الخاصة بالمكوّن الإضافي (classpath 'com.google.firebase:perf-plugin:1.4.2') في ملف على مستوى المشروع build.gradle.

   2. تأكَّد من أنّ المكوّن الإضافي غير مفعّل من خلال أيّ من العلامتَين التاليتَين:

      • instrumentationEnabled في ملف الوحدة (على مستوى التطبيق) build.gradle
      • firebasePerformanceInstrumentationEnabled في ملف gradle.properties

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

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

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

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

1. بالنسبة إلى تطبيقات Android، يتيح المكوّن الإضافي Performance Monitoring Gradle تتبُّع الأداء الذي يوفّر مراقبة تلقائية لطلبات شبكة HTTP/S. تحقَّق مما يلي:

   1. تأكَّد من إضافة المكوّن الإضافي بشكل صحيح. على وجه التحديد، تحقَّق مما يلي:

      • لقد أضفت المكوّن الإضافي (apply plugin: 'com.google.firebase.firebase-perf') في ملف الوحدة (على مستوى التطبيق) build.gradle.
      • لقد أدرجت تبعية مسار الفئة الخاصة بالمكوّن الإضافي (classpath 'com.google.firebase:perf-plugin:1.4.2') في ملف على مستوى المشروع build.gradle.

   2. تأكَّد من أنّ المكوّن الإضافي غير مفعّل من خلال أيّ من العلامتَين التاليتَين:

      • instrumentationEnabled في ملف الوحدة (على مستوى التطبيق) build.gradle
      • firebasePerformanceInstrumentationEnabled في ملف gradle.properties

2. تحقَّق من عدم توافق مكتبة الشبكة. تجمع Performance Monitoring تلقائيًا مقاييس لطلبات الشبكة التي تستخدم مكتبات الشبكة التالية: OkHttp 3.x.x وURLConnection من Java وApache HttpClient.

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

3. يُرجى الانتباه إلى ما يلي:

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

   • لا يتوافق Performance Monitoring مع DexGuard وJack.

     • توقف DexGuard مراقبة طلبات شبكة HTTP/S.
     • تم إيقاف Jack نهائيًا، ولا يُنصح باستخدامه في تطبيقك.

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

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

مزيد من المعلومات عن كيفية تجميع Performance Monitoring لبيانات طلبات الشبكة ضمن أنماط عناوين URL

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

الأسئلة الشائعة

iOS+ Android الويب

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

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

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

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

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

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

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

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

لماذا لا يتطابق عدد العيّنات مع ما أتوقّعه؟

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

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

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

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

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

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

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

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

ملاحظة: قد تتغيّر حدود أخذ العيّنات المحدّدة وطريقة تطبيقها مع تطوّر Performance Monitoring.

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

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

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

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

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

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

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

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

لماذا لا يتطابق عدد اللقطات البطيئة والمجمّدة مع ما أتوقّعه؟

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

لماذا لا يمكنني الاطّلاع على عمليات تتبُّع الأجزاء؟

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

كيف يمكنني معرفة عمليات التتبُّع المرتبطة بالقصاصات والأنشطة؟

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

لماذا يظهر عدد أقل من عمليات تتبُّع الأجزاء مقارنةً بعمليات التتبُّع الأخرى؟

تُجري Performance Monitoring عملية أخذ عيّنات من الأحداث على مستوى جميع الأحداث التي يتم جمعها على أحد الأجهزة. يتيح لنا هذا النهج جمع الحد الأدنى من الأحداث اللازمة من أجهزة المستخدمين لتوفير مقاييس الأداء.

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

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

أصبحت أوقات الإنشاء طويلة بعد تفعيل المكوّن الإضافي Performance Monitoring Gradle. كيف يمكنني تحسين ذلك؟

تستخدم Performance Monitoring لنظام التشغيل Android عملية تعديل الرمز الثانوي لتوفير بعض الميزات الجاهزة للاستخدام، مثل مراقبة طلبات شبكة HTTP/S. وكجزء من عملية التجميع، تتطلّب العملية تكرار جميع فئات تطبيقك (بما في ذلك التبعيات) لتسجيل الرمز البرمجي الذي يمثّل أهمية بالغة في قياس أداء طلب الشبكة لتطبيقك.

في ما يلي بعض العوامل الرئيسية التي تساهم في زيادة وقت الإنشاء:

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

لتحسين وقت الإنشاء، ننصحك بتقسيم الرمز إلى وحدات.

بدءًا من الإصدار 1.3.3 من المكوّن الإضافي Performance Monitoring، ركّزنا على إجراء تحسينات كبيرة في معالجة الإنشاء التزايدي وتخزين بيانات الإدخال الخاصة بالمكتبة مؤقتًا. للحصول على أحدث التحسينات في وقت الإنشاء، تأكَّد من استخدام أحدث إصدار من المكوّن الإضافي (الإصدار 1.4.2).

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

ماذا أفعل إذا ظهرت لي أخطاء في الإنشاء بسبب مكتبات غير متوافقة مع المكوّن الإضافي Performance Monitoring في Gradle؟

تستخدم Performance Monitoring لنظام التشغيل Android عملية تعديل الرمز الثانوي لتوفير بعض الميزات الجاهزة للاستخدام، مثل مراقبة طلبات شبكة HTTP/S. وكجزء من عملية التجميع، تتطلّب العملية تكرار جميع فئات تطبيقك (بما في ذلك التبعيات) لتسجيل الرمز البرمجي الذي يمثّل أهمية بالغة في قياس أداء طلب الشبكة لتطبيقك.

إذا ظهرت لك أخطاء في الإصدار، مثل JSR/RET are not supported with computeFrames option أو أخطاء مشابهة بعد الدمج مع المكوّن الإضافي Performance Monitoring، قد يكون السبب هو أنّ لديك أيضًا تبعية لمكتبة غير متوافقة مع المكوّن الإضافي Performance Monitoring لنظام Gradle.

لتجنُّب ذلك، يمكنك استبعاد الفئات/المكتبات غير المتوافقة من عملية تتبُّع الأداء باتّباع الخطوات التالية:

1. تحديث المكوّن الإضافي Performance Monitoring Gradle (الإصدار 1.4.0 كحد أدنى) إلى أحدث إصدار
2. حدِّث إصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android إلى الإصدار 7.2.0 أو إصدار أحدث.
3. أضِف العلامة التالية إلى ملف build.gradle الخاص بالوحدة (على مستوى التطبيق) لاستبعاد الفئات/المكتبات غير المتوافقة من عملية القياس:

   android {
     // ...
     androidComponents {
       onVariants(selector().all(), {
           instrumentation.excludes.add("example.incompatible.library")
       })
     }
   }

   لمزيد من المعلومات عن السمة exclude في واجهة برمجة التطبيقات Instrumentation الخاصة بالمكوّن الإضافي لنظام Gradle المتوافق مع Android، يُرجى الاطّلاع على أدوات القياس.

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

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

إذا فعّلت عملية الربط مع BigQuery في Firebase Performance Monitoring، سيتم تصدير بياناتك إلى BigQuery بعد 12 إلى 24 ساعة من نهاية اليوم (بتوقيت المحيط الهادئ).

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

معالجة البيانات وعرضها في الوقت الفعلي التقريبي

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

التواصل مع فريق دعم Firebase

إذا تواصلت مع فريق دعم Firebase، احرص دائمًا على تضمين رقم تعريف تطبيقك على Firebase. يمكنك العثور على معرّف تطبيقك على Firebase في بطاقة تطبيقاتك ضمن إعدادات المشروع.