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

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

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

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

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

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

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

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

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

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

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

• مدیر عملکرد فایربیس
• مدیر کیفیت فایربیس
• مدیر فایربیس
• صاحب یا ویراستار پروژه

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

اگر هنوز این کار را انجام نداده‌اید، جدیدترین SDK Performance Monitoring به برنامه خود اضافه کنید. برای اطلاعات بیشتر، به راهنماهای شروع به کار برای پلتفرم‌های وب ، اندروید ، اپل و فلاتر مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بارگذاری صفحات وب

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

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

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