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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

دریافت هشدار

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

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

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

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

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

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

برای روشن یا خاموش کردن هشدارهای نظارت بر عملکرد، مراحل زیر را دنبال کنید:

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

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

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

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

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

    1. یک محیط توسعه برای Node.js یا Python تنظیم کنید.
    2. Firebase CLI را نصب کرده و وارد آن شوید.
    3. با استفاده از Firebase CLI، توابع Cloud را برای Firebase راه اندازی کنید.
  2. تابعی را بنویسید و مستقر کنید که یک رویداد هشدار را از مانیتورینگ عملکرد ضبط می کند و بار رویداد را مدیریت می کند (به عنوان مثال، اطلاعات هشدار را در پیامی در Discord پست می کند).

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

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

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

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

اگر یکی از این شرایط برآورده نشد، نظارت بر عملکرد هشدار را حذف می کند.

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

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

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

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

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

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

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

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

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

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

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

  1. به برگه داشبورد نظارت بر عملکرد در کنسول 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 مراجعه کنید.

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

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