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

يوفّر 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 console أو معلومات تحديد المشاكل وحلّها خاصة بالشركة.

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

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

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

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

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

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

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

كجزء من تنفيذ طلبات البحث، يمكنك إعداد تنبيه استنادًا إلى السجلّ أو تنبيه استنادًا إلى 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 console أو معلومات تحديد المشاكل وحلّها خاصة بالشركة.

لإعداد إمكانات التنبيهات المتقدّمة باستخدام 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