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

توفّر 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 إلى قنوات إشعارات مخصّصة. على سبيل المثال، يمكنك كتابة دالة تسجّل حدث تنبيه بشأن تنبيهات السرعة <0x0A>وتنشر معلومات التنبيه إلى خدمة تابعة لجهة خارجية، مثل Discord أو Slack أو Jira.

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

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

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

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

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

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

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