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

يوفّر 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