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

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