Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

ما الذي يطلق التنبيه؟

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

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

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

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

تتبع رمز مخصص

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

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

طلبات الشبكة

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

  • سجل Firebase ما لا يقل عن 100 نموذج تطابق نمط عنوان URL عبر جميع إصدارات تطبيقك في الساعة الماضية.
  • تجاوزت القيمة المجمعة للمقياس الحد المحدد خلال الساعة الماضية:
    • وقت الاستجابة : تجاوزت القيمة المجمعة الحد المعين للنسب المئوي الذي تم تكوينه
    • معدل النجاح : (لنظام التشغيل iOS + / Android فقط) انخفضت القيمة المجمعة عن الحد المعين عبر جميع المستخدمين
  • لم يكن هناك تنبيه تم رفعه مسبقًا لنفس الحد في الأيام الثلاثة الماضية.

عرض الشاشة

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

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

تحميل الصفحة

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

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

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

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

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

احصل على التنبيهات الافتراضية

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

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

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

قم بتشغيل / إيقاف تشغيل التنبيهات لحسابك الخاص

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

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

  1. في وحدة تحكم Firebase ، في الزاوية اليمنى العليا ، انتقل إلى Firebase .
  2. بعد ذلك ، انتقل إلى إعدادات وقم بتعيين تفضيلات حسابك لتنبيهات مراقبة الأداء.

قم بإعداد التنبيه المتقدم لخدمات الطرف الثالث

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

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

  1. قم بإعداد وظائف السحابة لـ Firebase ، والتي تتضمن المهام التالية:

    1. قم بإعداد بيئة تطوير لـ Node.js أو Python.
    2. قم بتثبيت Firebase CLI وتسجيل الدخول إليه.
    3. قم بتهيئة وظائف السحابة لـ Firebase باستخدام Firebase CLI.
  2. اكتب ونشر وظيفة تلتقط حدث تنبيه من مراقبة الأداء وتعالج حمولة الحدث (على سبيل المثال ، تنشر معلومات التنبيه في رسالة على Discord).

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

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

تتحقق مراقبة الأداء من صحة التنبيهات للتأكد من أن البيانات صحيحة وأن التنبيهات قيد الاستخدام النشط. تعتبر التنبيهات صالحة إذا تحقق أي مما يلي:

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

إذا لم يتم استيفاء أي من هذه الشروط ، فإن مراقبة الأداء تزيل التنبيه.

تكوين تنبيه

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

إذا لم تكن قد قمت بذلك بالفعل ، فأضف أحدث SDK لمراقبة الأداء إلى تطبيقك. لمزيد من المعلومات ، راجع أدلة البدء للويب وأنظمة Android و Apple و Flutter .

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

قم بتكوين تنبيه في جدول التتبع

  1. انتقل إلى علامة التبويب لوحة مراقبة الأداء في وحدة تحكم Firebase ، ثم حدد التطبيق الذي تريد تكوين تنبيه له.

  2. قم بالتمرير لأسفل إلى جدول التتبع في الجزء السفلي من الشاشة.

  3. حدد علامة التبويب الخاصة بنوع التتبع الذي تريد تعيين تنبيه له ، ثم ابحث عن الصف المناسب.

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

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

قم بتكوين تنبيه في بطاقة تقرير لوحة المعلومات

  1. انتقل إلى علامة التبويب لوحة مراقبة الأداء في وحدة تحكم 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 .

عرض الشاشة

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