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

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

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

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

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

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

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

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

2. إعداد عملية تصدير بيانات Crashlytics إلى Cloud Logging وبيانات جلسات Firebase (اختياريًا)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• ‫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