يمكن لمنصة Firebase إرسال مجموعة متنوّعة من تنبيهات Crashlytics التلقائية (راجِع صفحة نظرة عامة على التنبيهات). تقدّم منصة Firebase عمليات دمج أساسية للتنبيهات لإرسال تنبيهات Crashlytics التلقائية Crashlytics إلى Slack وJira وPagerDuty.
في ما يلي كيفية إعداد عمليات الدمج هذه وضبطها في وحدة تحكّم Firebase:
اتّبِع سير العمل الموجَّه لكل خدمة تنبيهات في الـ
إعدادات > عمليات الدمج صفحة من الـFirebase وحدة تحكّم.اختَر الإعدادات التي يتم استخدامها للتطبيقات الفردية واضبط وجهة التنبيهات الأخرى في بطاقة Crashlytics في
الإعدادات > التنبيهات صفحة من وحدة تحكّم Firebase.
يصف الجزء المتبقي من هذه الصفحة بالتفصيل كيفية إعداد كل عملية دمج أساسية للتنبيهات.
Slack: إعداد عملية الدمج مع Slack
بعد إعداد عملية دمج Firebase مع Slack، يمكن لمشروعك النشر في مساحة عمل Slack استجابةً للأحداث التي يبلغ عنها Crashlytics، مثل المشاكل الجديدة أو المتكرّرة أو المتزايدة.
الخطوة 1: إعداد رابط ويب هوك في Slack
قبل إعداد عملية الدمج في Firebase، عليك إضافة رابط ويب هوك وارد في Slack للتعامل مع الاتصالات الواردة من Firebase.
لمعرفة كيفية إجراء ذلك، اطّلِع على مستندات Slack حول إرسال الرسائل باستخدام روابط الويب هوك الواردة.
الخطوة 2: إعداد عملية الدمج مع Slack في وحدة تحكّم Firebase
بعد إعداد رابط الويب هوك المناسب، يمكنك إعداد عملية الدمج مع Crashlytics
في وحدة تحكّم Firebase، انتقِل إلى صفحة
الإعدادات > عمليات الدمج.في بطاقة عملية الدمج مع Slack ، انقر على تثبيت.
أعِدّ عملية الدمج عن طريق ضبط القيم في الحقول التالية:
رابط الويب هوك: الصِق رابط الويب هوك من صفحة إعدادات Slack.
القناة التلقائية: أدخِل اسم قناة. يمكنك إلغاء هذا الإعداد التلقائي لاحقًا على أساس كل تطبيق أو كل تنبيه.
اسم المستخدم الذي ينشر: أدخِل اسمًا لإرسال الرسائل به.
انقر على التحقّق والحفظ.
بعد التحقّق من عملية الدمج مع Slack وحفظها، من المفترض أن تظهر لك رسالة تأكيد في القناة التلقائية التي اخترتها.
الخطوة 3: ضبط إعدادات التنبيهات في Slack
يمكنك ضبط التنبيهات حسب التطبيق ونوع الحدث. على سبيل المثال، يمكنك إيقاف
التنبيهات في تطبيق الاختبار أو توجيه التنبيهات ذات الأولوية العالية في تطبيق الإنتاج
إلى قناة #urgent
أنواع الأحداث
تتيح لك عملية دمج Firebase مع Slack إرسال تنبيهات استجابةً لأنواع الأحداث التالية:
المشاكل الجديدة الخطيرة: يتم إطلاقها عندما يواجه تطبيقك عطلاً أو خطأ ANR لم يسبق أن رصده Crashlytics.
المشاكل الجديدة غير الخطيرة: يتم إطلاقها عندما يواجه تطبيقك مشكلة غير خطيرة لم يسبق أن رصدها Crashlytics.
المشاكل المتكرّرة: يتم إطلاقها عندما يواجه تطبيقك عطلاً سبق لك وضع علامة "تم الإغلاق" عليه.
المشاكل الشائعة: يتم إطلاقها عندما تظهر مشكلة أو تصبح شائعة.
المشاكل المتزايدة: يتم إطلاقها عندما يؤثر نوع واحد من الأعطال أو أخطاء ANR في نسبة مئوية من المستخدمين خلال فترة 30 دقيقة لإصدار معيّن من التطبيق.
ضبط الإعدادات لكل تطبيق
في ما يلي كيفية ضبط التنبيهات لكل تطبيق في مشروع Firebase:
في وحدة تحكّم Firebase، انتقِل إلى صفحة
الإعدادات > التنبيهات.انتقِل إلى بطاقة تنبيهات Crashlytics. اختَر التطبيق الذي تريد ضبطه من القائمة المنسدلة.
اختَر قناة Slack التي تريد إرسال التنبيهات إليها لهذا التطبيق.
لكل نوع من أنواع التنبيهات، اختَر من القائمة المنسدلة ما إذا كنت تريد إرسال هذا النوع من التنبيهات إلى Slack.
كرِّر هذه الخطوات لكل تطبيق تريد ضبطه.
وهذا كل ما في الأمر! سترسل منصة Firebase تنبيهات إلى قنوات Slack التي تحدّدها إذا كانت تطبيقاتك تواجه مشاكل جديدة أو متكرّرة أو متزايدة.
Jira: إعداد عملية الدمج مع Jira
بعد إعداد عملية دمج Firebase مع Jira، يمكن لمشروع Firebase أن ينشر في مشروع Jira استجابةً للأحداث التي يبلغ عنها Crashlytics، مثل المشاكل الجديدة أو المتكرّرة أو المتزايدة. يمكنك أيضًا ربط مشاكل Crashlytics الفردية بمشاكل Jira.
الخطوة 1: إعداد Jira لعملية الدمج مع Firebase
إنشاء رمز مميّز لواجهة برمجة التطبيقات (Jira Cloud فقط)
قبل إعداد عملية الدمج في Firebase، عليك إنشاء رمز مميّز لواجهة برمجة التطبيقات في Jira Cloud.
في وحدة تحكّم Jira، افتح الـ رموز المميّزة لواجهة برمجة التطبيقات.
انقر على إنشاء رمز مميّز لواجهة برمجة التطبيقات.
احفظ هذا الرمز المميّز لواجهة برمجة التطبيقات في مكان آمن، لأنّك ستحتاج إليه لاحقًا.
إنشاء نوع المشكلة "خطأ"
تنشئ عملية دمج Firebase مع Jira مشاكل من النوع Bug. عليك إنشاء نوع المشكلة هذا في مشروعك على Jira (إذا لم يكن موجودًا من قبل).
في وحدة تحكّم Jira، انتقِل إلى إعدادات المشروع.
انقر على أنواع المشاكل.
انقر على إضافة نوع المشكلة.
اختَر "خطأ" أو أدخِله يدويًا.
الخطوة 2: إعداد عملية الدمج مع Jira في وحدة التحكّم Firebase
أعِدّ عملية الدمج مع Jira لـ Jira Cloud أو Jira Server.
Jira Cloud
في وحدة تحكّم Firebase، انتقِل إلى صفحة
الإعدادات > عمليات الدمج.في بطاقة عملية الدمج مع Jira ، انقر على تثبيت.
انقر على إعداد عملية الدمج مع Jira.
أدخِل عنوان URL لمشروعك على Jira بالتنسيق التالي:
https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEYأدخِل عنوان بريدك الإلكتروني لتسجيل الدخول إلى Jira والرمز المميّز لواجهة برمجة التطبيقات.
انقر على التحقّق والحفظ.
Jira Server
في وحدة تحكّم Firebase، انتقِل إلى صفحة
الإعدادات > عمليات الدمج.في بطاقة عملية الدمج مع Jira ، انقر على تثبيت.
انقر على إعداد عملية الدمج مع Jira.
أدخِل عنوان URL لمشروعك على Jira بالتنسيق التالي:
https://SERVER_NAME.com/projects/PROJECT_KEYأدخِل عنوان بريدك الإلكتروني لتسجيل الدخول إلى Jira والرمز المميّز لواجهة برمجة التطبيقات.
انقر على التحقّق والحفظ.
الخطوة 3: ضبط إعدادات التنبيهات في Jira
يمكنك ضبط التنبيهات حسب التطبيق ونوع الحدث. على سبيل المثال، يمكنك إيقاف التنبيهات في تطبيق الاختبار أو توجيه التنبيهات بشأن تطبيقات مختلفة إلى مشاريع مختلفة على Jira.
أنواع الأحداث
تتيح لك عملية دمج Firebase مع Jira إرسال تنبيهات استجابةً لأنواع الأحداث التالية:
المشاكل الجديدة الخطيرة: يتم إطلاقها عندما يواجه تطبيقك عطلاً أو خطأ ANR لم يسبق أن رصده Crashlytics.
المشاكل الجديدة غير الخطيرة: يتم إطلاقها عندما يواجه تطبيقك مشكلة غير خطيرة لم يسبق أن رصدها Crashlytics.
المشاكل المتكرّرة: يتم إطلاقها عندما يواجه تطبيقك عطلاً سبق لك وضع علامة "تم الإغلاق" عليه.
المشاكل الشائعة: يتم إطلاقها عندما تظهر مشكلة أو تصبح شائعة.
المشاكل المتزايدة: يتم إطلاقها عندما يؤثر نوع واحد من الأعطال أو أخطاء ANR في نسبة مئوية من المستخدمين خلال فترة 30 دقيقة لإصدار معيّن من التطبيق.
ضبط الإعدادات لكل تطبيق
في ما يلي كيفية ضبط التنبيهات لكل تطبيق في مشروع Firebase:
في وحدة تحكّم Firebase، انتقِل إلى صفحة
الإعدادات > التنبيهات.انتقِل إلى بطاقة تنبيهات Crashlytics. اختَر التطبيق الذي تريد ضبطه من القائمة المنسدلة.
اختَر مشروع Jira الذي تريد إرسال التنبيهات إليه لهذا التطبيق.
لكل نوع من أنواع التنبيهات، اختَر من القائمة المنسدلة ما إذا كنت تريد إرسال هذا النوع من التنبيهات إلى Jira.
كرِّر هذه الخطوات لكل تطبيق تريد ضبطه.
وهذا كل ما في الأمر! سترسل منصة Firebase تنبيهات إلى مشاريع Jira التي تحدّدها إذا كانت تطبيقاتك تواجه مشاكل جديدة أو متكرّرة أو متزايدة.
(اختياري) ربط مشاكل Crashlytics بمشاكل Jira
بالإضافة إلى مشاكل Jira التي تنشئها منصة Firebase تلقائيًا، من الممكن ربط مشاكل Crashlytics بمشاكل Jira الحالية. يمكنك أيضًا إنشاء مشكلة جديدة في Jira من وحدة تحكّم Firebase. عليك تفعيل عملية الدمج مع Jira قبل استخدام هذه الميزة.
انتقِل إلى مشكلة Crashlytics التي تريد ربطها بمشكلة Jira.
انقر على الربط بـ Jira.
انقر على إنشاء مشكلة في المشروع أو الصِق عنوان URL لمشكلة Jira أو مفتاح المشكلة في الحقل المقدَّم.
إلغاء ربط مشكلة Crashlytics بمشكلة Jira
انتقِل إلى مشكلة Crashlytics التي تريد إلغاء ربطها بـ Jira.
انقر على المشكلة المرتبطة.
انقر على المزيد، ثم على إلغاء الربط.
PagerDuty: إعداد عملية الدمج مع PagerDuty
بعد إعداد عملية دمج Firebase مع PagerDuty، يتيح مشروع Firebase الخاص بك لـ PagerDuty إرسال إشعار إلى المستجيبين المناوبين استجابةً للأحداث التي يبلغ عنها Crashlytics، مثل المشاكل الجديدة أو المتكرّرة أو المتزايدة.
الخطوة 1: إعداد عملية الدمج مع PagerDuty في وحدة تحكّم Firebase
في وحدة تحكّم Firebase، انتقِل إلى صفحة
الإعدادات > عمليات الدمج.في بطاقة عملية الدمج مع PagerDuty ، انقر على تثبيت.
اتّبِع التعليمات الظاهرة على الشاشة لإعداد عملية الدمج.
انقر على التحقّق والحفظ.
الخطوة 2: ضبط إعدادات التنبيهات في PagerDuty
يمكنك ضبط التنبيهات حسب التطبيق ونوع الحدث. على سبيل المثال، يمكنك إيقاف التنبيهات في تطبيق الاختبار أو توجيه التنبيهات بشأن تطبيقات مختلفة إلى مشاريع مختلفة على PagerDuty.
أنواع الأحداث
تتيح لك عملية دمج Firebase مع PagerDuty إرسال تنبيهات استجابةً لأنواع الأحداث التالية:
المشاكل الجديدة الخطيرة: يتم إطلاقها عندما يواجه تطبيقك عطلاً أو خطأ ANR لم يسبق أن رصده Crashlytics.
المشاكل الجديدة غير الخطيرة: يتم إطلاقها عندما يواجه تطبيقك مشكلة غير خطيرة لم يسبق أن رصدها Crashlytics.
المشاكل المتكرّرة: يتم إطلاقها عندما يواجه تطبيقك عطلاً سبق لك وضع علامة "تم الإغلاق" عليه.
المشاكل الشائعة: يتم إطلاقها عندما تظهر مشكلة أو تصبح شائعة.
المشاكل المتزايدة: يتم إطلاقها عندما يؤثر نوع واحد من الأعطال أو أخطاء ANR في نسبة مئوية من المستخدمين خلال فترة 30 دقيقة لإصدار معيّن من التطبيق.
ضبط الإعدادات لكل تطبيق
في ما يلي كيفية ضبط التنبيهات لكل تطبيق في مشروع Firebase:
في وحدة تحكّم Firebase، انتقِل إلى صفحة
الإعدادات > التنبيهات.انتقِل إلى بطاقة تنبيهات Crashlytics. اختَر التطبيق الذي تريد ضبطه من القائمة المنسدلة.
اختَر خدمة PagerDuty التي تريد إرسال التنبيهات إليها لهذا التطبيق.
لكل نوع من أنواع التنبيهات، اختَر من القائمة المنسدلة ما إذا كنت تريد إرسال هذا النوع من التنبيهات إلى PagerDuty.
كرِّر هذه الخطوات لكل تطبيق تريد ضبطه.
وهذا كل ما في الأمر! ستنشر منصة Firebase الأخطاء في خدمة PagerDuty التي تحدّدها إذا كانت تطبيقاتك تواجه مشاكل جديدة أو متكرّرة أو متزايدة.