Firebase می‌تواند انواع مختلفی از هشدارهای پیش‌فرض Crashlytics را ارسال کند (به صفحه نمای کلی هشدار مراجعه کنید). Firebase یکپارچه‌سازی‌های هشداردهی پایه را برای ارسال Crashlytics هشدارهای پیش‌فرض به Slack، Jira، و PagerDuty ارائه می‌دهد.
در سطح بالا، نحوه راه‌اندازی و پیکربندی این ادغام‌ها در کنسول Firebase به شرح زیر است:
گردش کار راهنمایی‌شده را برای هر سرویس هشداردهی در
تنظیمات > صفحه ادغام‌ها در کنسول Firebase دنبال کنید.انتخاب کنید کدام پیکربندی برای برنامه‌های تلفن همراه جداگانه استفاده شود و مقصد هشدارهای دیگر را در کارت Crashlytics در صفحه
تنظیمات > هشدارها در کنسول Firebase پیکربندی کنید.
بقیه این صفحه به‌طور مفصل توضیح می‌دهد که چگونه هریک از یکپارچه‌سازی‌های هشداردهی پایه را راه‌اندازی کنید.
Slack: راه‌اندازی یکپارچه‌سازی با Slack
پس‌از راه‌اندازی ادغام Firebase با Slack، پروژه‌تان می‌تواند در پاسخ به رویدادهای گزارش‌شده توسط Crashlytics، مانند مشکلات جدید، پس‌رفت، یا افزایش سرعت، در فضای کاری Slack شما پست کند.
مرحله ۱: راه‌اندازی وب‌قلاب Slack
قبل‌از راه‌اندازی ادغام در Firebase، باید یک وب‌هوک ورودی در Slack اضافه کنید تا ارتباطات از Firebase را مدیریت کند.
برای آشنایی با نحوه انجام این کار، مستندات Slack را درباره ارسال پیام بااستفاده از وب‌قلاب‌های ورودی بخوانید.
مرحله ۲: راه‌اندازی ادغام Slack در کنسول Firebase
پس‌از راه‌اندازی وب‌قلاب مناسب، آماده راه‌اندازی ادغام برای Crashlytics هستید:
در کنسول Firebase، به صفحه
تنظیمات > ادغام‌ها بروید.در کارت ادغام Slack، روی نصب کلیک کنید.
با تنظیم مقادیر در فیلدهای زیر، ادغام را راه‌اندازی کنید:
نشانی وب وب‌قلاب: نشانی وب وب‌قلاب را از صفحه تنظیمات Slack جای‌گذاری کنید.
کانال پیش‌فرض: نام کانال را وارد کنید. بعداً می‌توانید این پیش‌فرض را برای هر برنامه یا هر هشدار لغو کنید.
نام کاربر پست‌کننده: نامی را وارد کنید تا پیام‌ها با آن نام ارسال شود.
روی درستی‌سنجی و ذخیره کلیک کنید.
پس‌از درستی‌سنجی و ذخیره کردن ادغام Slack، باید پیام تأییدی در کانال پیش‌فرضی که انتخاب کرده‌اید ببینید.
مرحله ۳: پیکربندی تنظیمات هشدار برای Slack
می‌توانید هشدارها را براساس برنامه تلفن همراه و نوع رویداد پیکربندی کنید. برای مثال، می‌توانید هشدارها را در برنامه آزمایشی‌تان خاموش کنید یا هشدارهای با اولویت بالا را در برنامه تولیدی‌تان به کانال #urgent هدایت کنید.
انواع رویداد
ادغام Firebase با Slack به شما امکان می‌دهد در پاسخ به انواع رویدادهای زیر هشدار ارسال کنید:
مشکلات مهلک جدید: زمانی فعال می‌شود که برنامه‌تان دچار خرابی یا ANR شود که Crashlytics قبلاً آن را ندیده است.
مشکلات غیرمهلک جدید: زمانی فعال می‌شود که برنامه‌تان مشکل غیرمهلکی را تجربه کند که Crashlytics قبلاً ندیده است.
مشکلات پس‌رفت: زمانی راه‌اندازی می‌شود که برنامه‌تان با خرابی‌ای مواجه شود که قبلاً آن را به‌عنوان بسته‌شده علامت‌گذاری کرده‌اید.
مشکلات پرطرفدار: زمانی فعال می‌شود که مشکلی درحال ظهور یا پرطرفدار شدن باشد (برای برنامه‌های وب پشتیبانی نمی‌شود).
مشکلات با سرعت فزاینده: زمانی راه‌اندازی می‌شود که یک نوع خرابی یا ANR بر درصدی از کاربران در یک دوره ۳۰ دقیقه‌ای برای نسخه برنامه خاصی تأثیر بگذارد (برای برنامه‌های وب پشتیبانی نمی‌شود).
پیکربندی تنظیمات برای هر برنامه تلفن همراه
در اینجا نحوه پیکربندی هشدارها برای هر برنامه تلفن همراه در پروژه Firebase شما آورده شده است:
در کنسول Firebase، به صفحه
تنظیمات > هشدارها بروید.به کارت هشدارهای Crashlytics بروید. برنامه تلفن همراهی را که می‌خواهید پیکربندی کنید از منوِ کرکره‌ای انتخاب کنید.
کانال Slack را که می‌خواهید هشدارهای این برنامه به آن ارسال شود انتخاب کنید.
برای هر نوع هشدار، از منو کرکره‌ای انتخاب کنید که آیا می‌خواهید آن نوع هشدار به Slack ارسال شود یا نه.
این مراحل را برای هر برنامه تلفن همراهی که می‌خواهید پیکربندی کنید تکرار کنید.
تمام شد! اگر برنامه‌های تلفن همراهتان مشکلات جدید، پس‌رونده، یا با سرعت فزاینده داشته باشند، Firebase به کانال‌های Slack مشخص‌شده شما هشدار ارسال خواهد کرد.
Jira: راه‌اندازی ادغام با Jira
پس‌از راه‌اندازی ادغام Firebase با Jira، پروژه Firebase شما می‌تواند در پاسخ به رویدادهای گزارش‌شده توسط Crashlytics، مانند مشکلات جدید، پس‌رفت‌کرده، یا با سرعت فزاینده، در پروژه Jira پست کند. همچنین می‌توانید مشکلات تکی Crashlytics را به مشکلات Jira پیوند دهید.
مرحله ۱: آماده‌سازی Jira برای ادغام با Firebase
ایجاد کردن کد API (فقط Jira Cloud)
قبل‌از راه‌اندازی ادغام در Firebase، باید یک توکن API در Jira Cloud تولید کنید.
در کنسول Jira، تنظیمات کدهای API را باز کنید.
روی ایجاد کردن کد API کلیک کنید.
این کد API را در جایی امن ذخیره کنید، زیرا بعداً به آن نیاز خواهید داشت.
ایجاد نوع مشکل «اشکال»
یکپارچه‌سازی Firebase با Jira مشکلاتی با نوع Bug ایجاد می‌کند. باید
این نوع مشکل را در پروژه جیرا خود ایجاد کنید (اگر ازقبل
وجود نداشته باشد).
در کنسول Jira، به تنظیمات پروژه بروید.
روی انواع مشکل کلیک کنید.
روی افزودن نوع مشکل کلیک کنید.
«اشکال» را انتخاب کنید یا آن را به‌صورت دستی وارد کنید.
مرحله ۲: راه‌اندازی ادغام Jira در کنسول Firebase
ادغام Jira را برای Jira Cloud یا Jira Server راه‌اندازی کنید.
Jira Cloud
در کنسول Firebase، به صفحه
تنظیمات > ادغام‌ها بروید.در کارت ادغام Jira، روی نصب کلیک کنید.
روی راه‌اندازی ادغام Jira کلیک کنید.
نشانی وب پروژه Jira را در قالب زیر وارد کنید:
https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEYایمیل ورود به سیستم Jira و کد API خود را وارد کنید.
روی درستی‌سنجی و ذخیره کلیک کنید.
سرور Jira
در کنسول Firebase، به صفحه
تنظیمات > ادغام‌ها بروید.در کارت ادغام Jira، روی نصب کلیک کنید.
روی راه‌اندازی ادغام Jira کلیک کنید.
نشانی وب پروژه Jira را در قالب زیر وارد کنید:
https://SERVER_NAME.com/projects/PROJECT_KEYایمیل ورود به سیستم Jira و کد API خود را وارد کنید.
روی درستی‌سنجی و ذخیره کلیک کنید.
مرحله ۳: پیکربندی تنظیمات هشدار برای Jira
می‌توانید هشدارها را براساس برنامه تلفن همراه و نوع رویداد پیکربندی کنید. برای مثال، می‌توانید هشدارها را در برنامه آزمایشی‌تان خاموش کنید یا هشدارهای مربوط به برنامه‌های تلفن همراه مختلف را به پروژه‌های Jira مختلف هدایت کنید.
انواع رویداد
ادغام Firebase با Jira به شما امکان می‌دهد در پاسخ به انواع رویدادهای زیر هشدار ارسال کنید:
مشکلات مهلک جدید: زمانی فعال می‌شود که برنامه‌تان دچار خرابی یا ANR شود که Crashlytics قبلاً آن را ندیده است.
مشکلات غیرمهلک جدید: زمانی فعال می‌شود که برنامه‌تان مشکل غیرمهلکی را تجربه کند که Crashlytics قبلاً ندیده است.
مشکلات پس‌رفت: زمانی راه‌اندازی می‌شود که برنامه‌تان با خرابی‌ای مواجه شود که قبلاً آن را به‌عنوان بسته‌شده علامت‌گذاری کرده‌اید.
مشکلات پرطرفدار: زمانی فعال می‌شود که مشکلی درحال ظهور یا پرطرفدار شدن باشد (برای برنامه‌های وب پشتیبانی نمی‌شود).
مشکلات با سرعت فزاینده: زمانی راه‌اندازی می‌شود که یک نوع خرابی یا ANR بر درصدی از کاربران در یک دوره ۳۰ دقیقه‌ای برای نسخه برنامه خاصی تأثیر بگذارد (برای برنامه‌های وب پشتیبانی نمی‌شود).
پیکربندی تنظیمات برای هر برنامه تلفن همراه
در اینجا نحوه پیکربندی هشدارها برای هر برنامه تلفن همراه در پروژه Firebase شما آورده شده است:
در کنسول Firebase، به صفحه
تنظیمات > هشدارها بروید.به کارت هشدارهای Crashlytics بروید. برنامه تلفن همراهی را که می‌خواهید پیکربندی کنید از منوِ کرکره‌ای انتخاب کنید.
پروژه Jira را که می‌خواهید هشدارهای این برنامه به آن ارسال شود انتخاب کنید.
برای هر نوع هشدار، از منو کرکره‌ای انتخاب کنید که آیا می‌خواهید آن نوع هشدار را به Jira ارسال کنید یا نه.
این مراحل را برای هر برنامه تلفن همراهی که می‌خواهید پیکربندی کنید تکرار کنید.
تمام شد! اگر برنامه‌های تلفن همراهتان مشکلات جدید، پس‌رفت، یا افزایش سرعت داشته باشند، Firebase به پروژه‌های Jira مشخص‌شده شما هشدار ارسال می‌کند.
(اختیاری) پیوند دادن مشکلات Crashlytics و مشکلات Jira
علاوه‌بر مشکلات Jira که به‌طور خودکار ایجاد می‌شوند و Firebase آن‌ها را ایجاد می‌کند، می‌توانید مشکلات Crashlytics را به مشکلات Jira موجود پیوند دهید. همچنین می‌توانید مشکل جدیدی در Jira از کنسول Firebase ایجاد کنید. قبل‌از استفاده از این ویژگی، باید ادغام Jira را فعال کنید.
به مشکل Crashlytics که می‌خواهید به مشکل Jira پیوند دهید پیمایش کنید.
روی پیوند دادن به Jira کلیک کنید.
روی ایجاد مشکل در پروژه کلیک کنید یا نشانی وب مشکل جیرا یا کلید مشکل را در فیلد ارائه‌شده جای‌گذاری کنید.
لغو پیوند مشکل Crashlytics از مشکل جیرا
به مشکل Crashlytics که می‌خواهید پیوند آن را از Jira لغو کنید پیمایش کنید.
روی مشکل پیوندشده کلیک کنید.
روی بیشتر کلیک کنید و لغو پیوند را انتخاب کنید.
PagerDuty: راه‌اندازی ادغام با PagerDuty
پس‌از راه‌اندازی ادغام Firebase با PagerDuty، پروژه Firebase شما به PagerDuty اجازه می‌دهد تا در پاسخ به رویدادهای گزارش‌شده توسط Crashlytics، مانند مشکلات جدید، پس‌رفت، یا افزایش سرعت، به پاسخ‌دهندگان آماده‌باش شما اطلاع دهد.
مرحله ۱: راه‌اندازی ادغام PagerDuty در کنسول Firebase
در کنسول Firebase، به صفحه
تنظیمات > ادغام‌ها بروید.در کارت ادغام PagerDuty، روی نصب کلیک کنید.
برای راه‌اندازی ادغام، دستورالعمل‌های روی صفحه را دنبال کنید.
روی درستی‌سنجی و ذخیره کلیک کنید.
مرحله ۲: پیکربندی تنظیمات هشدار برای PagerDuty
می‌توانید هشدارها را براساس برنامه تلفن همراه و نوع رویداد پیکربندی کنید. برای مثال، می‌توانید هشدارهای برنامه آزمایشی‌تان را خاموش کنید یا هشدارهای مربوط به برنامه‌های تلفن همراه مختلف را به پروژه‌های PagerDuty مختلف هدایت کنید.
انواع رویداد
ادغام Firebase با PagerDuty به شما امکان می‌دهد در پاسخ به انواع رویدادهای زیر هشدار ارسال کنید:
مشکلات مهلک جدید: زمانی فعال می‌شود که برنامه‌تان دچار خرابی یا ANR شود که Crashlytics قبلاً آن را ندیده است.
مشکلات غیرمهلک جدید: زمانی فعال می‌شود که برنامه‌تان مشکل غیرمهلکی را تجربه کند که Crashlytics قبلاً ندیده است.
مشکلات پس‌رفت: زمانی راه‌اندازی می‌شود که برنامه‌تان با خرابی‌ای مواجه شود که قبلاً آن را به‌عنوان بسته‌شده علامت‌گذاری کرده‌اید.
مشکلات پرطرفدار: زمانی فعال می‌شود که مشکلی درحال ظهور یا پرطرفدار شدن باشد (برای برنامه‌های وب پشتیبانی نمی‌شود).
مشکلات با سرعت فزاینده: زمانی راه‌اندازی می‌شود که یک نوع خرابی یا ANR بر درصدی از کاربران در یک دوره ۳۰ دقیقه‌ای برای نسخه برنامه خاصی تأثیر بگذارد (برای برنامه‌های وب پشتیبانی نمی‌شود).
پیکربندی تنظیمات برای هر برنامه تلفن همراه
در اینجا نحوه پیکربندی هشدارها برای هر برنامه تلفن همراه در پروژه Firebase شما آورده شده است:
در کنسول Firebase، به صفحه
تنظیمات > هشدارها بروید.به کارت هشدارهای Crashlytics بروید. برنامه تلفن همراهی را که می‌خواهید پیکربندی کنید از منوِ کرکره‌ای انتخاب کنید.
سرویس PagerDuty را که می‌خواهید هشدارهای این برنامه به آن ارسال شود انتخاب کنید.
برای هر نوع هشدار، از منو کرکره‌ای انتخاب کنید که آیا می‌خواهید آن نوع هشدار به PagerDuty ارسال شود یا نه.
این مراحل را برای هر برنامه تلفن همراهی که می‌خواهید پیکربندی کنید تکرار کنید.
تمام شد! اگر برنامه‌های تلفن همراهتان مشکلات جدید، پس‌رونده، یا با سرعت فزاینده داشته باشند، Firebase اشکال‌ها را در سرویس PagerDuty مشخص‌شده شما پست خواهد کرد.