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

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

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

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

يتم تشغيل تنبيه عندما يتجاوز مقياس ما في تطبيقك الحدّ الذي وتُحدِّد قيمة مئوية محدَّدة (إذا كان ذلك منطبقًا) في وحدة تحكُّم 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 ليست متوفرة لتنبيهات "مراقبة الأداء".

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

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

بشكل تلقائي، يمكن أن يرسل Firebase تنبيهات "مراقبة الأداء" عبر البريد الإلكتروني.

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

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

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

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

لتفعيل تنبيهات "مراقبة الأداء" أو إيقافها، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

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

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

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

في حال عدم استيفاء أيّ من هذين الشرطين، تزيل ميزة "مراقبة الأداء" التنبيه.

ضبط تنبيه

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

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

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

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

  1. انتقِل إلى لوحة البيانات الخاصة بمراقبة الأداء مفتاح التبويب (Tab) في "وحدة تحكُّم Firebase" ثم اختيار التطبيق المطلوب تهيئة تنبيه.

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

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

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

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

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

  1. انتقِل إلى لوحة البيانات الخاصة بمراقبة الأداء مفتاح التبويب (Tab) في "وحدة تحكُّم Firebase" ثم اختيار التطبيق المطلوب تهيئة تنبيه.

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

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

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

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

طلبات الشبكة

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

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

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

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

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

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

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

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

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