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

استخدِم تنبيهات 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 أيام.

يمكنك الاطّلاع على مزيد من المعلومات عن ضبط التنبيهات والنسب المئوية التلقائية وأفضل الممارسات لإعداد التنبيهات لأنواع معيّنة من عمليات التتبُّع والمقاييس.

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

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

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

يمكن لخدمة Firebase تلقائيًا إرسال تنبيهات Performance Monitoring عبر البريد الإلكتروني.

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

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

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

بالنسبة إلى حسابك، يمكنك تفعيل تنبيهات 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 من صحة التنبيهات لضمان صلاحية البيانات واستخدام التنبيهات بشكل نشط. تُعتبر التنبيهات صالحة في حال استيفاء أحد الشروط التالية:

  • يتم إنشاء التنبيه لمعرّف مورد تلقّى 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 مخصّص لضمان ثبات هذا النمط.

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

للتعرّف على الحدود المقترَحة لقياس مقاييس الويب، راجِع مستندات Core Web Vitals.

عرض الشاشة

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