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

iOS+ Android الويب

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

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

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

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

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

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

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

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

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

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

   1. عرض تطبيق الويب وتشغيله في بيئة محلية

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

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

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

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

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

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

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

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

1. تأكَّد من Performance Monitoringإعداد حزمة تطوير البرامج (SDK) بشكلٍ صحيح في تطبيقك.

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

   • performance.instrumentationEnabled

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

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

   إذا أضفت Performance Monitoring SDK في تطبيقك مؤخرًا، قد تحتاج إلى إعادة تشغيل تطبيقك بالكامل لكي تبدأ حزمة SDK في العمل.

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

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

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

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

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

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

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

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

1. تأكَّد من Performance Monitoringإعداد حزمة تطوير البرامج (SDK) بشكلٍ صحيح في تطبيقك.

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

   • performance.instrumentationEnabled

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

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

   إذا أضفت Performance Monitoring SDK في تطبيقك مؤخرًا، قد تحتاج إلى إعادة تشغيل تطبيقك بالكامل لكي تبدأ حزمة SDK في العمل.

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

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

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

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 المخصّصة.

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

iOS+ Android الويب

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لتضمين حزمة Performance Monitoring SDK المستقلة في تطبيقك وتأخير عملية تهيئتها إلى ما بعد تحميل صفحتك، اتّبِع الخطوات التالية:

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.9.1/firebase-performance.js'
• firebaseConfig هو عنصر إعدادات Firebase لتطبيقك

يحمّل النص البرمجي أعلاه حزمة SDK المستقلة بشكل غير متزامن، ثم يبدأ Firebase بعد تنشيط حدث onload في النافذة. تؤدي هذه الطريقة إلى تقليل التأثير الذي يمكن أن تحدثه حزمة SDK في مقاييس تحميل الصفحة، لأنّ المتصفّح قد أبلغ عن مقاييس التحميل عند تهيئة حزمة SDK.

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

مزيد من المعلومات حول حزمة تطوير البرامج (SDK) المستقلة Performance Monitoring ونص البرمجة الخاص بالعنوان

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

يستخدم Firebase Performance Monitoring واجهتَي برمجة التطبيقات fetch وPromise، وهما غير متاحتَين على المتصفحات القديمة. يتم تضمين رموز التعبئة لواجهات برمجة التطبيقات هذه في حزمة Firebase Performance Monitoring JS SDK العادية، ولكن يتم حذفها من حزمة SDK المستقلة لتقليل الحجم.

تعتمد حزمة تطوير البرامج (SDK) Performance Monitoring جزئيًا على Resource Timing API للحصول على مقاييس تحميل الصفحات من المتصفّح.

يوضّح المقتطف التالي النص البرمجي للعنوان الذي يتضمّن عملية تهيئة حزمة 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);

حيث

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

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

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

تعالج 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 في بطاقة تطبيقاتك ضمن إعدادات المشروع.