فلترة البيانات باستخدام السمات

باستخدام Performance Monitoring، يمكنك استخدام السمات لتقسيم بيانات الأداء والتركيز على أداء تطبيقك في سيناريوهات مختلفة في الواقع.

بعد النقر على اسم تتبع في جدول عمليات التتبّع (المتوفّر في أسفل لوحة بيانات الأداء)، يمكنك التوغّل في المقاييس التي تهمّك. استخدِم الزر فلترة (أعلى يمين الشاشة) لفلترة البيانات حسب السمة، على سبيل المثال:

صورة <span class= يتم فلترة بيانات "مراقبة أداء Firebase" حسب السمة" />

الفلترة حسب عنوان URL للصفحة لعرض بيانات صفحة معيّنة في موقعك الإلكتروني
يمكنك الفلترة حسب نوع الاتصال الفعّال لمعرفة مدى تأثير اتصال الجيل الثالث في تطبيقك.
فلترة البيانات حسب البلد للتأكّد من أنّ موقع قاعدة البيانات لا يؤثر في منطقة معيّنة

السمات التلقائية

تجمع Performance Monitoring تلقائيًا مجموعة متنوعة من السمات التلقائية استنادًا إلى نوع التتبّع.

بالإضافة إلى هذه السمات التلقائية، يمكنك أيضًا إنشاء سمات مخصّصة في عمليات تتبُّع الرموز البرمجية المخصّصة لتقسيم البيانات استنادًا إلى فئات خاصة بتطبيقك. على سبيل المثال، في إحدى الألعاب، يمكنك تقسيم البيانات استنادًا إلى مستوى اللعبة.

السمات التلقائية التي يتم جمعها لتطبيقات الويب

تجمع جميع عمليات تتبُّع تطبيقات الويب السمات التالية تلقائيًا:

المتصفح
البلد
نوع الاتصال الفعّال
عنوان URL للصفحة
حالة مشغّل الخدمة
حالة مستوى الرؤية

جمع بيانات المستخدمين

جمع بيانات المستخدمين: لا تجمع Performance Monitoring بنفسها أي معلومات تحديد هوية شخصية (PII)، مثل الأسماء أو عناوين البريد الإلكتروني أو أرقام الهواتف. يمكن للمطوّرين جمع بيانات إضافية باستخدام Performance Monitoring من خلال إنشاء سمات مخصّصة في عمليات تتبُّع الرموز البرمجية المخصّصة. يجب ألا تتضمّن هذه البيانات التي يتم جمعها من خلال Performance Monitoring معلومات تحدّد هوية شخص معيّن لدى Google.

في ما يلي مثال على رسالة سجلّ لا تحتوي على معلومات تحديد الهوية الشخصية:

trace.putAttribute("experiment", "A");

في ما يلي مثال يتضمّن معلومات تحديد هوية شخصية (لا تستخدِم هذا النوع من السمات المخصّصة في تطبيقك):

trace.putAttribute("email", user.getEmailAddress());

تخضع البيانات التي تكشف عن أي معلومات تحدّد الهوية الشخصية للعملية حذف بدون إشعار.

إنشاء سمات مخصّصة

يمكنك إنشاء سمات مخصّصة في أيّ من عمليات تتبُّع الرموز البرمجية المخصّصة التي تمّ تجهيزها.

استخدِم واجهة برمجة التطبيقات Performance Monitoring Trace API لإضافة سمات مخصّصة إلى عمليات تتبُّع الرموز البرمجية المخصّصة.

لاستخدام السمات المخصّصة، أضِف رمزًا إلى تطبيقك يحدِّد السمة ويربطها بمسار تتبُّع رمز مخصّص محدّد. يمكنك ضبط السمة المخصّصة في أي وقت بين بدء التتبّع وإيقافه.

لاحظ ما يلي:

يجب أن تستوفي أسماء السمات المخصّصة المتطلبات التالية:
- يجب ألا تحتوي على مسافات بيضاء بادئة أو لاحقة، وألا تحتوي على شرطة سفلية بادئة (_).
- ما مِن مسافات
- الحد الأقصى للطول هو 32 حرفًا.
- الأحرف المسموح بها للاسم هي A-Z وa-z و_.
يمكن أن يسجِّل كلّ تتبُّع رمز مخصّص ما يصل إلى 5 سمات مخصّصة.
يُرجى التأكّد من أنّ السمات المخصّصة لا تحتوي على أي معلومات تؤدي إلى تحديد هوية شخص معيّن لدى Google.
مزيد من المعلومات عن هذه الإرشادات
جمع بيانات المستخدمين: لا تجمع Performance Monitoring بنفسها أي معلومات تحديد هوية شخصية (PII)، مثل الأسماء أو عناوين البريد الإلكتروني أو أرقام الهواتف. يمكن للمطوّرين جمع بيانات إضافية باستخدام Performance Monitoring من خلال إنشاء سمات مخصّصة في عمليات تتبُّع الرموز البرمجية المخصّصة. يجب ألا تتضمّن هذه البيانات التي يتم جمعها من خلال Performance Monitoring معلومات تحدّد هوية شخص معيّن لدى Google.

في ما يلي مثال على رسالة سجلّ لا تحتوي على معلومات تحديد الهوية الشخصية:
```
trace.putAttribute("experiment", "A");
```
في ما يلي مثال يتضمّن معلومات تحديد هوية شخصية (لا تستخدِم هذا النوع من السمات المخصّصة في تطبيقك):
```
trace.putAttribute("email", user.getEmailAddress());
```
تخضع البيانات التي تكشف عن أي معلومات تحدّد الهوية الشخصية للعملية حذف بدون إشعار.

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();perf_add_custom_attributes.js

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();index.js