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

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

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

   1. در Xcode (حداقل نسخه ۲۶.۲)، محصول > طرح > ویرایش طرح را انتخاب کنید.
   2. اجرا را از منوِ سمت راست انتخاب کنید، سپس زبانه آرگومان‌ها را انتخاب کنید.
   3. در بخش Arguments Passed on Launch،‏ -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 SDK را با موفقیت به برنامه‌تان اضافه کرده‌اید یا نه وقتی اطلاعات رویداد (مانند تعاملات برنامه) را از برنامه‌تان دریافت می‌کند. معمولاً ظرف ۱۰ دقیقه پس‌از شروع برنامه‌تان، داشبورد عملکرد کنسول Firebase پیام «SDK شناسایی شد» را نمایش می‌دهد. سپس، ظرف ۳۰ دقیقه، داشبورد داده‌های پردازش‌شده اولیه را نمایش می‌دهد.

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

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

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

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

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

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

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

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

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

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

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

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

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

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

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 | وب) مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

• 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 امکان می‌دهد داده‌های شما را تقریباً هم‌زمان پردازش کند.