برای مشکلات عملکرد هشدارها را تنظیم کنید

از هشدارهای Performance Monitoring برای اطلاع اعضای پروژه در صورتی که تغییرات کد یا درخواست های شبکه باعث کاهش عملکرد برنامه شما می شود، استفاده کنید.

می‌توانید هشدارهایی را برای برنامه خود تنظیم و سفارشی کنید، که وقتی عملکرد یک رویداد از آستانه تعیین شده عبور کرد به شما اطلاع می‌دهند.

چه چیزی باعث ایجاد هشدار می شود؟

زمانی که معیاری برای برنامه شما از آستانه ای که برای یک صدک مشخص (در صورت وجود) در کنسول Firebase تعریف کرده اید، عبور می کند، یک هشدار فعال می شود. هشدارها فقط در صورتی فعال می‌شوند که برنامه شما از نسخه SDK سازگار هم‌زمان استفاده کند.

زمان شروع برنامه

وقتی یک هشدار را برای زمان شروع برنامه پیکربندی می‌کنید، در صورتی که همه شرایط زیر درست باشد، هشدار فعال می‌شود:

• Firebase حداقل 100 نمونه از ردیابی _app_start را برای آخرین نسخه برنامه شما در یک ساعت گذشته ثبت کرده است.
• مدت زمان ردیابی _app_start از آستانه تعریف شده برنامه در ساعت گذشته و برای صدک پیکربندی شده فراتر رفت.
• قبلاً هیچ هشداری برای همان آستانه در آخرین نسخه برنامه شما اعلام نشده بود.

توجه: به‌طور پیش‌فرض، هر برنامه برای هشدار زمان شروع برنامه انتخاب شده است و آستانه پیش‌فرض 5 ثانیه در صدک 90 است.

ردیابی کد سفارشی

وقتی یک هشدار را برای متریک ردیابی کد سفارشی پیکربندی می‌کنید، در صورتی که همه شرایط زیر درست باشد، هشدار فعال می‌شود:

• Firebase حداقل 100 نمونه از ردیابی کد سفارشی را برای آخرین نسخه برنامه شما در یک ساعت گذشته ضبط کرده است.
• مدت زمان ردیابی از آستانه تعریف شده برنامه در ساعت گذشته و برای صدک پیکربندی شده فراتر رفت.
• (فقط برای iOS+ و Android) قبلاً هیچ هشداری برای همان آستانه در آخرین نسخه برنامه شما اعلام نشده بود.
• (فقط برای وب) هیچ هشداری قبلاً برای همان آستانه در 3 روز گذشته اعلام نشده بود.

درخواست های شبکه

هنگامی که یک هشدار را برای متریک درخواست شبکه پیکربندی می‌کنید، در صورتی که همه شرایط زیر درست باشد، هشدار فعال می‌شود:

• Firebase حداقل 100 نمونه را ثبت کرد که با الگوی URL در همه نسخه‌های برنامه شما در یک ساعت گذشته مطابقت داشتند.
• مقدار تجمیع متریک از آستانه تعریف شده در ساعت گذشته عبور کرد:
  • زمان پاسخ : مقدار تجمیع شده از آستانه تعیین شده برای صدک پیکربندی شده فراتر رفت
  • میزان موفقیت : (فقط برای iOS+/Android) مقدار جمع‌آوری شده از آستانه تعیین‌شده برای همه کاربران کمتر شد
• قبلاً هیچ هشداری برای همان آستانه در 3 روز گذشته اعلام نشده بود.

رندر صفحه نمایش

هنگامی که یک هشدار را برای یک متریک نمایش صفحه پیکربندی می‌کنید، در صورتی که همه شرایط زیر درست باشد، هشدار فعال می‌شود:

• Firebase حداقل 100 نمونه از رندر صفحه نمایش را برای آخرین نسخه برنامه شما در یک ساعت گذشته ضبط کرده است.
• مقدار تجمیع متریک از آستانه تعریف شده در ساعت گذشته عبور کرد:
  • فریم های منجمد : مقدار جمع شده از آستانه تعیین شده فراتر رفت
  • فریم های آهسته : مقدار تجمیع شده از آستانه تعیین شده فراتر رفته است
• قبلاً هیچ هشداری برای همان آستانه در آخرین نسخه برنامه شما اعلام نشده بود.

صفحه بارگیری می شود

وقتی یک هشدار را برای معیار بارگذاری صفحه پیکربندی می‌کنید، در صورتی که همه شرایط زیر درست باشد، هشدار فعال می‌شود:

• Firebase حداقل 100 نمونه از بارگیری صفحه را برای برنامه شما در یک ساعت گذشته ضبط کرده است.
• مقدار تجمیع متریک از آستانه تعریف شده در آخرین ساعت و برای صدک پیکربندی شده عبور کرد:
  • تاخیر ورودی اول : مقدار تجمیع شده از آستانه تنظیم شده و صدک پیکربندی شده فراتر رفت
  • اولین رنگ محتوایی : مقدار تجمیع شده از آستانه تنظیم شده و صدک پیکربندی شده فراتر رفت
  • اولین رنگ : مقدار تجمیع شده از آستانه تنظیم شده و صدک پیکربندی شده فراتر رفته است
• قبلاً هیچ هشداری برای همان آستانه در 3 روز گذشته اعلام نشده بود.

درباره پیکربندی هشدارها ، صدک‌های پیش‌فرض و بهترین روش‌ها برای تنظیم هشدارها برای انواع خاصی از ردیابی‌ها و معیارها بیشتر بیاموزید.

هشدار برای سایر معیارهای عملکرد یا ادغام های Firebase داخلی با Slack ، Jira ، و PagerDuty برای هشدارهای Performance Monitoring در دسترس نیست.

دریافت هشدار

دریافت هشدارهای پیش فرض

به طور پیش فرض، Firebase می تواند هشدارهای Performance Monitoring از طریق ایمیل ارسال کند.

برای دریافت هشدارهای Performance Monitoring از طریق این مکانیسم پیش‌فرض، باید مجوز firebaseperformance.config.update را داشته باشید. نقش‌های زیر به‌طور پیش‌فرض شامل این مجوز مورد نیاز است:

• Firebase Performance Admin
• مدیریت کیفیت Firebase
• Firebase Admin
• صاحب پروژه یا ویرایشگر

هشدارها و تنظیمات آنها در کل پروژه است. این بدان معنی است که، به طور پیش فرض، هر عضو پروژه با فعال شدن یک هشدار عملکرد یک ایمیل دریافت می کند. هشدارها فقط برای اعضای پروژه با مجوزهای لازم برای دریافت هشدارها و به آدرس‌های ایمیل فردی (نه به گروه‌بندی حساب‌هایی مانند گروه‌های Google یا حساب‌های Google Workspace) ارسال می‌شوند.

هشدارها را برای حساب شخصی خود روشن/خاموش کنید

برای حساب شخصی خود، می‌توانید هشدارهای Performance Monitoring را بدون تأثیرگذاری بر دیگر اعضای پروژه روشن/خاموش کنید. توجه داشته باشید که برای دریافت هشدارها همچنان به مجوزهای لازم نیاز دارید.

برای روشن یا خاموش کردن هشدارهای Performance Monitoring ، مراحل زیر را دنبال کنید:

1. در کنسول Firebase ، در گوشه بالا سمت راست، به هشدارهای Firebase .
2. سپس، به تنظیمات و اولویت حساب خود را برای هشدارهای Performance Monitoring تنظیم کنید.

هشدار پیشرفته را برای خدمات شخص ثالث تنظیم کنید

همچنین می‌توانید با استفاده از Cloud Functions for Firebase ، هشدارهای Performance Monitoring به کانال اعلان ترجیحی تیم خود ارسال کنید. به عنوان مثال، می‌توانید تابعی بنویسید که یک رویداد هشدار را برای زمان شروع کند برنامه ضبط می‌کند و اطلاعات هشدار را به یک سرویس شخص ثالث، مانند Discord، Slack، یا Jira پست می‌کند.

توجه: برای استفاده از قابلیت‌های هشدار پیشرفته، پروژه Firebase شما باید از طرح قیمت‌گذاری Blaze استفاده کند.

برای راه‌اندازی قابلیت‌های هشدار پیشرفته با استفاده از Cloud Functions for Firebase ، این مراحل را دنبال کنید:

1. Cloud Functions را برای Firebase تنظیم کنید که شامل وظایف زیر است:

   1. یک محیط توسعه برای Node.js یا Python تنظیم کنید.
   2. Firebase CLI را نصب کرده و وارد آن شوید.
   3. با استفاده از Firebase CLI، Cloud Functions for Firebase راه اندازی کنید.

2. تابعی را بنویسید و مستقر کنید که یک رویداد هشدار را از Performance Monitoring ضبط می کند و بار رویداد را مدیریت می کند (به عنوان مثال، اطلاعات هشدار را در پیامی در Discord پست می کند).

برای اطلاع از همه رویدادهای هشدار عملکرد که می‌توانید ضبط کنید، به مستندات مرجع هشدارهای نظارت بر عملکرد بروید.

حذف خودکار هشدارهای نامعتبر

Performance Monitoring هشدارها را تأیید می کند تا اطمینان حاصل شود که داده ها معتبر هستند و هشدارها در حال استفاده فعال هستند. اگر یکی از موارد زیر درست باشد، هشدارها معتبر تلقی می شوند:

• این هشدار برای شناسه منبعی ایجاد می شود که Performance Monitoring آن داده ها را در 90 روز گذشته دریافت کرده است.
• هشدار اخیراً برای یک الگوی URL سفارشی ایجاد شده است. پس از ایجاد یک الگوی URL سفارشی و تنظیم یک هشدار، 90 روز فرصت دارید تا داده های آن الگو را ارسال کنید. اگر هیچ داده ای در بازه زمانی 90 روزه ارسال نشود، Performance Monitoring آن هشدار را حذف می کند. برای اطلاعات بیشتر در مورد الگوهای URL سفارشی، به جمع آوری داده ها در زیر الگوهای URL مشتری مراجعه کنید.

اگر یکی از این شرایط برآورده نشد، Performance Monitoring هشدار را حذف می کند.

یک هشدار را پیکربندی کنید

برای پیکربندی هشدارهای Performance Monitoring ، باید مجوز firebaseperformance.config.update را داشته باشید. نقش‌های زیر به‌طور پیش‌فرض شامل این مجوز لازم می‌شوند: Firebase Performance Admin ، Firebase Quality Admin ، Firebase Admin ، و Project Owner یا Editor .

اگر قبلاً این کار را نکرده‌اید، آخرین SDK Performance Monitoring به برنامه خود اضافه کنید. برای اطلاعات بیشتر، به راهنمای شروع برای پلتفرم‌های وب ، Android ، Apple و Flutter مراجعه کنید.

مهم: هشدارها و پیکربندی‌های آنها در سطح پروژه هستند، به این معنی که هر تغییری بر پیکربندی هشدار برای همه اعضای پروژه که هشدارهای Performance Monitoring دریافت می‌کنند، تأثیر می‌گذارد.

در هر یک از برنامه‌های ثبت‌شده خود، از جدول Traces یا کارت گزارش داشبورد برای پیکربندی هشدار برای هر معیاری که می‌خواهید نظارت کنید، استفاده کنید. هر برنامه می‌تواند مجموعه‌ای از هشدارها را داشته باشد که هر کدام آستانه متفاوتی دارند (یا اصلاً هیچ هشداری ندارند).

یک هشدار را در جدول Traces پیکربندی کنید

1. به برگه داشبورد Performance Monitoring در کنسول Firebase بروید و سپس برنامه ای را که می خواهید یک هشدار را برای آن پیکربندی کنید انتخاب کنید.

2. به جدول Traces در پایین صفحه بروید.

3. برگه ای از نوع ردیابی را که می خواهید برای آن هشدار تنظیم کنید، انتخاب کنید و سپس ردیف مربوطه را پیدا کنید.

   توجه: ردیابی _app_start در تب Custom Traces قرار دارد.

4. در سمت راست انتهای ردیف، منوی سرریز ( ) را باز کنید و تنظیمات هشدار را انتخاب کنید.

5. دستورالعمل های روی صفحه را دنبال کنید تا آستانه هشدار و صدک (در صورت وجود) را برای برنامه تنظیم کنید یا هشدار را روشن/خاموش کنید. صدک های پیش فرض برای اندروید و iOS 90 و برای وب 75 هستند. برای کسب اطلاعات بیشتر در مورد صدک های پیش فرض، به ردیابی معیارهای کلیدی در داشبورد خود مراجعه کنید.

   توجه: پیکربندی صدک برای میزان موفقیت، فریم‌های ثابت یا فریم‌های آهسته قابل اعمال نیست زیرا این معیارها درصد هستند.

یک هشدار را در کارت گزارش داشبورد پیکربندی کنید

1. به برگه داشبورد Performance Monitoring در کنسول Firebase بروید و سپس برنامه ای را که می خواهید یک هشدار را برای آن پیکربندی کنید انتخاب کنید.

2. در برگه گزارش کارت، کارت متریکی را که می‌خواهید یک هشدار را برای آن پیکربندی کنید، پیدا کنید.

3. در کارت متریک مورد نظر، منوی سرریز ( ) را باز کنید و تنظیمات هشدار را انتخاب کنید.

4. دستورالعمل های روی صفحه را دنبال کنید تا آستانه هشدار و صدک (در صورت وجود) را برای برنامه تنظیم کنید یا هشدار را روشن/خاموش کنید. صدک های پیش فرض برای اندروید و iOS 90 و برای وب 75 هستند. برای کسب اطلاعات بیشتر در مورد صدک های پیش فرض، به ردیابی معیارهای کلیدی در داشبورد خود مراجعه کنید.

   توجه: پیکربندی صدک برای میزان موفقیت، فریم‌های ثابت و فریم‌های آهسته قابل اعمال نیست زیرا این معیارها درصد هستند.

بهترین روش ها برای تنظیم یک هشدار عملکرد

درخواست های شبکه

Firebase داده‌های درخواست‌های شبکه مشابه را تحت الگوهای URL جمع‌آوری می‌کند که می‌تواند یکی از موارد زیر باشد:

• الگوهای تعریف شده توسط کاربر، که الگوهای URL سفارشی نامیده می شوند.

• الگوهای مشتق شده از Firebase که الگوهای URL خودکار نامیده می شوند.
  این الگوها ممکن است در طول زمان بر اساس آخرین رفتار استفاده برنامه شما تغییر کنند.

هشدارهایی را برای الگوهای URL سفارشی خود تنظیم کنید

توصیه می کنیم برای هر الگوی URL سفارشی که پیکربندی کرده اید، هشدارها را تنظیم کنید. از آنجایی که Firebase ابتدا تلاش می‌کند یک درخواست را با یک الگوی URL سفارشی مطابقت دهد، درخواست‌های مشابه به طور مداوم به همان الگوی URL نگاشت می‌شوند. این باعث می‌شود هشدارها برای یک الگوی URL سفارشی برای تیم شما معنی‌دارتر و موثرتر باشد، زیرا قبلاً آن الگوی خاص درخواست‌ها را برای برنامه‌تان مهم تشخیص داده‌اید.

هشدارها را برای الگوهای URL خودکار تنظیم کنید

هنگام تنظیم یک هشدار برای الگوی URL خودکار، مطمئن شوید که الگوی URL خودکار برای چند روز تثبیت شده است. به خاطر داشته باشید که الگوهای URL خودکار ممکن است در طول زمان تغییر کنند و تنظیمات هشدار به الگوهای URL جدید منتقل نمی شود. این می تواند منجر به هشدارهای نادرست یا گم شده برای الگوهای مورد علاقه شما شود. همچنین می‌توانید برای اطمینان از پایداری این الگو، یک الگوی URL سفارشی ایجاد کنید.

صفحه وب بارگیری می شود

برای یادگیری آستانه های توصیه شده برای اندازه گیری معیارهای وب، به مستندات Core Web Vitals مراجعه کنید.

رندرهای صفحه نمایش

برای اطمینان از تجربه بهینه برنامه، جلسات کاربر باید عاری از فریم های کند و ثابت باشد. Performance Monitoring توصیه می‌کند که هشدارهایی را برای فریم‌های ثابت بیش از 1٪ تنظیم کنید و برای فریم‌های آهسته بیش از 5٪ هشدارها را تنظیم کنید. متوجه خواهید شد که این مقادیر به عنوان تنظیمات پیش فرض در هنگام پیکربندی هشدار عملکرد وجود دارند. برای کسب اطلاعات بیشتر در مورد فریم‌های آهسته یا ثابت و سایر بهترین روش‌های عملکرد برنامه، به راهنمای Google Play مراجعه کنید.