از هشدارهای Performance Monitoring استفاده کنید تا اگر تغییرات کد یا درخواست‌های شبکه عملکرد برنامه‌تان را کاهش داد، به اعضای پروژه اطلاع دهید.
می‌توانید هشدارهایی را برای برنامه‌تان راه‌اندازی و سفارشی‌سازی کنید که وقتی عملکرد رویدادی از آستانه تعیین‌شده عبور می‌کند به شما اطلاع می‌دهند.
چه چیزی باعث راه‌اندازی هشدار می‌شود؟
وقتی سنجه‌ای برای برنامه‌تان از آستانه‌ای که برای صدک مشخصی (درصورت وجود) در کنسول Firebase تعریف کرده‌اید عبور کند، هشداری راه‌اندازی می‌شود. هشدارها فقط درصورتی فعال می‌شوند که برنامه‌تان از نسخه کیت توسعه نرم‌افزار سازگار با هم‌زمان استفاده کند.
زمان شروع برنامه
وقتی هشداری برای زمان شروع برنامه پیکربندی می‌کنید، اگر همه شرایط زیر برقرار باشد، هشدار فعال می‌شود:
- Firebase حداقل
۱۰۰ نمونه از ردیابی_app_startرا برای جدیدترین نسخه برنامه‌تان در ساعت گذشته ثبت کرده است. - مدت‌زمان ردیابی
_app_startاز آستانه تعریف‌شده برنامه درطول ساعت گذشته و برای صدک پیکربندی‌شده فراتر رفته است. - قبلاً هیچ هشداری برای همان آستانه در جدیدترین نسخه برنامه‌تان مطرح نشده است.
ردیابی‌های کد سفارشی
وقتی هشداری را برای سنجه ردیابی کد سفارشی پیکربندی می‌کنید، اگر همه شرایط زیر برقرار باشد، هشدار فعال می‌شود:
- Firebase حداقل
۱۰۰ نمونه از ردگیری کد سفارشی را برای جدیدترین نسخه برنامه‌تان در ساعت گذشته ثبت کرده است. - مدت ردیابی از آستانه تعریف‌شده برنامه درطول ساعت گذشته و برای صدک پیکربندی‌شده فراتر رفته است.
- (فقط برای iOS+ و Android) قبلاً هیچ هشداری برای همان آستانه در جدیدترین نسخه برنامه‌تان ایجاد نشده است.
- (فقط برای وب) قبلاً هیچ هشداری برای همان آستانه در
۳ روز گذشته ایجاد نشده است.
درخواست‌های شبکه
وقتی هشداری را برای سنجه درخواست شبکه پیکربندی می‌کنید، اگر همه شرایط زیر برقرار باشد، هشدار راه‌اندازی می‌شود:
- Firebase حداقل
۱۰۰ نمونه را که با الگوی نشانی وب مطابقت داشتند در همه نسخه‌های برنامه‌تان در ساعت گذشته ثبت کرده است. - مقدار انبوهشی سنجه درطول ساعت گذشته از آستانه تعریف‌شده عبور کرد:
- زمان پاسخ: مقدار تجمیعی از آستانه تعیین‌شده برای صدک پیکربندی‌شده فراتر رفت
- نرخ موفقیت: (فقط برای iOS+/Android) مقدار تجمیعی در بین همه کاربران به زیر آستانه تنظیم‌شده رفت
- قبلاً در
۳ روز گذشته هیچ هشداری برای همین آستانه ایجاد نشده است.
پرداز صفحه
وقتی هشداری را برای سنجه پرداز زدن صفحه پیکربندی می‌کنید، اگر همه شرایط زیر برقرار باشد، هشدار راه‌اندازی می‌شود:
- Firebase حداقل
۱۰۰ نمونه از نمونه‌های پرداز صفحه را برای جدیدترین نسخه برنامه‌تان در ساعت گذشته ثبت کرده است. - مقدار انبوهشی سنجه درطول ساعت گذشته از آستانه تعریف‌شده عبور کرد:
- قاب‌های ثابت: مقدار تجمیعی از آستانه تعیین‌شده فراتر رفته است
- فریم‌های آهسته: مقدار تجمیعی از آستانه تعیین‌شده فراتر رفته است
- قبلاً هیچ هشداری برای همان آستانه در جدیدترین نسخه برنامه‌تان مطرح نشده است.
بار کردن صفحه
وقتی هشداری را برای سنجه بار کردن صفحه پیکربندی می‌کنید، اگر همه شرایط زیر برقرار باشد، هشدار فعال می‌شود:
- Firebase حداقل
۱۰۰ نمونه از بار شدن صفحه برای برنامه‌تان در ساعت گذشته ثبت کرده است. - مقدار انبوهشی سنجه درطول ساعت گذشته و برای صدک پیکربندی‌شده از آستانه تعریف‌شده عبور کرد:
- تأخیر ورودی اول: مقدار تجمیعی از آستانه تعیین‌شده و صدک پیکربندی‌شده فراتر رفته است
- اولین نقاشی دارای محتوا: مقدار انبوهشی از آستانه تنظیم‌شده و صدک پیکربندی‌شده فراتر رفته است
- اولین رنگ: مقدار انبوهشی از آستانه تعیین‌شده و صدک پیکربندی‌شده فراتر رفت
- قبلاً در
۳ روز گذشته هیچ هشداری برای همین آستانه ایجاد نشده است.
درباره پیکربندی هشدارها، صدک‌های پیش‌فرض، و روال‌های مطلوب برای راه‌اندازی هشدارها برای انواع خاصی از ردگیری‌ها و سنجه‌ها بیشتر بدانید.
هشدارهای مربوط به دیگر سنجه‌های عملکرد یا ادغام‌های پیکربندی‌شده کنسول Firebase با Slack، Jira، یا PagerDuty برای هشدارهای Performance Monitoring دردسترس نیست.
دریافت هشدارها
دریافت هشدارهای پیش‌فرض
به‌طور پیش‌فرض، Firebase می‌تواند هشدارهای Performance Monitoring را ازطریق ایمیل ارسال کند.
برای دریافت هشدارهای Performance Monitoring ازطریق این سازوکار پیش‌فرض، باید
اجازه firebaseperformance.config.update را داشته باشید. نقش‌های زیر به‌طور پیش‌فرض شامل این
اجازه الزامی است:
هشدارها و تنظیمات آن‌ها در سطح پروژه است. این یعنی به‌طور پیش‌فرض، هر عضو پروژه وقتی هشدار عملکردی راه‌اندازی شود ایمیلی دریافت خواهد کرد. هشدارها فقط به اعضای پروژه که اجازه‌های لازم برای دریافت هشدار را دارند و به نشانی‌های ایمیل فردی (نه به گروه‌های حساب مثل گروه‌های Google یا حساب‌های Google Workspace) ارسال می‌شود.
روشن/ خاموش کردن هشدارها برای حساب خودتان
برای حساب خودتان، می‌توانید هشدارهای Performance Monitoring را بدون تأثیر گذاشتن بر دیگر اعضای پروژه روشن/خاموش کنید. توجه داشته باشید که همچنان برای دریافت هشدارها به اجازه‌های لازم نیاز دارید.
برای روشن یا خاموش کردن هشدارهای Performance Monitoring، این مراحل را دنبال کنید:
- در کنسول Firebase، در گوشه بالا، به
هشدارهای Firebase بروید. - سپس به
تنظیمات بروید و اولویت حسابتان را برای هشدارهای Performance Monitoring تنظیم کنید.
راه‌اندازی هشدار پیشرفته برای سرویس‌های طرف سوم
همچنین می‌توانید بااستفاده از Cloud Functions for Firebase، هشدارهای Performance Monitoring را به کانال اعلان ترجیحی تیمتان ارسال کنید. برای مثال، می‌توانید تابعی بنویسید که رویداد هشدار را برای زمان شروع کند برنامه ضبط کند و اطلاعات هشدار را در سرویس طرف سومی مثل Discord، Slack، یا Jira پست کند.
برای راه‌اندازی قابلیت‌های هشدار پیشرفته بااستفاده از Cloud Functions for Firebase، این مراحل را دنبال کنید:
راه‌اندازی کردن Cloud Functions برای Firebase، که شامل تکالیف زیر می‌شود:
- محیط توسعه نرم‌افزار برای Node.js یا Python راه‌اندازی کنید.
- Firebase CLI را نصب کنید و به سیستم آن وارد شوید.
- Cloud Functions for Firebase را بااستفاده از Firebase CLI مقداردهی اولیه کنید.
تابعی بنویسید و مستقر کنید که رویداد هشدار را از Performance Monitoring ضبط کند و بار داده رویداد را مدیریت کند (برای مثال، اطلاعات هشدار را در پیامی در Discord پست کند).
برای آشنایی با همه رویدادهای هشدار عملکردی که می‌توانید ضبط کنید، به اسناد مرجع هشدارهای «پایش عملکرد» بروید.
برداشتن خودکار هشدارهای نامعتبر
Performance Monitoring هشدارها را درستی‌سنجی می‌کند تا مطمئن شود داده‌ها معتبر هستند و هشدارها درحال استفاده فعال هستند. هشدارها درصورت درست بودن یکی از موارد زیر معتبر درنظر گرفته می‌شوند:
- هشدار برای «شناسه منبعی» ایجاد شده است که Performance Monitoring در ۹۰ روز گذشته برای آن داده دریافت کرده است.
- هشدار اخیراً برای الگوی نشانی وب سفارشی ایجاد شده است. پس‌از ایجاد الگوی نشانی وب سفارشی و راه‌اندازی هشدار، ۹۰ روز فرصت دارید تا داده‌های مربوط به آن الگو را ارسال کنید. اگر هیچ داده‌ای در دوره زمانی ۹۰ روزه ارسال نشود، Performance Monitoring آن هشدار را برمی‌دارد. برای اطلاعات بیشتر درباره الگوهای نشانی وب سفارشی، داده‌های تجمیعی تحت الگوهای نشانی وب مشتری را ببینید.
اگر هریک از این شرایط برآورده نشود، Performance Monitoring هشدار را برمی‌دارد.
پیکربندی هشدار
برای پیکربندی هشدارهای Performance Monitoring، باید
اجازه firebaseperformance.config.update را داشته باشید. نقش‌های زیر به‌طور پیش‌فرض شامل این
اجازه لازم هستند:
سرپرست عملکرد Firebase،
سرپرست کیفیت Firebase،
سرپرست Firebase،
و مالک یا ویرایشگر پروژه.
اگر قبلاً این کار را نکرده‌اید، جدیدترین کیت توسعه نرم‌افزار Performance Monitoring را به برنامه‌تان اضافه کنید. برای اطلاعات بیشتر، راهنماهای شروع به کار برای پلاتفرم‌های وب، Android، Apple، و Flutter را ببینید.
در هریک از برنامه‌های ثبت‌شده‌تان، از جدول ردگیری‌ها یا کارت گزارش داشبورد برای پیکربندی هشدار برای هر سنجه‌ای که می‌خواهید پایش کنید استفاده کنید. هر برنامه می‌تواند مجموعه متفاوتی از هشدارها را داشته باشد که هرکدام آستانه متفاوتی دارند (یا اصلاً هشداری نداشته باشند).
پیکربندی هشدار در جدول «ردیابی‌ها»
به برگه Performance Monitoring داشبورد در کنسول Firebase بروید و سپس برنامه‌ای را که می‌خواهید هشدار برای آن پیکربندی کنید انتخاب کنید.
به پایین صفحه و جدول «ردیابی‌ها» پیمایش کنید.
برگه نوع ردیابی را که می‌خواهید برای آن هشدار تنظیم کنید انتخاب کنید، و سپس ردیف مربوطه را پیدا کنید.
در منتهی‌الیه سمت چپ ردیف، «منو سرریز» () را باز کنید و تنظیمات هشدار را انتخاب کنید.
دستورالعمل‌های روی صفحه را برای تنظیم آستانه هشدار و صدک (درصورت وجود) برای برنامه، یا برای روشن/خاموش کردن هشدار دنبال کنید. صدک‌های پیش‌فرض برای Android و iOS نودم و برای وب هفتادوپنجم است. برای کسب اطلاعات بیشتر درباره صدک‌های پیش‌فرض، به پیگیری سنجه‌های کلیدی در داشبورد مراجعه کنید.
پیکربندی هشدار در کارت گزارش «داشبورد»
به برگه Performance Monitoring داشبورد در کنسول Firebase بروید و سپس برنامه‌ای را که می‌خواهید هشدار برای آن پیکربندی کنید انتخاب کنید.
در برگه «کارت گزارش»، کارت سنجه‌ای را که می‌خواهید برای آن هشدار پیکربندی کنید پیدا کنید.
در کارت سنجه موردنظر، «منوِ سرریز» () را باز کنید و تنظیمات هشدار را انتخاب کنید.
دستورالعمل‌های روی صفحه را برای تنظیم آستانه هشدار و صدک (درصورت وجود) برای برنامه، یا برای روشن/خاموش کردن هشدار دنبال کنید. صدک‌های پیش‌فرض برای Android و iOS نودم و برای وب هفتادوپنجم است. برای کسب اطلاعات بیشتر درباره صدک‌های پیش‌فرض، به پیگیری سنجه‌های کلیدی در داشبورد مراجعه کنید.
روال‌های مطلوب برای تنظیم هشدار عملکرد
درخواست‌های شبکه
Firebase داده‌های درخواست‌های شبکه مشابه را تحت الگوهای نشانی وب جمع‌آوری می‌کند، که می‌تواند یکی از موارد زیر باشد:
الگوهای تعریف‌شده توسط کاربر که الگوهای نشانی وب سفارشی نامیده می‌شوند.
الگوهای مشتق‌شده از Firebase که الگوهای نشانی وب خودکار نامیده می‌شوند.
این الگوها ممکن است درطول زمان براساس جدیدترین رفتار استفاده از برنامه‌تان تغییر کند.
تنظیم هشدار برای الگوهای نشانی وب سفارشی
توصیه می‌کنیم برای هر الگوی نشانی وب سفارشی که پیکربندی کرده‌اید، هشدار تنظیم کنید. ازآنجایی‌که Firebase ابتدا تلاش می‌کند درخواست را با الگوی نشانی وب سفارشی مطابقت دهد، درخواست‌های مشابه به‌طور سازگارتری با همان الگوی نشانی وب نگاشت می‌شوند. این کار باعث می‌شود هشدارهای مربوط به الگوی نشانی وب سفارشی برای تیمتان معنی‌دارتر و مؤثرتر باشد، زیرا قبلاً آن الگوی خاص درخواست‌ها را به‌عنوان الگویی مهم برای برنامه‌تان شناسایی کرده‌اید.
تنظیم هشدار برای الگوهای نشانی وب خودکار
هنگام تنظیم هشدار برای الگوی نشانی وب خودکار، مطمئن شوید که الگوی نشانی وب خودکار برای چند روز پایدار بوده است. به‌یاد داشته باشید که الگوهای نشانی وب خودکار ممکن است درطول زمان تغییر کنند و پیکربندی‌های هشدار به الگوهای نشانی وب جدید منتقل نمی‌شوند. این امر می‌تواند منجر به هشدارهای نادرست یا ناقص برای الگوهایی شود که برایتان مهم است. همچنین می‌توانید الگوی نشانی وب سفارشی ایجاد کنید تا مطمئن شوید این الگو پایدار است.
صفحه وب بار می‌شود
برای آشنایی با آستانه‌های توصیه‌شده برای اندازه‌گیری سنجه‌های وب، به سند معیارهای کلیدی اصلی وب مراجعه کنید.
پرداخت‌های صفحه‌نمایش
برای اطمینان از تجربه بهینه برنامه، جلسه‌های کاربر باید عاری از فریم‌های کند و ثابت باشد. Performance Monitoring توصیه می‌کند برای قاب‌های ثابت بیشتر از ۱٪ هشدار تنظیم کنید و برای قاب‌های کند بیشتر از ۵٪ هشدار تنظیم کنید. خواهید دید که این مقادیر به‌عنوان تنظیمات پیش‌فرض درطول پیکربندی هشدار عملکرد وجود دارند. برای کسب اطلاعات بیشتر درباره قاب‌های ثابت یا کند بیش‌ازحد و دیگر روال‌های مطلوب عملکرد برنامه، به راهنمای Google Play مراجعه کنید.