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

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

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

   1. في كسكودي (الحد الأدنى v12.5)، وحدد المنتج> برنامج <تعديل المخطط.
   2. حدد تشغيل من القائمة اليسرى، ثم حدد علامة التبويب الحجج.
   3. في الحجج مرت في قسم التشغيل، إضافة -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. تأكد من أن مراقبة الأداء لا تعطيل في وقت التشغيل ( سويفت | الكائنات C ).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لمزيد من التفاصيل حول الجدول آثار وعرض المقاييس والبيانات، قم بزيارة صفحة نظرة عامة وحدة التحكم ( دائرة الرقابة الداخلية + | أندرويد | الويب ).

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

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

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

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

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

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

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

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

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

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

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

• دائرة الرقابة الداخلية - v7.3.0 أو في وقت لاحق
• tvOS - v8.9.0 أو في وقت لاحق
• الروبوت - v19.0.10 أو في وقت لاحق (أو Firebase الروبوت BOM v26.1.0 أو في وقت لاحق)
• على شبكة الإنترنت - v7.14.0 أو في وقت لاحق

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

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

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

• دائرة الرقابة الداخلية - v7.3.0 أو في وقت لاحق
• tvOS - v8.9.0 أو في وقت لاحق
• الروبوت - v19.0.10 أو في وقت لاحق (أو Firebase الروبوت BOM v26.1.0 أو في وقت لاحق)
• على شبكة الإنترنت - v7.14.0 أو في وقت لاحق

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

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

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

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

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

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