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

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

• (إجراء مقترَح) إعداد تنبيهات مخصّصة وإرسالها إلى قنوات إشعارات مخصّصة

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

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

  يمكنك استخدام Cloud Functions لإرسال تنبيهات Crashlytics التلقائية إلى قنوات إشعارات مخصّصة.

---

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• إعداد تنبيه مستند إلى لغة الاستعلامات البنيوية (SQL):

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

  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

---

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

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

في هذه الحالات، يمكنك استخدام Cloud Functions for Firebase لإرسال تنبيهات Crashlytics التلقائية هذه إلى قنوات إشعارات مخصّصة. على سبيل المثال، يمكنك كتابة دالة تسجّل حدث تنبيه بشأن السرعة وتنشر معلومات التنبيه إلى خدمة تابعة لجهة خارجية، مثل Discord أو Slack أو Jira.

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

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

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

   1. إعداد بيئة تطوير لـ Node.js أو Python
   2. ثبِّت واجهة سطر الأوامر (CLI) Firebase وسجِّل الدخول إليها.
   3. ابدأ Cloud Functions for Firebase باستخدام واجهة سطر الأوامر Firebase.

2. اكتب ونفِّذ دالة تعمل على تسجيل حدث تنبيه من Crashlytics ومعالجة حمولة الحدث (على سبيل المثال، نشر معلومات التنبيه في رسالة على Discord).

للاطّلاع على جميع أحداث التنبيهات Crashlytics التي يمكنك تسجيلها، انتقِل إلى مستندات المرجع الخاصة بتنبيهات Crashlytics.

مزيد من المعلومات حول التعامل مع تنبيهات Crashlytics باستخدام Cloud Functions for Firebase