نظارت سفارشی برای کد برنامه خاص اضافه کنید


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

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

معیار پیش‌فرض برای ردیابی کد سفارشی «مدت» آن است (زمان بین نقطه شروع و توقف ردیابی)، اما می‌توانید معیارهای سفارشی را نیز اضافه کنید.

در کد خود، ابتدا و انتهای یک ردیابی کد سفارشی را با استفاده از API های ارائه شده توسط Performance Monitoring SDK تعریف می کنید.

ردیابی کد سفارشی را می توان در هر زمانی پس از ایجاد آنها شروع کرد و آنها را در حالت ایمن قرار داد.

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

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

ویژگی‌های پیش‌فرض، ویژگی‌های سفارشی و معیارهای سفارشی

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

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

ویژگی‌های سفارشی و معیارهای سفارشی در کنسول Firebase در کنار ویژگی‌های پیش‌فرض و متریک پیش‌فرض برای ردیابی نمایش داده می‌شوند.

ردیابی کد سفارشی را اضافه کنید

از Performance Monitoring Trace API برای اضافه کردن ردیابی کد سفارشی برای نظارت بر کد برنامه خاص استفاده کنید.

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

  • یک برنامه می تواند چندین ردیابی کد سفارشی داشته باشد.
  • بیش از یک ردیابی کد سفارشی می تواند همزمان اجرا شود.
  • نام‌های ردیابی کد سفارشی باید شرایط زیر را داشته باشند: بدون فضای سفید اصلی یا انتهایی، بدون نویسه زیرخط اصلی ( _ ) و حداکثر طول 100 کاراکتر باشد.
  • ردیابی کد سفارشی از افزودن معیارهای سفارشی و ویژگی های سفارشی پشتیبانی می کند.

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

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

معیارهای سفارشی را به ردیابی کد سفارشی اضافه کنید

از Performance Monitoring Trace API برای افزودن معیارهای سفارشی به ردیابی کد سفارشی استفاده کنید.

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

  • نام‌های معیارهای سفارشی باید شرایط زیر را داشته باشند: بدون فضای سفید اصلی یا انتهایی، بدون نویسه زیرخط اصلی ( _ ) و حداکثر طول 100 نویسه است.
  • هر ردیابی کد سفارشی می تواند تا 32 معیار (از جمله متریک مدت زمان پیش فرض) را ثبت کند.

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

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

ایجاد ویژگی های سفارشی برای ردیابی کد سفارشی

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

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

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

  • هر ردیابی کد سفارشی می تواند تا 5 ویژگی سفارشی را ثبت کند.

  • شما نباید از ویژگی های سفارشی استفاده کنید که حاوی اطلاعاتی است که شخصاً یک فرد را در Google شناسایی می کند.

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

داده های عملکرد را ردیابی، مشاهده و فیلتر کنید

معیارهای خاص را در داشبورد خود ردیابی کنید

برای اینکه بدانید معیارهای کلیدی شما چگونه ترند هستند، آنها را به تابلوی معیارهای خود در بالای داشبورد عملکرد اضافه کنید. می‌توانید با دیدن تغییرات هفته به هفته به سرعت رگرسیون‌ها را شناسایی کنید یا تأیید کنید که تغییرات اخیر در کدتان عملکرد را بهبود می‌بخشد.

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

تابلوی متریک داده های متریک جمع آوری شده را در طول زمان، هم به صورت گرافیکی و هم به صورت درصد تغییر عددی نشان می دهد.

درباره استفاده از داشبورد بیشتر بیاموزید.

مشاهده آثار و داده های آنها

برای مشاهده ردیابی‌های خود، به داشبورد عملکرد در کنسول Firebase بروید، به جدول ردیابی‌ها بروید و سپس روی زیربرگه مناسب کلیک کنید. جدول برخی از معیارهای برتر را برای هر ردیابی نشان می دهد، و حتی می توانید لیست را بر اساس درصد تغییر برای یک معیار خاص مرتب کنید.

اگر روی نام ردیابی در جدول ردیابی کلیک کنید، سپس می‌توانید روی صفحه‌های مختلف کلیک کنید تا ردیابی را کاوش کرده و معیارهای مورد علاقه را بررسی کنید. در اکثر صفحات، می توانید از دکمه فیلتر (بالا سمت چپ صفحه) برای فیلتر کردن داده ها بر اساس ویژگی استفاده کنید، به عنوان مثال:

  • بر اساس نسخه برنامه فیلتر کنید تا داده‌های مربوط به نسخه قبلی یا آخرین نسخه خود را مشاهده کنید
  • بر اساس دستگاه فیلتر کنید تا بدانید دستگاه های قدیمی چگونه برنامه شما را مدیریت می کنند
  • بر اساس کشور فیلتر کنید تا مطمئن شوید مکان پایگاه داده شما بر منطقه خاصی تأثیر نمی گذارد

درباره مشاهده داده های ردیابی خود بیشتر بیاموزید.

مراحل بعدی

،


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

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

معیار پیش‌فرض برای ردیابی کد سفارشی «مدت» آن است (زمان بین نقطه شروع و توقف ردیابی)، اما می‌توانید معیارهای سفارشی را نیز اضافه کنید.

در کد خود، ابتدا و انتهای یک ردیابی کد سفارشی را با استفاده از API های ارائه شده توسط Performance Monitoring SDK تعریف می کنید.

ردیابی کد سفارشی را می توان در هر زمانی پس از ایجاد آنها شروع کرد و آنها را در حالت ایمن قرار داد.

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

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

ویژگی‌های پیش‌فرض، ویژگی‌های سفارشی و معیارهای سفارشی

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

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

ویژگی‌های سفارشی و معیارهای سفارشی در کنسول Firebase در کنار ویژگی‌های پیش‌فرض و متریک پیش‌فرض برای ردیابی نمایش داده می‌شوند.

ردیابی کد سفارشی را اضافه کنید

از Performance Monitoring Trace API برای اضافه کردن ردیابی کد سفارشی برای نظارت بر کد برنامه خاص استفاده کنید.

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

  • یک برنامه می تواند چندین ردیابی کد سفارشی داشته باشد.
  • بیش از یک ردیابی کد سفارشی می تواند همزمان اجرا شود.
  • نام‌های ردیابی کد سفارشی باید شرایط زیر را داشته باشند: بدون فضای سفید اصلی یا انتهایی، بدون نویسه زیرخط اصلی ( _ ) و حداکثر طول 100 کاراکتر باشد.
  • ردیابی کد سفارشی از افزودن معیارهای سفارشی و ویژگی های سفارشی پشتیبانی می کند.

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

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

معیارهای سفارشی را به ردیابی کد سفارشی اضافه کنید

از Performance Monitoring Trace API برای افزودن معیارهای سفارشی به ردیابی کد سفارشی استفاده کنید.

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

  • نام‌های معیارهای سفارشی باید شرایط زیر را داشته باشند: بدون فضای سفید اصلی یا انتهایی، بدون نویسه زیرخط اصلی ( _ ) و حداکثر طول 100 نویسه است.
  • هر ردیابی کد سفارشی می تواند تا 32 معیار (از جمله متریک مدت زمان پیش فرض) را ثبت کند.

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

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

ایجاد ویژگی های سفارشی برای ردیابی کد سفارشی

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

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

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

  • هر ردیابی کد سفارشی می تواند تا 5 ویژگی سفارشی را ثبت کند.

  • شما نباید از ویژگی های سفارشی استفاده کنید که حاوی اطلاعاتی است که شخصاً یک فرد را در Google شناسایی می کند.

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

داده های عملکرد را ردیابی، مشاهده و فیلتر کنید

معیارهای خاص را در داشبورد خود ردیابی کنید

برای اینکه بدانید معیارهای کلیدی شما چگونه ترند هستند، آنها را به تابلوی معیارهای خود در بالای داشبورد عملکرد اضافه کنید. می‌توانید با دیدن تغییرات هفته به هفته به سرعت رگرسیون‌ها را شناسایی کنید یا تأیید کنید که تغییرات اخیر در کدتان عملکرد را بهبود می‌بخشد.

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

تابلوی متریک داده های متریک جمع آوری شده را در طول زمان، هم به صورت گرافیکی و هم به صورت درصد تغییر عددی نشان می دهد.

درباره استفاده از داشبورد بیشتر بیاموزید.

مشاهده آثار و داده های آنها

برای مشاهده ردیابی‌های خود، به داشبورد عملکرد در کنسول Firebase بروید، به جدول ردیابی‌ها بروید و سپس روی زیربرگه مناسب کلیک کنید. جدول برخی از معیارهای برتر را برای هر ردیابی نشان می دهد، و حتی می توانید لیست را بر اساس درصد تغییر برای یک معیار خاص مرتب کنید.

اگر روی نام ردیابی در جدول ردیابی کلیک کنید، سپس می‌توانید روی صفحه‌های مختلف کلیک کنید تا ردیابی را کاوش کرده و معیارهای مورد علاقه را بررسی کنید. در اکثر صفحات، می توانید از دکمه فیلتر (بالا سمت چپ صفحه) برای فیلتر کردن داده ها بر اساس ویژگی استفاده کنید، به عنوان مثال:

  • بر اساس نسخه برنامه فیلتر کنید تا داده‌های مربوط به نسخه قبلی یا آخرین نسخه خود را مشاهده کنید
  • بر اساس دستگاه فیلتر کنید تا بدانید دستگاه های قدیمی چگونه برنامه شما را مدیریت می کنند
  • بر اساس کشور فیلتر کنید تا مطمئن شوید مکان پایگاه داده شما بر منطقه خاصی تأثیر نمی گذارد

درباره مشاهده داده های ردیابی خود بیشتر بیاموزید.

مراحل بعدی

،


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

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

متریک پیش فرض برای ردیابی کد سفارشی "مدت زمان" آن (زمان بین نقاط شروع و توقف ردیابی) است ، اما می توانید معیارهای سفارشی را نیز اضافه کنید.

در کد خود ، ابتدا و پایان یک ردیابی کد سفارشی را با استفاده از API های ارائه شده توسط عملکرد SDK عملکرد تعریف می کنید.

آثار کد سفارشی می توانند در هر زمان پس از ایجاد آنها آغاز شوند و از آنها امن هستند.

از آنجا که متریک پیش فرض جمع آوری شده برای این آثار "مدت" است ، بعضی اوقات آنها "آثار مدت" نامیده می شوند.

شما می توانید داده های این آثار را در زیرنویس Traces Custom Traces از جدول Traces ، که در پایین داشبورد عملکرد قرار دارد مشاهده کنید (در مورد استفاده از کنسول بعداً در این صفحه اطلاعات بیشتری کسب کنید).

ویژگی های پیش فرض ، ویژگی های سفارشی و معیارهای سفارشی

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

شما می توانید یک ردیابی کد سفارشی را برای ضبط معیارهای سفارشی برای رویدادهای مربوط به عملکرد که در محدوده ردیابی رخ می دهد ، پیکربندی کنید. به عنوان مثال ، شما می توانید یک متریک سفارشی برای تعداد بازدیدها و از دست دادن های حافظه پنهان یا تعداد دفعاتی که UI برای یک دوره زمانی قابل توجه پاسخگو نیست ، ایجاد کنید.

ویژگی های سفارشی و معیارهای سفارشی در کنسول Firebase در کنار ویژگی های پیش فرض و متریک پیش فرض برای ردیابی.

آثار کد سفارشی را اضافه کنید

برای اضافه کردن آثار کد سفارشی برای نظارت بر کد برنامه خاص ، از API Trace Monitoring Performance استفاده کنید.

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

  • یک برنامه می تواند چندین اثر کد سفارشی داشته باشد.
  • بیش از یک ردیابی کد سفارشی می تواند همزمان اجرا شود.
  • نام برای آثار کد سفارشی باید شرایط زیر را برآورده کند: هیچ فضای سفیدی پیشرو یا دنباله دار ، بدون کاراکتر برجسته ( _ ) پیشرو و حداکثر طول 100 کاراکتر است.
  • آثار کد سفارشی پشتیبانی از اضافه کردن معیارهای سفارشی و ویژگی های سفارشی .

برای شروع و متوقف کردن ردیابی کد سفارشی ، کدی را که می خواهید با کد مشابه موارد زیر ردیابی کنید ، بپیچید:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

معیارهای سفارشی را به آثار کد سفارشی اضافه کنید

برای اضافه کردن معیارهای سفارشی به آثار کد سفارشی از API ردیابی عملکرد استفاده کنید.

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

  • نام برای معیارهای سفارشی باید شرایط زیر را برآورده کند: هیچ فضای سفیدی پیشرو یا دنباله دار ، بدون شخصیت برجسته ( _ ) پیشرو و حداکثر طول 100 کاراکتر است.
  • هر ردیابی کد سفارشی می تواند حداکثر 32 معیار را ضبط کند (از جمله متریک مدت زمان پیش فرض).

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

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

برای آثار کد سفارشی ویژگی های سفارشی ایجاد کنید

برای استفاده از ویژگی های سفارشی ، کد را به برنامه خود اضافه کنید که ویژگی را تعریف می کند و آن را با یک ردیابی کد خاص سفارشی مرتبط می کند. شما می توانید ویژگی های سفارشی را در هر زمان بین زمان شروع کار و زمان متوقف کردن ردیابی تنظیم کنید.

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

  • نام های مربوط به ویژگی های سفارشی باید شرایط زیر را برآورده کند: هیچ فضای سفیدی پیشرو یا دنباله دار ، بدون کاراکتر برجسته ( _ ) پیشرو و حداکثر طول 32 کاراکتر است.

  • هر ردیابی کد سفارشی می تواند حداکثر 5 ویژگی سفارشی را ضبط کند.

  • شما نباید از ویژگی های سفارشی استفاده کنید که حاوی اطلاعاتی باشد که شخصاً فرد را به Google معرفی می کند.

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

داده های عملکرد را ردیابی ، مشاهده و فیلتر کنید

معیارهای خاص را در داشبورد خود پیگیری کنید

برای یادگیری چگونگی روند کار کلیدی شما ، آنها را به صفحه معیارهای خود در بالای داشبورد عملکرد اضافه کنید. با دیدن تغییرات هفته ای بیش از هفته می توانید رگرسیون را به سرعت شناسایی کنید یا تأیید کنید که تغییرات اخیر در کد شما باعث بهبود عملکرد می شود.

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

هیئت مدیره معیارها داده های متریک را با گذشت زمان ، هم به صورت گرافیکی و هم به عنوان یک درصد تغییر عددی نشان می دهد.

در مورد استفاده از داشبورد بیشتر بدانید.

مشاهده اثری و داده های آنها

برای مشاهده آثار خود ، به داشبورد عملکرد در کنسول Firebase بروید ، به جدول Traces بروید ، سپس روی زیرنویس مناسب کلیک کنید. جدول برخی از معیارهای برتر را برای هر ردیابی نشان می دهد ، و حتی می توانید لیست را با تغییر درصد برای یک معیار خاص مرتب کنید.

اگر روی یک نام ردیابی در جدول Traces کلیک کنید ، می توانید روی صفحه نمایش های مختلف کلیک کنید تا ردیابی را کشف کرده و در معیارهای مورد علاقه قرار دهید. در اکثر صفحات ، می توانید از دکمه فیلتر (سمت چپ صفحه) برای فیلتر کردن داده ها با ویژگی استفاده کنید ، به عنوان مثال:

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

در مورد مشاهده داده ها برای آثار خود بیشتر بدانید.

مراحل بعدی

،


Performance Monitoring collects traces to help you monitor the performance of your app. A trace is a report of performance data captured between two points in time in your app.

You can create your own traces to monitor performance data associated with specific code in your app. With a custom code trace , you can measure how long it takes your app to complete a specific task or a set of tasks, for example loading a set of images or querying your database.

The default metric for a custom code trace is its "duration" (the time between the starting and stopping points of the trace), but you can add custom metrics , as well.

In your code, you define the beginning and the end of a custom code trace using the APIs provided by the Performance Monitoring SDK.

Custom code traces can be started anytime after they've been created, and they are thread safe.

Since the default metric collected for these traces is "duration", they are sometimes called "Duration traces".

You can view data from these traces in the Custom traces subtab of the traces table, which is at the bottom of the Performance dashboard (learn more about using the console later on this page).

Default attributes, custom attributes, and custom metrics

For custom code traces, Performance Monitoring automatically logs default attributes (common metadata like app version, country, device, etc.) so that you can filter the data for the trace in the Firebase console. You can also add and monitor custom attributes (such as, game level or user properties).

You can further configure a custom code trace to record custom metrics for performance-related events that occur within the trace's scope. For example, you can create a custom metric for the number of cache hits and misses or the number of times that the UI becomes unresponsive for a noticeable period of time.

Custom attributes and custom metrics display in the Firebase console alongside the default attributes and default metric for the trace.

Add custom code traces

Use the Performance Monitoring Trace API to add custom code traces to monitor specific application code.

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

  • An app can have multiple custom code traces.
  • More than one custom code trace can run at the same time.
  • Names for custom code traces must meet the following requirements: no leading or trailing whitespace, no leading underscore ( _ ) character, and max length is 100 characters.
  • Custom code traces support adding custom metrics and custom attributes .

To start and stop a custom code trace, wrap the code that you want to trace with code similar to the following:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

Add custom metrics to custom code traces

Use the Performance Monitoring Trace API to add custom metrics to custom code traces.

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

  • Names for custom metrics must meet the following requirements: no leading or trailing whitespace, no leading underscore ( _ ) character, and max length is 100 characters.
  • Each custom code trace can record up to 32 metrics (including the default Duration metric).

To add a custom metric, add a line of code similar to the following each time that the event occurs. For example, this custom metric counts performance- related events that occur in your app, such as cache hits or retries.

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

Create custom attributes for custom code traces

To use custom attributes, add code to your app that defines the attribute and associates it with a specific custom code trace. You can set the custom attribute anytime between when the trace starts and when the trace stops.

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

  • Names for custom attributes must meet the following requirements: no leading or trailing whitespace, no leading underscore ( _ ) character, and max length is 32 characters.

  • Each custom code trace can record up to 5 custom attributes.

  • You shouldn't use custom attributes that contain information that personally identifies an individual to Google.

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

Track, view, and filter performance data

Track specific metrics in your dashboard

To learn how your key metrics are trending, add them to your metrics board at the top of the Performance dashboard. You can quickly identify regressions by seeing week-over-week changes or verify that recent changes in your code are improving performance.

To add a metric to your metrics board, go to the Performance dashboard in the Firebase console, then click the Dashboard tab. Click an empty metric card, then select an existing metric to add to your board. Click the vertical ellipsis ( ⋮ ) on a populated metric card for more options, like to replace or remove a metric.

The metrics board shows collected metric data over time, both in graphical form and as a numerical percentage change.

Learn more about using the dashboard .

View traces and their data

To view your traces, go to the Performance dashboard in the Firebase console, scroll down to the traces table, then click the appropriate subtab. The table displays some top metrics for each trace, and you can even sort the list by the percentage change for a specific metric.

If you click a trace name in the traces table, you can then click throug various screens to explore the trace and drill down into metrics of interest. On most pages, you can use the Filter button (top-left of the screen) to filter the data by attribute, for example:

  • Filter by App version to view data about a past release or your latest release
  • Filter by Device to learn how older devices handle your app
  • Filter by Country to make sure your database location isn't affecting a specific region

Learn more about viewing data for your traces .

مراحل بعدی

  • Learn more about using attributes to examine performance data.

  • Learn more about how to track performance issues in the Firebase console.

  • Set up alerts for code changes that are degrading the performance of your app. For example, you can configure an email alert for your team if the duration of a specific custom code trace exceeds a threshold that you set.