توفّر Firebase عمليات دمج أساسية للتنبيهات من أجل إرسال Crashlytics تنبيهات إلى Slack وJira وPagerDuty.
في ما يلي الخطوات العامة التي يجب اتّباعها لإعداد عمليات الدمج هذه وضبطها في وحدة تحكّم Firebase:
اتّبِع خطوات سير العمل الإرشادية لكل خدمة في علامة التبويب عمليات الدمج في
إعدادات المشروع .اختَر الإعداد الذي سيتم استخدامه للتطبيقات الفردية واضبط وجهة التنبيهات الأخرى في بطاقة Crashlytics ضمن علامة التبويب التنبيهات في
إعدادات المشروع .
يوضّح الجزء المتبقي من هذه الصفحة بالتفصيل كيفية إعداد كل عملية تكامل أساسية للتنبيهات.
إعداد عملية دمج أساسية مع Slack
بعد إعداد عملية الدمج بين Firebase وSlack، يمكن لمشروعك النشر في مساحة عملك على Slack استجابةً للأحداث التي تم الإبلاغ عنها من خلال Crashlytics، مثل المشاكل الجديدة أو المتكررة أو المتزايدة السرعة.
الخطوة 1: إعداد خطاف ويب في Slack
قبل إعداد عملية الدمج في Firebase، عليك إضافة خطاف ويب وارد في Slack للتعامل مع الرسائل الواردة من Firebase.
لمعرفة كيفية إجراء ذلك، يمكنك الاطّلاع على مستندات Slack حول إرسال الرسائل باستخدام Incoming Webhooks.
الخطوة 2: إعداد عملية الربط مع Slack في وحدة تحكّم Firebase
بعد إعداد خطاف الويب المناسب، يمكنك إعداد عملية الدمج لـ Crashlytics باتّباع الخطوات التالية:
سجِّل الدخول إلى وحدة تحكّم Firebase، ثم اختَر مشروعك.
انقر على ، ثم اختَر إعدادات المشروع.
انقر على علامة التبويب عمليات الدمج.
في بطاقة دمج Slack، انقر على تثبيت.
اضبط عملية الدمج من خلال إدخال قيم في الحقول التالية:
عنوان URL للردّ التلقائي على الويب: الصِق عنوان URL للردّ التلقائي على الويب من صفحة إعدادات Slack.
القناة التلقائية: أدخِل اسم قناة. يمكنك إلغاء هذا الإعداد التلقائي لاحقًا على أساس كل تطبيق أو كل تنبيه.
اسم المستخدم الذي ينشر: أدخِل اسمًا لإرسال الرسائل به.
انقر على إثبات الملكية والحفظ.
بعد إثبات ملكية عملية الربط مع Slack وحفظها، من المفترض أن تظهر لك رسالة تأكيد في القناة التلقائية التي اخترتها.
الخطوة 3: ضبط إعدادات التنبيهات في Slack
يمكنك ضبط التنبيهات حسب التطبيق ونوع الحدث. على سبيل المثال، يمكنك إيقاف التنبيهات في تطبيق الاختبار أو توجيه التنبيهات ذات الأولوية العالية في تطبيق الإصدار العلني إلى قناة #urgent.
أنواع الأحداث
يتيح لك دمج Firebase مع Slack إرسال تنبيهات استجابةً لأنواع الأحداث التالية:
المشاكل الجديدة الخطيرة: يتم تفعيلها عندما يتعطّل تطبيقك أو يحدث فيه خطأ ANR لم يسبق أن رصده Crashlytics.
المشاكل الجديدة غير الخطيرة: يتم تفعيلها عندما يواجه تطبيقك مشكلة غير خطيرة Crashlytics لم يتم رصدها من قبل.
المشاكل التي تكرّرت: يتم تسجيلها عندما يتعطّل تطبيقك بسبب مشكلة سبق أن أشرت إلى أنّها تم حلّها.
المشاكل الشائعة: يتم تفعيلها عندما تظهر مشكلة جديدة أو تصبح شائعة.
المشاكل المتزايدة السرعة: يتم تفعيلها عندما يؤثر نوع واحد من الأعطال أو أخطاء ANR في نسبة من المستخدمين خلال فترة 30 دقيقة لإصدار معيّن من التطبيق.
ضبط إعدادات كل تطبيق
في ما يلي كيفية ضبط التنبيهات لكل تطبيق في مشروعك على Firebase:
سجِّل الدخول إلى وحدة تحكّم Firebase، ثم اختَر مشروعك.
انقر على ، ثم اختَر إعدادات المشروع.
انقر على علامة التبويب التنبيهات.
انتقِل إلى بطاقة تنبيهات Crashlytics. اختَر التطبيق الذي تريد ضبطه من القائمة المنسدلة.
اختَر قناة Slack التي تريد إرسال التنبيهات إليها لهذا التطبيق.
لكل نوع من أنواع التنبيهات، اختَر من القائمة المنسدلة ما إذا كنت تريد إرسال هذا النوع من التنبيهات إلى Slack.
كرِّر هذه الخطوات لكل تطبيق تريد إعداده.
وهذا كل ما في الأمر! سترسل Firebase تنبيهات إلى قنوات Slack التي حدّدتها إذا كانت تطبيقاتك تتضمّن مشاكل جديدة أو متكرّرة أو متزايدة.
إعداد عملية دمج أساسية مع Jira
بعد إعداد عملية الربط بين Firebase وJira، يمكن لمشروعك على Firebase إرسال منشور إلى مشروع على Jira استجابةً للأحداث التي تم الإبلاغ عنها من خلال Crashlytics، مثل المشاكل الجديدة أو المتكرّرة أو المتزايدة السرعة. يمكنك أيضًا ربط مشاكل فردية بمشاكل Jira.Crashlytics
الخطوة 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
بعد إعداد عملية الدمج بين 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 التي حدّدتها إذا كانت تطبيقاتك تتضمّن مشاكل جديدة أو متكرّرة أو متزايدة السرعة.