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

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

1. تفعيل تسجيل التصحيح ، كما يلي:

   1. في Xcode (الإصدار 13.3.1 كحد أدنى) ، حدد المنتج > المخطط > تحرير النظام .
   2. حدد تشغيل من القائمة اليسرى ، ثم حدد علامة التبويب وسائط .
   3. في قسم Arguments Passed on Launch ، أضف -FIRDebugEnabled .

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

3. تعمل مراقبة الأداء على تمييز رسائل السجل الخاصة بها باستخدام Firebase/Performance بحيث يمكنك تصفية رسائل السجل الخاصة بك.

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

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

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

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

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

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

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

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

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

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

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

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

1. تأكد من عدم تعطيل SDK لمراقبة الأداء من خلال أي من العلامات التالية في ملف Info.plist الخاص بك:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. تأكد من عدم تعطيل مراقبة الأداء في وقت التشغيل ( Swift | Obj-C ).

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

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

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

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

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

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

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

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

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

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

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

1. تحقق من عدم توافق مكتبة الشبكة. تجمع مراقبة الأداء تلقائيًا مقاييس لطلبات الشبكة التي تستخدم مكتبات الشبكات التالية:

   • بالنسبة إلى Swift: جلسة URL و URLConnection
   • للهدف- C: جلسة NSURL و NSURL

   لاحظ أنه يمكنك إضافة مراقبة مخصصة لطلبات الشبكة .

2. كن على علم بما يلي:

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

   • لا تقوم مراقبة الأداء بالإبلاغ عن طلبات الشبكة ذات رؤوس Content-Type غير الصالحة. ومع ذلك ، سيستمر قبول طلبات الشبكة بدون رؤوس Content-Type .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تستغرق بيانات مراقبة الأداء وقتًا أطول من المتوقع ليتم تصديرها إلى BigQuery. أليس الوقت الحقيقي؟

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

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

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

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

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

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

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

هذه هي إصدارات SDK المتوافقة مع الوقت الفعلي:

• iOS - v7.3.0 أو أحدث
• tvOS - v8.9.0 أو أحدث
• Android - الإصدار 19.0.10 أو الأحدث (أو Firebase Android BoM v26.1.0 أو الأحدث)
• الويب - v7.14.0 أو أحدث

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

ما هي إصدارات SDK لمراقبة الأداء التي تعتبر متوافقة في الوقت الفعلي؟

هذه هي إصدارات SDK المتوافقة مع معالجة البيانات في الوقت الفعلي:

• iOS - v7.3.0 أو أحدث
• tvOS - v8.9.0 أو أحدث
• Android - الإصدار 19.0.10 أو الأحدث (أو Firebase Android BoM v26.1.0 أو الأحدث)
• الويب - v7.14.0 أو أحدث

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

ماذا لو لم أقوم بتحديث تطبيقي لاستخدام إصدار SDK متوافق في الوقت الفعلي؟

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

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.