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

تقدّم 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 (وبيانات جلسات Firebase اختياريًا) إلى Cloud Logging.

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