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

توفّر 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 الخاص بك على خطة 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

---

إرسال تنبيهات "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 باستخدام واجهة سطر الأوامر (CLI) في Firebase.

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

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

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