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

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

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

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

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

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

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

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

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

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

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

• مشرف أداء Firebase
• مشرف جودة Firebase
• مشرف Firebase
• مالك المشروع أو محرّره

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

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

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

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

1. في وحدة تحكّم Firebase، انتقِل إلى notifications تنبيهات Firebase في أعلى يسار الصفحة.
2. بعد ذلك، انتقِل إلى settings الإعدادات واضبط الإعدادات المفضّلة لحسابك بشأن 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. في أقصى يسار الصف، افتح قائمة الخيارات الإضافية (more_vert) وانقر على إعدادات التنبيهات.

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

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

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

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

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

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

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

طلبات الشبكة

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

• الأنماط التي يحدّدها المستخدم، والتي تُعرف باسم أنماط عناوين URL المخصّصة

• الأنماط المستندة إلى Firebase، والتي تُعرف باسم أنماط عناوين URL التلقائية
  قد تتغيّر هذه الأنماط بمرور الوقت استنادًا إلى أحدث سلوك استخدام تطبيقك.

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

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

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

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

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

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

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

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