إعداد تنبيهات مخصّصة وإرسالها إلى قنوات إشعارات مخصّصة

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

في هذه الحالات، يمكنك استخدام Cloud Monitoring لإرسال تنبيهات مخصّصة إلى قنوات إشعارات مخصّصة استنادًا إلى بيانات Crashlytics في Cloud Logging، والتي يتم توجيهها تلقائيًا إلى حزمة firebase-telemetry لتطبيقات الويب، أو يتم تصديرها إلى Cloud Logging لتطبيقات الأجهزة الجوّالة (مع بيانات جلسات Firebase الاختيارية).

لاستخدام Cloud Monitoring للتنبيهات المخصّصة، عليك إعداد سياسة تنبيه تصف الظروف التي تريد أن يتم تنبيهك فيها وكيفية إرسال الإشعارات إليك.

على سبيل المثال، إذا انخفض معدّل الجلسات الخالية من الأعطال عن حدّ معيّن أو ارتفع معدّل الخطأ في تطبيق الويب، يمكن أن ترسل أداة Cloud Monitoring رسالة تنبيه مخصّصة إلى عنوان بريد إلكتروني معيّن أو تنشرها في خدمة تابعة لجهة خارجية، مثل Discord أو Slack أو PagerDuty أو Jira. يمكنك أيضًا تخصيص المعلومات المُرسَلة في التنبيه بالكامل، مثل تضمين روابط لصفحات معيّنة مفيدة في وحدة تحكّم Firebase أو معلومات تحديد المشاكل وحلّها الخاصة بالشركة.

في مستندات Google Cloud، يمكنك الاطّلاع على مزيد من المعلومات حول Cloud Monitoring والتنبيهات، بما في ذلك الأسعار.

المتطلبات الأساسية

1. تأكَّد من أنّ مشروعك على Firebase يستخدم خطة أسعار Blaze المَرِنة.

2. تأكَّد من توفّر سجلّات Crashlytics في Cloud Logging:

   • بالنسبة إلى التطبيقات المتوافقة مع الأجهزة الجوّالة: يمكنك إعداد عملية تصدير بيانات Crashlytics إلى Cloud Logging، ويمكنك أيضًا تصدير بيانات جلسات Firebase.
   • بالنسبة إلى تطبيقات الويب: يتم إرسال السجلّات تلقائيًا إلى حزمة firebase-telemetry (firebasetelemetry.googleapis.com/events) عند إعداد Crashlytics في تطبيق الويب.

3. إعداد قنوات الإشعارات

إعداد سياسة تنبيه

في ما يلي تعليمات عامة. للحصول على تعليمات مفصّلة، يُرجى الاطّلاع على مستندات Google Cloud (على سبيل المثال: إنشاء سياسات تنبيهات تستند إلى الحدّ الأقصى للمقاييس أو استخدام PromQL لإنشاء سياسات تنبيهات).

كجزء من تشغيل طلبات البحث، يمكنك إعداد تنبيه مستند إلى السجلّ أو تنبيه مستند إلى SQL:

• إعداد تنبيه مستند إلى السجلّ:

  1. نفِّذ طلب بحث في Logs Explorer.

  2. انقر على الزر إضافة تنبيه الذي يظهر.

  3. اتّبِع التعليمات الظاهرة على الشاشة لإضافة تنبيه مستند إلى السجلّ.

• إعداد تنبيه مستند إلى SQL:

  1. نفِّذ طلب بحث في تحليلات السجلات.

  2. انقر على الزر إضافة تنبيه الذي يظهر.

  3. اتّبِع التعليمات الظاهرة على الشاشة لإضافة تنبيه مستند إلى SQL.

بدلاً من ذلك، يمكنك إعداد تنبيهات للمقاييس المستندة إلى السجلّات باستخدام أداة ضبط السياسات في وحدة تحكّم Google Cloud، حيث يمكنك تحديد أحد الخيارات التالية:

• أداة الإنشاء: توفّر واجهة مستخدم وحدة التحكّم سير عمل موجّهًا لإنشاء سياسة التنبيه.

  مثال: تنبيه بشأن الارتفاعات المفاجئة في أخطاء تطبيقات الويب

  بالنسبة إلى تطبيقات الويب، يمكنك إنشاء مقياس عدّاد مستند إلى السجلّ في حزمة firebase-telemetry Cloud Logging وضبط تنبيه بشأن الحدّ الأقصى باستخدام "أداة الإنشاء":

  1. في وحدة تحكّم Google Cloud، انتقِل إلى التسجيل > المقاييس المستندة إلى السجلّات، ثم انقر على إنشاء مقياس.
  2. اختَر عداد كنوع المقياس وأدخِل اسمًا للمقياس (مثلاً، web_crashlytics_errors).

  3. في مربّع إنشاء فلتر، أدخِل طلب البحث التالي بلغة LQL لاحتساب سجلّات أخطاء الويب الواردة:

     logName="projects/PROJECT_ID/logs/firebasetelemetry.googleapis.com%2Fevents"
     severity=ERROR
     

  4. انقر على إنشاء مقياس.

  5. من قائمة الإجراءات (النقاط الثلاث الرأسية) للمقياس الذي تم إنشاؤه حديثًا، اختَر إنشاء تنبيه من المقياس.

  6. اضبط النافذة المتجددة (على سبيل المثال، 5 min) ودالة النافذة المتجددة (rate أو count)، واختَر أعلى من الحدّ الأدنى كنوع الشرط، واختَر قنوات الإشعارات (مثل البريد الإلكتروني أو Slack أو PagerDuty أو الردود التلقائية على الويب).

• ‫PromQL: يمكنك تقديم طلب بحث PromQL لسياسة التنبيه

  مثال على طلب PromQL

  على سبيل المثال، لنفترض أنّك أنشأت مقياسَين مستندَين إلى السجلّات لبيانات جلسات Crashlytics وFirebase التي تم تصديرها:

  • مقياس واحد باسم firebase/crashlytics_events وتصنيف errorType، ويتم تعريفه على النحو التالي:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • مقياس آخر باسم firebase/session_events يحمل التصنيف eventType، ويتم تعريفه على النحو التالي:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  في ما يلي مثال على طلب PromQL يستخدم هذه المقاييس المستندة إلى السجلّات لإرسال تنبيه عندما تنخفض نسبة عدم حدوث الأعطال إلى أقل من %70:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7