فیلتر کردن داده‌ها بااستفاده از مشخصه‌ها


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

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

تصویر <span class=داده‌های «پایشگر کارایی Firebase» براساس مشخصه فیلتر می‌شود» />

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

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

مشخصه‌های پیش‌فرض

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

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

مشخصه‌های پیش‌فرض برای برنامه‌های Apple و Android

همه ردیابی‌ها برای برنامه‌های Apple و Android به‌طور پیش‌فرض مشخصه‌های زیر را جمع‌آوری می‌کنند:

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

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

  • نوع رسانه : نوع MIME

درحال جمع‌آوری داده‌های کاربر

ایجاد مشخصه‌های سفارشی

می‌توانید در هرکدام از ردگیری‌های کد سفارشی ابزاربندی‌شده‌تان، مشخصه‌های سفارشی ایجاد کنید.

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

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

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

  • نام مشخصه‌های سفارشی باید شرایط زیر را داشته باشد:

    • بدون فاصله سفید در ابتدا یا انتها، بدون نویسه زیرخط (_) در ابتدا
    • فضایی وجود ندارد
    • حداکثر طول ۳۲ نویسه است
    • نویسه‌های مجاز برای نام عبارت‌اند از A-Z، a-z، و _.

  • هر ردگیری کد سفارشی می‌تواند تا ۵ مشخصه سفارشی را ضبط کند.

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

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

Kotlin 

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}

Java 

Trace trace = FirebasePerformance.getInstance().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();