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

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

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

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

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

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

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

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

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

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

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

طلبات الشبكة

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

  • سجَّلت Firebase ما لا يقل عن 100 عيّنة تطابقت مع نمط عنوان URL في جميع إصدارات تطبيقك خلال الساعة الأخيرة.
  • تجاوزت القيمة المجمّعة للمقياس الحدّ المحدّد خلال الساعة الأخيرة:
    • response time: تجاوزت القيمة المجمّعة الحدّ المعيّن للشريحة المئوية التي تم ضبطها
    • معدّل النجاح: (لأجهزة 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. ثبِّت واجهة سطر الأوامر (CLI) في "Firebase" وسجِّل الدخول إليها.
    3. ابدأ إعداد Cloud Functions for Firebase باستخدام واجهة سطر الأوامر (CLI) في 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 مخصّص لضمان ثبات هذا النمط.

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

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

عرض الشاشة

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