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

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

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

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

يتم تشغيل تنبيه عندما يتجاوز مقياس لتطبيقك الحد الذي تحدده لنسبة مئوية محددة (إن أمكن) في وحدة تحكم 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. ثم اذهب الى الإعدادات وقم بتعيين تفضيلات حسابك لتنبيهات مراقبة الأداء.

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

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

لإعداد إمكانات التنبيه المتقدمة باستخدام Cloud Functions for Firebase، اتبع الخطوات التالية:

  1. قم بإعداد Cloud Functions لـ 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 ، ومسؤول جودة Firebase ، ومسؤول Firebase ، ومالك المشروع أو محرره .

إذا لم تكن قد قمت بذلك بالفعل، فأضف أحدث إصدار من 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 المخصصة .

  • الأنماط المشتقة من Firebase، والتي تسمى أنماط URL التلقائية .
    قد تتغير هذه الأنماط بمرور الوقت بناءً على سلوك الاستخدام الأخير لتطبيقك.

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

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

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

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

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

لمعرفة الحدود الموصى بها لقياس مقاييس الويب، راجع وثائق مؤشرات أداء الويب الأساسية .

الاداءات الشاشة

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