از هشدارهای سرعت استفاده کنید تا تیم خود را در صورت ایجاد مشکلی فوری در برنامه شما به تیم خود اطلاع دهید. برای Crashlytics ، یک مشکل گروهبندی خرابیهای مشابه یا رویدادهای برنامهای که پاسخ نمیدهد (ANR) است.
چه چیزی باعث ایجاد هشدار می شود؟
هشدارهای سرعت زمانی فعال می شوند که مشکلی در برنامه شما از آستانه های خاصی که در کنسول Firebase پیکربندی کرده اید عبور کند.
شما آستانه هشدارهای سرعت را بر حسب درصدی از کاربران و حداقل تعداد کاربرانی که تحت تأثیر خرابی یا ANR قرار گرفتهاند، تعریف میکنید. می توانید مقدار آستانه درصد را بین 0٪ تا 100٪ جلسات تنظیم کنید. حداقل آستانه کاربران را می توان روی هر عددی بزرگتر یا مساوی 10 تنظیم کرد. به طور پیش فرض، آستانه هشدار سرعت در 1٪ از جلسات و 25 کاربر تنظیم شده است.
به طور خاص، اگر در طول یک بازه زمانی 30 دقیقهای، همه موارد زیر درست باشند، یک هشدار فعال میشود:
- یک مشکل در یک برنامه از آستانه درصد تعریف شده فراتر می رود و از حداقل کاربران تعیین شده برای آن برنامه بیشتر است.
- این برنامه حداقل 10 کاربر در آن بازه زمانی دارد.
- قبلاً هیچ هشداری برای این مشکل در برنامه در آن نسخه ارائه نشده بود.
آستانه های هشدار سرعت را پیکربندی کنید
برای پیکربندی آستانه های هشدار سرعت، باید مجوز firebasecrashlytics.config.update
را داشته باشید. نقشهای زیر بهطور پیشفرض شامل این مجوز لازم میشوند: Firebase Crashlytics Admin ، Firebase Quality Admin ، Firebase Admin ، یا Project Owner یا Editor .
آستانه های هشدار سرعت را برای هر یک از برنامه های ثبت شده خود پیکربندی کنید. هر برنامه می تواند آستانه هشدار متفاوتی داشته باشد.
وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.
روی تب Alerts را انتخاب کنید.
کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.به کارت هشدارهای Crashlytics بروید و تب Velocity Alerts را انتخاب کنید.
آستانه های هشدار را برای برنامه پیکربندی کنید.
دریافت هشدار
دریافت هشدارهای پیش فرض
به طور پیش فرض، Firebase می تواند هشدارهای Crashlytics را با استفاده از ایمیل ارسال کند. برای هشدارهای سرعت و رگرسیون، Firebase همچنین میتواند این هشدارها را در کنسول Firebase نشان دهد.
برای دریافت هشدارهای Crashlytics با استفاده از این مکانیسم پیشفرض، باید مجوز firebase.projects.update
را داشته باشید. نقشهای زیر بهطور پیشفرض شامل این مجوز مورد نیاز است: مدیر Firebase یا مالک پروژه یا ویرایشگر .
بهطور پیشفرض، هر عضو پروژه (که مجوزهای لازم برای دریافت هشدارها را دارد) زمانی که یک هشدار از Crashlytics فعال میشود، ایمیلی دریافت میکند.
هشدارها را برای حساب شخصی خود روشن یا خاموش کنید
برای حساب شخصی خود، میتوانید هشدارهای Crashlytics را بدون تأثیرگذاری بر دیگر اعضای پروژه روشن یا خاموش کنید. توجه داشته باشید که برای دریافت هشدارها همچنان به مجوزهای لازم نیاز دارید.
وارد کنسول Firebase شوید، سپس پروژه خود را انتخاب کنید.
روی تب Alerts را انتخاب کنید.
کلیک کنید، سپس تنظیمات پروژه را انتخاب کنید.به کارت هشدارهای Crashlytics بروید و تب Velocity Alerts را انتخاب کنید.
اولویت حساب خود را برای هشدارهای Crashlytics تنظیم کنید.
هشدار اولیه را برای خدمات شخص ثالث تنظیم کنید
برای هشدارهای Crashlytics ، Firebase مکانیزمی برای ارسال هشدار به سرویسهای شخص ثالث زیر ارائه میکند: Slack ، Jira ، یا PagerDuty .
این گزینههای هشدار اولیه را با استفاده از گردشهای کاری هدایتشده در برگه ادغام در خود تنظیم کنید
پیکربندی مورد استفاده برای هر برنامه را انتخاب کنید و مقصد سایر هشدارها را در کارت Crashlytics در برگه Alerts پیکربندی کنید.
توجه داشته باشید که اگر کنترل و سفارشیسازی بیشتری برای ارسال هشدارها به هر سرویس شخص ثالث میخواهید (فقط به Slack، Jira یا PagerDuty محدود نمیشود)، بخش تنظیم هشدار پیشرفته برای خدمات شخص ثالث را بررسی کنید که گزینههای هشدار پیشرفته را توضیح میدهد.
هشدار پیشرفته را برای خدمات شخص ثالث تنظیم کنید
میتوانید با استفاده از Cloud Functions for Firebase ، هشدارهای Crashlytics را به کانال اعلان ترجیحی تیمتان ارسال کنید. برای مثال، میتوانید تابعی بنویسید که یک رویداد هشدار را برای هشدارهای سرعت ثبت میکند و اطلاعات هشدار را به یک سرویس شخص ثالث، مانند Discord، Slack یا Jira ارسال میکند. با استفاده از این مکانیسم هشدار پیشرفته، می توانید اطلاعات ارسال شده به سرویس شخص ثالث را به طور کامل سفارشی کنید. برای مثال، میتوانید پیوندهای عمیق مفیدی را به کنسول Firebase اضافه کنید یا اطلاعات مربوط به عیبیابی شرکت را اضافه کنید.
برای راهاندازی قابلیتهای هشدار پیشرفته با استفاده از Cloud Functions for Firebase ، این مراحل را دنبال کنید:
Cloud Functions را برای Firebase تنظیم کنید که شامل وظایف زیر است:
- یک محیط توسعه برای Node.js یا Python تنظیم کنید.
- Firebase CLI را نصب کرده و وارد آن شوید.
- با استفاده از Firebase CLI Cloud Functions for Firebase راه اندازی کنید.
تابعی را بنویسید و مستقر کنید که یک رویداد هشدار را از Crashlytics می گیرد و بار رویداد را مدیریت می کند (به عنوان مثال، اطلاعات هشدار را در پیامی در Discord پست می کند).
برای اطلاع از همه رویدادهای هشدار Crashlytics که میتوانید ثبت کنید، به مستندات مرجع هشدارهای Crashlytics بروید.