إعداد تنبيهات لمشاكل الأداء

استخدِم تنبيهات "Performance Monitoring" لإشعار أعضاء المشروع في حال تغيير الرمز أو الاتصال بشبكة. الطلبات تؤدي إلى خفض أداء تطبيقك.

يمكنك إعداد وتخصيص تنبيهات لتطبيقك، والتي تُعلمك عند حدوث يتجاوز أداء حدث معيّن حدًّا معيّنًا.

ما الذي يؤدي إلى التنبيه؟

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

وقت بدء التطبيق

عند ضبط تنبيه لوقت بدء تشغيل التطبيق، يتم تشغيل التنبيه إذا كانت كل الشروط التالية صحيحة:

  • سجَّل Firebase ما لا يقل عن 100 عينة من _app_start. تتبُّع أحدث إصدار من تطبيقك في الساعة الماضية
  • تجاوزت مدة تتبُّع _app_start الحدّ الأقصى المحدّد للتطبيق. خلال الساعة الأخيرة وللنسبة المئوية التي تم ضبطها
  • لم يكن هناك تنبيه سبق أن تم رفعه إلى الحدّ الأدنى نفسه في الأحدث. من تطبيقك.

عمليات تتبُّع الرموز المخصّصة

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

  • سجّل Firebase 100 عيّنة على الأقل من تتبُّع الرمز المخصّص لأحدث إصدار من تطبيقك خلال الساعة الأخيرة.
  • تجاوزت مدة التتبُّع الحدّ الأقصى المحدّد للتطبيق خلال الساعة الأخيرة وللنسبة المئوية المحدّدة.
  • (لنظامَي التشغيل iOS والإصدارات الأحدث وAndroid فقط) لم يتم سابقًا إصدار تنبيه بشأن الحدّ الأقصى نفسه في أحدث إصدار من تطبيقك.
  • (للويب فقط) لم يكن هناك تنبيه سبق رفعه إلى الحد الأدنى نفسه في آخر 3 أيام

طلبات الشبكة

عند ضبط تنبيه لمقياس طلب الشبكة، يتم تشغيل التنبيه إذا كانت جميع الشروط التالية صحيحة:

  • سجّلت Firebase 100 عيّنة على الأقل تطابقت مع نمط عنوان URL في جميع إصدارات تطبيقك خلال الساعة الأخيرة.
  • تجاوزت القيمة المجمّعة للمقياس الحد الأدنى خلال آخر ساعة:
    • وقت الاستجابة: تجاوزت القيمة المجمّعة حد الاستخدام الشريحة المئوية التي تم ضبطها
    • نسبة النجاح: (لنظام التشغيل iOS +/Android فقط) ظهرت القيمة المجمّعة أدناه الحدّ الأدنى المضبوط على مستوى جميع المستخدمين
  • لم يكن هناك تنبيه سبق أن تم رفعه إلى الحدّ الأدنى نفسه في الماضي. 3 أيام:

عرض الشاشة

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

  • سجَّل Firebase 100 عينة على الأقل من عيّنات الشاشة. العرض لأحدث إصدار من تطبيقك في الساعة الماضية.
  • تجاوزت القيمة المجمّعة للمقياس الحدّ المسموح به خلال الساعة الأخيرة:
    • اللقطات المجمّدة: تجاوزت القيمة المجمّعة الحدّ الأقصى المسموح به
    • اللقطات البطيئة: تجاوزت القيمة المجمّعة الحدّ الأدنى المضبوط
  • لم يكن هناك تنبيه سبق أن تم رفعه إلى الحدّ الأدنى نفسه في الأحدث. من تطبيقك.

عمليات تحميل الصفحة

عند ضبط تنبيه لمقياس تحميل صفحة، يتم تشغيل التنبيه في حال استيفاء جميع الشروط التالية:

  • سجَّل Firebase ما لا يقل عن 100 عينة من الصفحة التي يتم تحميلها لمدة لتطبيقك خلال الساعة الماضية.
  • تجاوزت القيمة المجمّعة للمقياس الحد الأدنى خلال آخر ساعة والشريحة المئوية التي تم إعدادها:
    • مهلة الاستجابة لأوّل إدخال: تجاوزت القيمة المجمّعة الحدّ الأدنى المسموح به والنسبة المئوية التي تم ضبطها.
    • سرعة عرض المحتوى على الصفحة: تجاوزت القيمة المجمّعة القيمة المحدّدة الحدّ الأدنى والشريحة المئوية التي تم ضبطها
    • سرعة عرض الصفحة: تجاوزت القيمة المجمّعة الحدّ الأقصى المسموح به والشريحة المئوية التي تم ضبطها
  • لم يكن هناك تنبيه سبق أن تم رفعه إلى الحدّ الأدنى نفسه في الماضي. 3 أيام:

مزيد من المعلومات حول ضبط التنبيهات والشرائح المئوية التلقائية وأفضل الممارسات لإعداد تنبيهات لأنواع محددة للآثار والمقاييس.

تنبيهات لمقاييس الأداء الأخرى أو لعمليات دمج Firebase المضمّنة مع Slack، جيرا Pagerduty غير متوفرة لتنبيهات Performance Monitoring.

تلقّي تنبيهات

الحصول على تنبيهات تلقائية

وفقًا للإعدادات التلقائية، يمكن أن يرسل Firebase تنبيهَين (Performance Monitoring) عبر البريد الإلكتروني.

لتلقّي تنبيهات Performance Monitoring من خلال هذه الآلية التلقائية، يجب أن يكون لديك إذن firebaseperformance.config.update. تتضمن الأدوار التالية هذا الإذن المطلوب تلقائيًا:

التنبيهات وإعداداتها على مستوى المشروع. هذا يعني أنه بشكل افتراضي، سيتلقّى عضو المشروع (الذي لا يمثّل مجموعة بريد إلكتروني ولديه الأذونات المطلوبة لتلقّي التنبيهات) رسالة إلكترونية عند ظهور تنبيه بالأداء.

تفعيل/إيقاف التنبيهات لحسابك

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

لتفعيل تنبيهات Performance Monitoring أو إيقافها، اتّبِع الخطوات التالية:

  1. في وحدة تحكُّم "Firebase"، في أعلى يسار الصفحة، انتقِل إلى من Firebase التنبيهات.
  2. بعد ذلك، انتقِل إلى . الإعدادات وضبط الإعدادات المفضّلة لحسابك على Performance Monitoring التنبيهات.

إعداد التنبيه المتقدّم للخدمات التابعة لجهات خارجية

يمكنك أيضًا إرسال Performance Monitoring تنبيه إلى الإشعار المفضَّل لفريقك. قناة، باستخدام Cloud Functions for Firebase. على سبيل المثال، يمكنك كتابة تسجِّل حدث تنبيه لبطء وقت بدء التطبيق وتنشر لتنبيه المعلومات إلى خدمة تابعة لجهة خارجية، مثل Discord أو Slack أو Jira.

لإعداد إمكانات التنبيه المتقدّمة باستخدام "Cloud Functions for Firebase"، اتّبِع الخطوات التالية:

  1. إعداد دوال السحابة الإلكترونية لمنصة Firebase والذي يتضمن المهام التالية:

    1. إعداد بيئة تطوير لـ Node.js أو Python.
    2. ثبِّت واجهة سطر الأوامر "Firebase" وسجِّل الدخول إليها.
    3. يمكنك إعداد Cloud Functions for Firebase باستخدام واجهة سطر الأوامر Firebase.

  2. اكتب وانشر دالة لتسجيل حدث تنبيه من Performance Monitoring ومعالجة الحدث الحمولة (على سبيل المثال، نشر معلومات التنبيه في رسالة على Discord)

للتعرّف على جميع أحداث تنبيه الأداء التي يمكنك تسجيلها، انتقِل إلى وثائق مرجعية تنبيهات مراقبة الأداء:

إزالة التنبيهات غير الصالحة تلقائيًا

يتحقق Performance Monitoring من التنبيهات للتأكّد من أنّ البيانات صالحة وأنّ التنبيهات قيد استخدام فعال. وتُعدّ التنبيهات صالحة في حال استيفاء أيّ من المتطلّبات التالية:

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

في حال عدم استيفاء أحد هذَين الشرطَين، ستتم إزالة التنبيه من قِبل Performance Monitoring.

ضبط تنبيه

لضبط Performance Monitoring تنبيه، يجب أن يتوفّر لديك إذن firebaseperformance.config.update. تتضمّن الأدوار التالية هذا الإذن المطلوب تلقائيًا: مشرف أداء Firebase، مشرف جودة Firebase، مشرف Firebase، مالك المشروع أو محرّره.

أضِف أحدث حزمة تطوير برامج (SDK) لنظام التشغيل Performance Monitoring إلى تطبيقك إذا لم يسبق لك إجراء ذلك. لمزيد من المعلومات، اطّلِع على أدلة البدء لأنظمة التشغيل الويب و Android و Apple و Flutter.

في كل تطبيق من التطبيقات المسجَّلة، استخدِم جدول مسارات التتبُّع. أو بطاقة تقرير لوحة البيانات لضبطها تنبيه لكل مقياس تريد مراقبته. يمكن أن يحتوي كل تطبيق على مجموعة مختلفة من التنبيهات، لكل منها حد مختلف (أو ليست لها تنبيهات على الكل).

ضبط تنبيه في جدول "التتبُّعات"

  1. الانتقال إلى Performance Monitoring لوحة البيانات علامة تبويب في وحدة تحكُّم Firebase، ثم اختيار التطبيق المطلوب تهيئة تنبيه.

  2. انتقِل للأسفل إلى جدول "عمليات التتبّع" في أسفل الشاشة.

  3. اختَر علامة التبويب من نوع التتبُّع التي تريد إعداد تنبيه لها. ثم نجد الصف المناسب.

  4. في أقصى يسار الصف، افتح "القائمة الكاملة" () واختَر إعدادات التنبيه:

  5. اتّبِع التعليمات الظاهرة على الشاشة لضبط الحدّ الأدنى للتنبيه أو النسبة المئوية (إذا كان ذلك منطبقًا) للتطبيق، أو لتفعيل التنبيه أو إيقافه. تكون الشرائح المئوية التلقائية هي 90 لنظام التشغيل Android وiOS، والنسبة 75 للويب. إلى مزيد من المعلومات عن الشرائح المئوية التلقائية، راجِع تتبّع المقاييس الرئيسية في لوحة البيانات

ضبط تنبيه في بطاقة تقرير "لوحة البيانات"

  1. الانتقال إلى Performance Monitoring لوحة البيانات علامة تبويب في وحدة تحكُّم Firebase، ثم اختيار التطبيق المطلوب تهيئة تنبيه.

  2. في علامة التبويب "بطاقة التقرير"، حدِّد موقع بطاقة المقاييس التي تريد تهيئة تنبيه.

  3. في بطاقة المقياس المطلوبة، افتح "القائمة الكاملة" (). واختَر إعدادات التنبيه.

  4. اتّبِع التعليمات الظاهرة على الشاشة لضبط حد التنبيه ومقدار القياس المئوي (إن وُجد) للتطبيق، أو لتفعيل التنبيه أو إيقافه. تكون الشرائح المئوية التلقائية هي 90 لنظام التشغيل Android وiOS، والنسبة 75 للويب. إلى مزيد من المعلومات عن الشرائح المئوية التلقائية، راجِع تتبّع المقاييس الرئيسية في لوحة البيانات

أفضل الممارسات لإعداد تنبيه الأداء

طلبات الشبكة

يجمع Firebase البيانات من طلبات الشبكة المتشابهة ضمن أنماط عناوين URL، التي يمكن أن تكون أيًا مما يلي:

إعداد تنبيهات لأنماط عناوين URL المخصّصة

نوصي بإعداد تنبيهات لأي أنماط عناوين URL مخصصة تكوينه. بما أنّ Firebase تحاول مطابقة طلب مع نمط عنوان URL مخصّص أولاً، يتم ربط الطلبات المشابهة بنمط عنوان URL نفسه بشكل أكثر اتساقًا. وهذا ما يجعل تنبيهات نمط عنوان URL المخصص أكثر وضوحًا وفعالية لفريقك، لأنك حددت بالفعل هذا النمط المحدد من الطلبات لا يقل أهمية لتطبيقك.

إعداد تنبيهات لأنماط عناوين URL التلقائية

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

عمليات تحميل صفحة الويب

لمعرفة الحدود المقترَحة لقياس مقاييس الويب، يمكنك الاطّلاع على مؤشرات أداء الويب الأساسية التوثيق.

عمليات عرض الشاشة

ولضمان تجربة مثالية للتطبيق، يجب أن تكون جلسات المستخدمين خالية من البطء الإطارات الثابتة. يقترح تطبيق "Performance Monitoring" إعداد تنبيهات للإطارات الثابتة أكبر من 1% وإعداد تنبيهات لللقطات البطيئة التي تتجاوز نسبة 5% إِنْتَ أن هذه القيم موجودة كإعدادات افتراضية أثناء إعداد تنبيه الأداء. مزيد من المعلومات حول البطء المفرط أو الإطارات الثابتة وغيرها من أفضل الممارسات المتعلقة بأداء التطبيقات، راجِع إرشادات حول Google Play