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

+iOS نظام التشغيل Android الويب

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

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

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

1- التحقّق من رسائل السجلّ لأحداث الأداء

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

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

1. افتح أدوات المطوّرين في متصفحك (على سبيل المثال، علامة التبويب "الشبكة" في "أدوات مطوري البرامج في Chrome" أو في Network Monitor for 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 دقائق من بدء تشغيل التطبيق لوحة البيانات عرض رسالة "تم اكتشاف حزمة تطوير برامج (SDK)" في وحدة تحكم Firebase . بعد ذلك، في غضون 30 دقيقة، تعرض لوحة البيانات البيانات الأولية التي تمت معالجتها.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   • performance.instrumentationEnabled

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

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

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

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

تشير وحدة التحكّم إلى أنّ حزمة تطوير البرامج (SDK) ولكن لا يتم عرض أي بيانات

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

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

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

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

تعذُّر تسجيل التطبيق أحداث الأداء

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

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

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

   • performance.instrumentationEnabled

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

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

   إذا أضفت حزمة تطوير البرامج (SDK) لتطبيق Performance Monitoring إلى تطبيقك للتو، قد تحتاج إلى إعادة تشغيل تطبيقك بالكامل حتى تبدأ حزمة 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؟

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

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

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

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

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

• أخذ العينات الديناميكي: يجمع Performance Monitoring حدًا أقصى يبلغ 100 مليون تقريبًا. أحداث لعمليات تتبُّع الرمز و100 مليون لتتبُّع طلبات الشبكة لكل تطبيق يوميًا بين جميع مستخدمي التطبيق. يتم جلب معدل أخذ العينات الديناميكي على الأجهزة (باستخدام 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 (حزمة SDK "المستقلة") إلى تطبيق الويب الخاص بي؟

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

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

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

لتضمين حزمة تطوير البرامج (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/10.13.1/firebase-performance.js'
• firebaseConfig هو كائن إعداد Firebase في تطبيقك

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

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

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

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

يتم استخدام واجهتَي برمجة تطبيقات fetch وPromise في "Firebase Performance Monitoring". والتي لا تتوفّر على المتصفّحات القديمة. تُستخدم رموز polyfill هذه لواجهات برمجة التطبيقات هذه تم تضمينها في حزمة تطوير البرامج (SDK) العادية المستندة إلى JavaScript Firebase Performance Monitoring، ولكن يتم حذفها من حزمة SDK المستقلة لتقليل الحجم.

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

يقسم المقتطف التالي النص البرمجي للعنوان الذي يتضمن التأخيرات تهيئة حزمة 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/10.13.1/firebase-performance-standalone.js'
• firebaseConfig هو عنصر إعدادات Firebase في تطبيقك.

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

ماذا يحدث "في الوقت الفعلي تقريبًا" بيانات الأداء؟

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

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

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

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

في ما يلي إصدارات حزمة 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 متوافق في الوقت الفعلي؟

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

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

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

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

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

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