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

iOS+ اندروید وب

این صفحه نکات عیب‌یابی برای شروع کار با Performance Monitoring یا استفاده از ویژگی‌ها و ابزارهای Performance Monitoring را ارائه می‌دهد.

بررسی‌های اولیه برای عیب‌یابی

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

۱. پیام‌های لاگ را برای رویدادهای عملکردی بررسی کنید

پیام‌های لاگ خود را بررسی کنید تا مطمئن شوید که SDK Performance Monitoring ، رویدادهای عملکردی را ثبت می‌کند.

نحوه مشاهده پیام‌های لاگ برای رویدادهای عملکردی

1. ابزارهای توسعه‌دهنده مرورگر خود را باز کنید (برای مثال، تب Network برای Chrome Dev Tools یا در Network Monitor برای Firefox ).

2. برنامه وب خود را در مرورگر رفرش کنید.

3. پیام‌های لاگ خود را برای هرگونه پیام خطا بررسی کنید.

4. بعد از چند ثانیه، در ابزارهای توسعه‌دهندگان مرورگر خود، به دنبال فراخوانی شبکه‌ای به آدرس firebaselogging.googleapis.com بگردید. وجود این فراخوانی شبکه نشان می‌دهد که مرورگر در حال ارسال داده‌های عملکرد به Firebase است.

اگر برنامه شما رویدادهای عملکرد را ثبت نمی‌کند، نکات عیب‌یابی را مرور کنید.

۲. داشبورد وضعیت فایربیس را بررسی کنید

در صورت وجود قطعی شناخته‌شده برای Firebase یا برای Performance Monitoring داشبورد وضعیت Firebase را بررسی کنید.

شروع کار با Performance Monitoring

اگر تازه کار با Performance Monitoring ( iOS+ | اندروید | وب ) را شروع کرده‌اید، نکات عیب‌یابی زیر می‌تواند به شما در رفع مشکلاتی که شامل شناسایی SDK توسط Firebase یا نمایش اولین داده‌های عملکرد شما در کنسول Firebase می‌شود، کمک کند.

SDK به برنامه اضافه شد، اما کنسول هنوز می‌گوید که SDK را اضافه کنید

فایربیس می‌تواند با دریافت اطلاعات رویداد (مانند تعاملات برنامه) از برنامه شما، تشخیص دهد که آیا با موفقیت SDK Performance Monitoring را به برنامه خود اضافه کرده‌اید یا خیر. معمولاً ظرف 10 دقیقه پس از شروع برنامه، داشبورد عملکرد کنسول Firebase پیام "SDK شناسایی شد" را نمایش می‌دهد. سپس، ظرف 30 دقیقه، داشبورد داده‌های پردازش شده اولیه را نمایش می‌دهد.

اگر بیش از 10 دقیقه از اضافه کردن آخرین نسخه SDK به برنامه‌تان گذشته است و هنوز هیچ تغییری مشاهده نمی‌کنید، پیام‌های گزارش خود را بررسی کنید تا مطمئن شوید که Performance Monitoring در حال ثبت رویدادها است. مراحل عیب‌یابی مناسب را که در زیر توضیح داده شده است، برای عیب‌یابی پیام تأخیر در تشخیص SDK امتحان کنید.

برنامه در حال ثبت رویدادها است: مراحل عیب‌یابی

نکته: SDK Performance Monitoring رویدادها را به صورت محلی دسته‌بندی می‌کند و سپس آنها را به صورت دوره‌ای به Firebase ارسال می‌کند. این بدان معناست که بین تعامل برنامه و زمانی که Firebase اطلاعات رویداد را از برنامه شما دریافت می‌کند، تأخیری وجود دارد.

1. اگر هنوز در حال توسعه محلی هستید، سعی کنید رویدادهای بیشتری برای جمع‌آوری داده‌ها ایجاد کنید:

   1. برنامه وب خود را در یک محیط محلی ارائه و مشاهده کنید.

   2. با بارگذاری زیرصفحات سایت خود، تعامل با برنامه خود و/یا ایجاد درخواست‌های شبکه، رویدادها را ایجاد کنید. مطمئن شوید که تب مرورگر را حداقل 10 ثانیه پس از بارگذاری صفحه باز نگه دارید.

2. مطمئن شوید که شیء پیکربندی Firebase شما به درستی به برنامه اضافه شده است و آن را تغییر نداده‌اید. به طور خاص، موارد زیر را بررسی کنید:

   • شناسه برنامه وب Firebase ( appId ) در شیء پیکربندی برای برنامه شما صحیح است. شناسه برنامه Firebase خود را در کارت برنامه‌های شما در پروژه خود پیدا کنید.

   اگر به نظر می‌رسد شیء پیکربندی در برنامه شما مشکلی دارد، موارد زیر را امتحان کنید:

   1. شیء پیکربندی که در حال حاضر در برنامه خود دارید را حذف کنید.

   2. برای دریافت یک شیء پیکربندی جدید و افزودن آن به برنامه وب خود، این دستورالعمل‌ها را دنبال کنید.

3. اگر SDK رویدادها را ثبت می‌کند و به نظر می‌رسد همه چیز به درستی تنظیم شده است، اما هنوز پیام تشخیص SDK یا داده‌های پردازش شده را مشاهده نمی‌کنید (پس از ۲ ساعت)، با پشتیبانی Firebase تماس بگیرید .

برنامه رویدادها را ثبت نمی‌کند : مراحل عیب‌یابی

1. مطمئن شوید که SDK مربوط به Performance Monitoring به درستی در برنامه شما مقداردهی اولیه شده است.

2. مطمئن شوید که SDK Performance Monitoring از طریق پرچم زیر غیرفعال نشده باشد:

   • performance.instrumentationEnabled

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

4. صفحه وب را ببندید، سپس دوباره باز کنید. دوباره ورود به سیستم را بررسی کنید.

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

5. اگر نمی‌توانید چیزی را که در برنامه‌تان غیرفعال شده است پیدا کنید، با پشتیبانی Firebase تماس بگیرید .

کنسول می‌گوید SDK شناسایی شده است، اما هیچ داده‌ای نمایش داده نمی‌شود

Performance Monitoring داده‌های رویداد عملکرد را قبل از نمایش در داشبورد عملکرد، پردازش می‌کند.

اگر بیش از ۲۴ ساعت از نمایش پیام "SDK شناسایی شد" گذشته است و هنوز داده‌ای مشاهده نمی‌کنید، داشبورد وضعیت Firebase را بررسی کنید تا مطمئن شوید که قطعی وجود دارد. اگر قطعی وجود نداشت، با پشتیبانی Firebase تماس بگیرید .

عیب یابی عمومی

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

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

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

1. مطمئن شوید که SDK مربوط به Performance Monitoring به درستی در برنامه شما مقداردهی اولیه شده است.

2. مطمئن شوید که SDK Performance Monitoring از طریق پرچم زیر غیرفعال نشده باشد:

   • performance.instrumentationEnabled

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

4. صفحه وب را ببندید، سپس دوباره باز کنید. دوباره ورود به سیستم را بررسی کنید.

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

5. اگر نمی‌توانید چیزی را که در برنامه‌تان غیرفعال شده است پیدا کنید، با پشتیبانی Firebase تماس بگیرید .

داشبورد عملکرد، داده‌های تأخیر ورودی اول را ندارد

اگر داده‌های مربوط به اولین معیار تأخیر ورودی را نمی‌بینید، مراحل عیب‌یابی زیر را امتحان کنید:

1. توجه داشته باشید که Performance Monitoring فقط اولین معیار تأخیر ورودی را ثبت می‌کند، زمانی که کاربر در ۵ ثانیه اول پس از بارگذاری صفحه، روی صفحه وب کلیک می‌کند.

2. مطمئن شوید که برنامه خود را برای اندازه‌گیری این معیار تنظیم کرده‌اید. اولین معیار تأخیر ورودی نیاز به تنظیم دستی دارد. به طور خاص، باید کتابخانه polyfill را برای این معیار اضافه کنید. برای دستورالعمل‌های نصب، به مستندات کتابخانه مراجعه کنید.

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

داشبورد عملکرد فاقد داده‌های ردیابی سفارشی است

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

1. تنظیمات ردیابی کدهای سفارشی که از طریق Trace API استفاده می‌شوند را بررسی کنید، به خصوص موارد زیر:

   • نام‌های مربوط به ردیابی کدهای سفارشی و معیارهای سفارشی باید الزامات زیر را داشته باشند: بدون فاصله‌ی خالی در ابتدا یا انتهای نام، بدون کاراکتر زیرخط ( _ ) در ابتدای نام، و حداکثر طول نام ۳۲ کاراکتر.
   • همه ردیابی‌ها باید شروع و متوقف شوند. هر ردیابی که شروع نشده، متوقف نشده یا قبل از شروع متوقف شده باشد، ثبت نخواهد شد.

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

2. مطمئن شوید که جمع‌آوری داده‌های Performance Monitoring از طریق پرچم زیر غیرفعال نشده باشد :

   • performance.dataCollectionEnabled

     این پرچم، جمع‌آوری داده‌ها را فقط برای ردیابی کدهای سفارشی کنترل می‌کند (نه همه داده‌ها).

3. پیام‌های گزارش خود را بررسی کنید تا مطمئن شوید که Performance Monitoring رد کدهای سفارشی مورد انتظار را ثبت می‌کند.

4. اگر Performance Monitoring در حال ثبت رویدادها است، اما پس از 24 ساعت هیچ داده‌ای نمایش داده نمی‌شود، با پشتیبانی Firebase تماس بگیرید .

داشبورد عملکرد، داده‌های درخواست شبکه را ندارد

اگر داده‌های درخواست شبکه را از دست می‌دهید، موارد زیر را در نظر داشته باشید:

• Performance Monitoring به طور خودکار معیارهای مربوط به درخواست‌های شبکه گزارش شده توسط API مرورگر را جمع‌آوری می‌کند. این گزارش‌ها شامل درخواست‌های ناموفق شبکه نمی‌شوند.

• بسته به رفتار کد شما و کتابخانه‌های شبکه‌ای که توسط کد شما استفاده می‌شوند، Performance Monitoring ممکن است فقط درخواست‌های شبکه‌ای که تکمیل شده‌اند را گزارش دهد. این بدان معناست که اتصالات HTTP/S که باز مانده‌اند ممکن است گزارش نشوند.

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

درباره نحوه جمع‌آوری داده‌های درخواست شبکه Performance Monitoring تحت الگوهای URL بیشتر بدانید.

همچنین می‌توانید الگوهای URL سفارشی را امتحان کنید!

سوالات متداول

iOS+ اندروید وب

چه اتفاقی برای کارت «مشکلات اصلی در عملکرد» در صفحه اصلی پروژه افتاد؟

ما در ادامه‌ی معرفی هشدارهای اخیرمان، «مشکلات مهم» را با «هشدارهای اخیر» جایگزین کردیم. این هشدارها به طور خودکار هنگام عبور از آستانه‌های تعیین‌شده توسط شما، به شما اطلاع می‌دهند. اکنون «مشکلات» منسوخ شده و با هشدارها جایگزین شده‌اند.

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

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

چه اتفاقی برای قابلیت تعیین آستانه برای مشکلات در کنسول افتاد؟

Performance Monitoring از هشدارهایی برای معیارهایی که از آستانه‌های تعریف‌شده تجاوز می‌کنند، پشتیبانی می‌کند. برای جلوگیری از سردرگمی با این آستانه‌های قابل تنظیم برای معیارهای عملکرد، قابلیت پیکربندی آستانه‌ها برای مشکلات را حذف کردیم.

چه اتفاقی برای اطلاعات Details و Metrics در کنسول Firebase افتاد؟

ما صفحات Details و Metrics را با یک رابط کاربری (UI) متمرکز و بازطراحی‌شده جایگزین کردیم تا نحوه عیب‌یابی مشکلات را بهبود بخشیم. این رابط کاربری عیب‌یابی جدید، همان قابلیت‌های اصلی Details و Metrics را ارائه می‌دهد. برای کسب اطلاعات بیشتر در مورد عیب‌یابی، به بخش «مشاهده داده‌های بیشتر برای یک ردیابی خاص» مراجعه کنید.

چرا تعداد نمونه‌ها آنطور که انتظار دارم نیست؟

Performance Monitoring داده‌های عملکرد را از دستگاه‌های کاربر برنامه شما جمع‌آوری می‌کند. اگر برنامه شما کاربران زیادی دارد یا اگر برنامه حجم زیادی از فعالیت‌های عملکردی را تولید می‌کند، Performance Monitoring ممکن است جمع‌آوری داده‌ها را به زیرمجموعه‌ای از دستگاه‌ها محدود کند تا تعداد رویدادهای پردازش‌شده را کاهش دهد. این محدودیت‌ها به اندازه‌ای زیاد هستند که حتی با رویدادهای کمتر، مقادیر معیار همچنان نمایانگر تجربه برنامه کاربر شما باشند.

برای مدیریت حجم داده‌هایی که جمع‌آوری می‌کنیم، Performance Monitoring از گزینه‌های نمونه‌گیری زیر استفاده می‌کند:

• محدود کردن سرعت روی دستگاه : برای جلوگیری از ارسال ناگهانی ردیابی‌ها توسط دستگاه، تعداد ردیابی‌های کد و درخواست شبکه ارسال شده از یک دستگاه را به ۳۰۰ رویداد در هر ۱۰ دقیقه محدود می‌کنیم. این رویکرد، دستگاه را از ابزارهای حلقه‌ای که می‌توانند حجم زیادی از داده‌های عملکرد را ارسال کنند، محافظت می‌کند و از تحریف اندازه‌گیری‌های عملکرد توسط یک دستگاه واحد جلوگیری می‌کند.

• نمونه‌برداری پویا : Performance Monitoring روزانه تعداد محدودی از رد کد و رد درخواست شبکه را به ازای هر برنامه در بین تمام کاربران برنامه جمع‌آوری می‌کند. یک نرخ نمونه‌برداری پویا روی دستگاه‌ها (با استفاده از Firebase Remote Config ) واکشی می‌شود تا مشخص شود که آیا یک دستگاه تصادفی باید ردها را ضبط و ارسال کند یا خیر. دستگاهی که برای نمونه‌برداری انتخاب نشده است، هیچ رویدادی ارسال نمی‌کند. نرخ نمونه‌برداری پویا مختص برنامه است و تنظیم می‌شود تا اطمینان حاصل شود که حجم کلی داده‌های جمع‌آوری‌شده کمتر از حد مجاز باقی می‌ماند.

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

• محدود کردن نرخ سمت سرور : برای اطمینان از اینکه برنامه‌ها از حد نمونه‌برداری تجاوز نمی‌کنند، Performance Monitoring ممکن است از نمونه‌برداری سمت سرور برای حذف برخی از رویدادهای دریافتی از دستگاه‌ها استفاده کند. اگرچه این نوع محدود کردن، اثربخشی معیارهای ما را تغییر نمی‌دهد، اما ممکن است باعث تغییرات جزئی در الگو، از جمله موارد زیر، شود:

  • تعداد ردپاها می‌تواند با تعداد دفعاتی که یک قطعه کد اجرا شده است، متفاوت باشد.
  • ردپاهایی که در کد به هم نزدیک هستند، ممکن است هر کدام تعداد نمونه‌های متفاوتی داشته باشند.

توجه: محدودیت‌های نمونه‌برداری خاص و کاربرد آنها ممکن است با تکامل Performance Monitoring تغییر کند.

چه اتفاقی برای تب Issues در کنسول افتاده است؟

ما تب «مسائل» (Problems) را با «هشدارها» (Alerts) جایگزین کردیم، که به طور خودکار هنگام عبور از آستانه‌های تعیین‌شده به شما اطلاع می‌دهد. دیگر نیازی نیست کنسول Firebase را به صورت دستی بررسی کنید تا وضعیت یک آستانه را تعیین کنید. برای کسب اطلاعات در مورد هشدارها، به «تنظیم هشدارها برای مشکلات عملکرد» مراجعه کنید.

چه اتفاقی برای تب‌های On Device و Network در کنسول افتاد؟ چگونه می‌توانم ردپاهایی را که در آن صفحات وجود داشت، مشاهده کنم؟

ما بخش Performance Monitoring کنسول Firebase را دوباره طراحی کرده‌ایم تا تب داشبورد ، معیارهای کلیدی و تمام ردیابی‌های شما را در یک فضا نمایش دهد. به عنوان بخشی از طراحی مجدد، صفحات On device و Network را حذف کردیم.

جدول ردیابی‌ها در پایین برگه داشبورد، تمام اطلاعات مشابه با برگه‌های «دستگاه روشن» و «شبکه» را دارد، اما برخی ویژگی‌های اضافه شده، از جمله امکان مرتب‌سازی ردیابی‌ها بر اساس درصد تغییر برای یک معیار خاص. برای مشاهده تمام معیارها و داده‌های یک ردیابی خاص، روی نام ردیابی در جدول ردیابی‌ها کلیک کنید.

ردپاهای خود را در زیربرگه‌های جدول ردپاها مشاهده کنید:

• ردیابی درخواست‌های شبکه (هم از قبل آماده و هم سفارشی) — زیربرگه درخواست‌های شبکه
• ردپاهای کد سفارشی — زیربرگه ردپاهای سفارشی
• شروع برنامه، ردیابی برنامه در پیش‌زمینه، ردیابی برنامه در پس‌زمینه — زیربرگه ردیابی‌های سفارشی
• ردیابی‌های رندر صفحه نمایش — زیربرگه رندر صفحه نمایش
• ردیابی بارگذاری صفحه — زیربرگه بارگذاری صفحه

برای جزئیات بیشتر در مورد جدول ردگیری‌ها و مشاهده معیارها و داده‌ها، به صفحه نمای کلی کنسول ( iOS+ | اندروید | وب ) مراجعه کنید.

چرا تعداد فریم‌های کند و ثابت آن چیزی نیست که انتظار داشتم؟

فریم‌های رندر کند و فریم‌های فریز شده با نرخ نوسازی فرضی ۶۰ هرتز دستگاه محاسبه می‌شوند. اگر نرخ نوسازی دستگاه کمتر از ۶۰ هرتز باشد، هر فریم زمان رندر کندتری خواهد داشت زیرا فریم‌های کمتری در هر ثانیه رندر می‌شوند. زمان رندر کندتر می‌تواند باعث گزارش فریم‌های کند یا فریز شده بیشتری شود زیرا فریم‌های بیشتری کندتر رندر می‌شوند یا فریز می‌شوند. با این حال، اگر نرخ نوسازی دستگاه بالاتر از ۶۰ هرتز باشد، هر فریم زمان رندر سریع‌تری خواهد داشت. این می‌تواند باعث گزارش فریم‌های کند یا فریز شده کمتری شود. این یک محدودیت فعلی در SDK Performance Monitoring است.

چگونه می‌توانم SDK JS Performance Monitoring (SDK "مستقل") را که کوچک‌تر و با نام فضای نام‌گذاری شده است، به برنامه وب خود اضافه کنم؟

اگر Performance Monitoring تنها محصول Firebase در برنامه شماست، می‌توانید از SDK مستقل Performance Monitoring (و اسکریپت هدر پیشنهادی زیر) در صورت تمایل استفاده کنید:

• با استفاده از یک کتابخانه با فضای نام
• کاهش اندازه بسته SDK شما
• تأخیر در راه‌اندازی اولیه SDK تا پس از بارگذاری صفحه شما

مهم: برای اکثر برنامه‌های وب Firebase، اکیداً توصیه می‌کنیم از Firebase JS SDK ماژولار از طریق npm استفاده کنید.
همچنین، با استفاده از npm به همراه یک module bundler ، می‌توانید به اندازه بسته SDK حتی کوچکتری نسبت به استفاده از Performance Monitoring SDK مستقل دست یابید.

برای گنجاندن SDK مستقل Performance Monitoring در برنامه خود و به تأخیر انداختن راه‌اندازی آن تا پس از بارگذاری صفحه:

1. اسکریپت زیر را به هدر فایل index خود اضافه کنید.
2. مطمئن شوید که شیء پیکربندی پروژه Firebase برنامه خود را اضافه کرده‌اید.

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

کجا،

• performance_standalone است 'https://www.gstatic.com/firebasejs/12.10.0/firebase-performance.js'
• firebaseConfig شیء پیکربندی Firebase برنامه شماست.

اسکریپت فوق به صورت ناهمگام SDK مستقل را بارگذاری می‌کند و سپس پس از اجرای رویداد onload پنجره، Firebase را مقداردهی اولیه می‌کند. این تاکتیک تأثیری را که SDK می‌تواند بر معیارهای بارگذاری صفحه داشته باشد، کاهش می‌دهد، زیرا مرورگر قبلاً هنگام مقداردهی اولیه SDK، معیارهای بارگذاری خود را گزارش کرده است.

توجه: هنگام استفاده از SDK مستقل Performance Monitoring ، شما به صراحت SDK هسته Firebase را شامل نمی‌شوید، زیرا SDK مستقل از قبل SDK هسته Firebase سبک‌تر خود را دارد.

درباره SDK مستقل Performance Monitoring و اسکریپت هدر اطلاعات کسب کنید

این SDK مستقل از نظر حجم بهینه شده است؛ حجم آن پس از فشرده‌سازی Gzip حدود ۱۰ کیلوبایت است. این SDK تمام قابلیت‌های Firebase Performance Monitoring را به همراه مجموعه‌ای حداقلی از قابلیت‌های SDK اصلی Firebase نیز داراست.

Firebase Performance Monitoring از APIهای fetch و Promise استفاده می‌کند که در مرورگرهای قدیمی در دسترس نیستند. پلی‌فیل‌های این APIها در SDK استاندارد Firebase Performance Monitoring JS گنجانده شده‌اند، اما برای کاهش حجم، از SDK مستقل حذف شده‌اند.

کیت توسعه نرم‌افزار (SDK) Performance Monitoring ، تا حدودی به API زمان‌بندی منابع (Resource Timing API) برای دریافت معیارهای بارگذاری صفحه از مرورگر متکی است.

قطعه کد زیر اسکریپت هدر را که شامل تأخیر در مقداردهی اولیه SDK است، تجزیه می‌کند:

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

کجا،

• performance_standalone است 'https://www.gstatic.com/firebasejs/12.10.0/firebase-performance-standalone.js'
• firebaseConfig شیء پیکربندی Firebase برنامه شماست.

پردازش و نمایش تقریباً بلادرنگ داده‌ها

منظور از داده‌های عملکردی «تقریباً بلادرنگ» چیست؟

Firebase Performance Monitoring ، داده‌های عملکردی جمع‌آوری‌شده را به محض ورود پردازش می‌کند که منجر به نمایش تقریباً بلادرنگ داده‌ها در کنسول Firebase می‌شود. داده‌های پردازش‌شده ظرف چند دقیقه پس از جمع‌آوری در کنسول نمایش داده می‌شوند، از این رو اصطلاح "تقریباً بلادرنگ" به آن‌ها اطلاق می‌شود.

برای بهره‌مندی از پردازش داده‌های تقریباً بلادرنگ، مطمئن شوید که برنامه شما از نسخه SDK سازگار با بلادرنگ استفاده می‌کند.

چگونه می‌توانم داده‌های عملکرد تقریباً بلادرنگ (Real-Time) را برای برنامه‌ام دریافت کنم؟

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

این‌ها نسخه‌های SDK سازگار با زمان واقعی هستند:

• آی‌او‌اس - نسخه ۷.۳.۰ یا بالاتر
• tvOS — نسخه ۸.۹.۰ یا بالاتر
• اندروید - نسخه ۱۹.۰.۱۰ یا بالاتر (یا Firebase Android BoM نسخه ۲۶.۱.۰ یا بالاتر)
• وب - نسخه ۷.۱۴.۰ یا بالاتر

توجه داشته باشید که ما همیشه استفاده از آخرین نسخه SDK را توصیه می‌کنیم، اما هر نسخه‌ای که در بالا ذکر شد، Performance Monitoring فعال می‌کند تا داده‌های شما را تقریباً به صورت بلادرنگ پردازش کند.

کدام نسخه‌های Performance Monitoring SDK با قابلیت Real-Time سازگار هستند؟

این نسخه‌های SDK سازگار با پردازش داده‌های بلادرنگ هستند:

• آی‌او‌اس - نسخه ۷.۳.۰ یا بالاتر
• tvOS — نسخه ۸.۹.۰ یا بالاتر
• اندروید - نسخه ۱۹.۰.۱۰ یا بالاتر (یا Firebase Android BoM نسخه ۲۶.۱.۰ یا بالاتر)
• وب - نسخه ۷.۱۴.۰ یا بالاتر

توجه داشته باشید که ما همیشه استفاده از آخرین نسخه SDK را توصیه می‌کنیم، اما هر نسخه‌ای که در بالا ذکر شد، Performance Monitoring فعال می‌کند تا داده‌های شما را تقریباً به صورت بلادرنگ پردازش کند.

اگر برنامه‌ام را برای استفاده از نسخه SDK سازگار با زمان واقعی به‌روزرسانی نکنم، چه می‌شود؟

اگر برنامه شما از نسخه SDK سازگار با زمان واقعی استفاده نمی‌کند، همچنان تمام داده‌های عملکرد برنامه خود را در کنسول Firebase مشاهده خواهید کرد. با این حال، نمایش داده‌های عملکرد تقریباً ۳۶ ساعت از زمان جمع‌آوری آنها به تأخیر می‌افتد.

من به نسخه SDK سازگار با زمان واقعی به‌روزرسانی کرده‌ام، اما برخی از کاربران من هنوز از نسخه‌های قدیمی برنامه من استفاده می‌کنند. آیا همچنان می‌توانم داده‌های عملکرد آنها را در کنسول Firebase مشاهده کنم؟

بله! صرف نظر از اینکه یک نمونه برنامه از کدام نسخه SDK استفاده می‌کند، داده‌های عملکرد را از همه کاربران خود مشاهده خواهید کرد.

با این حال، اگر به داده‌های اخیر (کمتر از تقریباً ۳۶ ساعت پیش) نگاه می‌کنید، داده‌های نمایش داده شده از کاربران نمونه‌های برنامه با استفاده از یک نسخه SDK سازگار با زمان واقعی است. با این حال، داده‌های غیر اخیر شامل داده‌های عملکرد از تمام نسخه‌های برنامه شما می‌شود.

تماس با پشتیبانی فایربیس

اگر با پشتیبانی فایربیس تماس می‌گیرید ، همیشه شناسه برنامه فایربیس خود را وارد کنید. شناسه برنامه فایربیس خود را در کارت «برنامه‌های شما» در پروژه خود پیدا کنید.