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