يمكن أن يرسل Firebase مجموعة متنوعة من Crashlytics التنبيهات التلقائية (راجِع صفحة نظرة عامة حول التنبيهات). توفّر Firebase عمليات دمج أساسية للتنبيهات من أجل إرسال التنبيهات التلقائية Crashlytics إلى Slack وJira وPagerDuty.
في ما يلي الخطوات العامة لإعداد عمليات الدمج هذه وضبطها في وحدة تحكّم Firebase:
اتّبِع سير العمل الموجَّه لكل خدمة تنبيه في صفحة
الإعدادات > عمليات الدمج في وحدة تحكّم Firebase.اختَر الإعدادات التي سيتم استخدامها للتطبيقات الفردية، واضبط وجهة التنبيهات الأخرى في بطاقة Crashlytics ضمن صفحة
الإعدادات > التنبيهات في وحدة تحكّم Firebase.
توضّح بقية هذه الصفحة بالتفصيل كيفية إعداد كل عملية دمج أساسية للتنبيهات.
Slack: إعداد عملية الدمج مع Slack
بعد إعداد عملية الدمج بين Firebase وSlack، يمكن لمشروعك النشر في مساحة عملك على Slack استجابةً للأحداث التي تم الإبلاغ عنها من خلال Crashlytics، مثل المشاكل الجديدة أو المتكرّرة أو المتزايدة السرعة.
الخطوة 1: إعداد خطاف ويب في Slack
قبل إعداد عملية الدمج في Firebase، عليك إضافة رابط ويب وارد في Slack للتعامل مع الرسائل الواردة من Firebase.
لمعرفة كيفية إجراء ذلك، يُرجى قراءة مستندات Slack حول إرسال الرسائل باستخدام Incoming Webhooks.
الخطوة 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، افتح إعدادات رموز API المميزة.
انقر على إنشاء رمز مميّز لواجهة برمجة التطبيقات.
احفظ رمز API المميز في مكان آمن، لأنّك ستحتاج إليه لاحقًا.
إنشاء نوع المشكلة "خطأ"
يؤدي دمج 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 التي تحدّدها إذا كانت تطبيقاتك تتضمّن مشاكل جديدة أو متكرّرة أو متزايدة السرعة.