عیب‌یابی و پرسشگان پایشگر کارایی

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

1. گزارش‌گیری اشکال‌زدایی را به‌صورت زیر فعال کنید:

   1. در Xcode (حداقل نسخه ۲۶.۲)، محصول > طرح > ویرایش طرح را انتخاب کنید.
   2. از منوِ سمت راست، اجرا را انتخاب کنید، سپس زبانه استدلال‌ها را انتخاب کنید.
   3. در بخش استدلال‌های منتقل‌شده در راه‌اندازی، -FIRDebugEnabled را اضافه کنید.

2. پیام‌های گزارش را برای یافتن پیام‌های خطا بررسی کنید.

3. Performance Monitoring پیام‌های گزارش خود را با Firebase/Performance برچسب‌گذاری می‌کند تا بتوانید پیام‌های گزارش خود را فیلتر کنید.

4. انواع گزارش‌های زیر را که نشان می‌دهد Performance Monitoring درحال گزارش کردن رویدادهای عملکرد است بررسی کنید:

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

5. برای مشاهده داده‌هایتان در کنسول Firebase، روی نشانی وب کلیک کنید. ممکن است چند لحظه طول بکشد تا داده‌ها در داشبورد به‌روزرسانی شود.

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

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

وقتی Firebase اطلاعات رویداد (مثل تعاملات برنامه) را از برنامه‌تان دریافت می‌کند، می‌تواند تشخیص دهد که آیا Performance Monitoring کیت توسعه نرم‌افزار را با موفقیت به برنامه‌تان اضافه کرده‌اید یا نه. معمولاً ظرف ۱۰ دقیقه پس‌از شروع برنامه، داشبورد عملکرد کنسول Firebase پیام «کیت توسعه نرم‌افزار شناسایی شد» را نمایش می‌دهد. سپس، ظرف ۳۰ دقیقه، داشبورد داده‌های پردازش‌شده اولیه را نمایش می‌دهد.

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

«کنسول» می‌گوید «کیت توسعه نرم‌افزار» شناسایی شده است، اما داده‌ای نمایش داده نمی‌شود

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

اگر بیش‌از ۲۴ ساعت از زمان ظاهر شدن پیام «کیت توسعه نرم‌افزار شناسایی شد» گذشته است، و هنوز داده‌ای نمی‌بینید، داشبورد وضعیت Firebase را بررسی کنید تا ببینید آیا قطعی شناخته‌شده‌ای وجود دارد یا نه. اگر قطعی وجود ندارد، با پشتیبانی Firebase تماس بگیرید.

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

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

1. مطمئن شوید که کیت توسعه نرم‌افزار Performance Monitoring ازطریق هریک از پرچم‌های زیر در فایل Info.plist شما غیرفعال نشده باشد:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. مطمئن شوید که Performance Monitoring در زمان اجرا غیرفعال نشده باشد (Swift | Obj-C).

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

داشبورد عملکرد داده‌های ردیابی صفحه ندارد

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

1. مطمئن شوید که از جدیدترین نسخه «کیت توسعه نرم‌افزار پلاتفرم‌های Apple» (نسخه ۱۳.۰.۰) استفاده می‌کنید. ردیابی‌های پردازش صفحه فقط با نسخه ۵.۰.۰ یا بالاتر دردسترس است.

2. ‫Performance Monitoring ردهای پرداز صفحه را برای کنترل‌کننده‌های نمای محتوی (مثل UINavigationController و UITabBarController) ایجاد نمی‌کند. اگر داده‌ها فقط برای این صفحه‌ها وجود ندارد، این رفتار موردانتظار است.

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

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

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

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

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

3. اگر Performance Monitoring رویدادها را ثبت می‌کند، اما پس‌از ۲۴ ساعت داده‌ای نمایش داده نمی‌شود، با «پشتیبانی Firebase» تماس بگیرید.

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

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

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

   • برای Swift: URLSession و URLConnection
   • برای Objective-C: ‏ NSURLSession و NSURLConnection

   توجه داشته باشید که می‌توانید پایش سفارشی برای درخواست‌های شبکه اضافه کنید.

2. به موارد زیر توجه کنید:

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

   • ‫Performance Monitoring درخواست‌های شبکه با سرایندهای نامعتبر Content-Type را گزارش نمی‌کند. بااین‌حال، درخواست‌های شبکه بدون سرصفحه‌های Content-Type همچنان پذیرفته خواهد شد.

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

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

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

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

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

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

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

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

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

اطلاعات «جزئیات و سنجه‌ها» در کنسول Firebase چه شد؟

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

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

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

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

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

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

  پروژه‌هایی که ادغام BigQuery را فعال کرده‌اند برای تعداد ردگیری‌های درخواست شبکه حد بالاتری دریافت می‌کنند.

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

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

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

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

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

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

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

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

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

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

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

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

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

صادر کردن داده‌های Performance Monitoring به BigQuery بیشتر از حد انتظار طول می‌کشد. آیا هم‌زمان نیست؟

اگر ادغام BigQuery را برای Firebase Performance Monitoring فعال کرده باشید، داده‌هایتان ۱۲ تا ۲۴ ساعت پس‌از پایان روز (به وقت اقیانوس آرام) به BigQuery صادر خواهد شد.

برای مثال، داده‌های ۱۹ آوریل در ۲۰ آوریل بین ساعت ۱۲ ظهر و نیمه‌شب در BigQuery دردسترس خواهد بود (همه تاریخ‌ها و زمان‌ها به وقت اقیانوس آرام است).

چند الگوی نشانی وب سفارشی می‌توانم ایجاد کنم؟

می‌توانید درمجموع حداکثر ۴۰۰ الگوی نشانی وب سفارشی برای هر برنامه و حداکثر ۱۰۰ الگوی نشانی وب سفارشی برای هر دامنه برای آن برنامه ایجاد کنید.

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

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

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

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

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

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

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

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

کدام نسخه‌های کیت توسعه نرم‌افزار Performance Monitoring سازگار با زمان واقعی درنظر گرفته می‌شوند؟

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

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

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

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

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

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

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

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

چرا نمایش هم‌زمان داده‌های عملکرد را نمی‌بینم؟

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

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

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