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


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

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

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

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

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

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

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

مشخصه‌های پیش‌فرض جمع‌آوری‌شده برای برنامه‌های وب

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

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

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

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

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

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

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

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

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

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

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

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

Web

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

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

// Read attributes
const traceAttributes = t.getAttributes();

Web

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

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

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

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

// Read attributes
const traceAttributes = trace.getAttributes();