סינון נתונים לפי מאפיינים

בעזרת Performance Monitoring, אפשר להשתמש במאפיינים כדי לפלח את נתוני הביצועים ולהתמקד בביצועי האפליקציה בתרחישים שונים בעולם האמיתי.

אחרי שלוחצים על שם של מעקב בטבלת המעקבים (שנמצאת בחלק התחתון של מרכז הבקרה 'ביצועים'), אפשר להציג פירוט של המדדים הרלוונטיים. משתמשים בלחצן Filter (בפינה הימנית העליונה של המסך) כדי לסנן את הנתונים לפי מאפיין, לדוגמה:

תמונה של <span class= נתונים של מעקב אחר ביצועים ב-Firebase שמסוננים לפי מאפיין" />

סינון לפי כתובת ה-URL של הדף כדי להציג נתונים לגבי דף ספציפי באתר
אפשר לסנן לפי סוג החיבור בפועל כדי לראות איך חיבור 3G משפיע על האפליקציה
מסננים לפי מדינה כדי לוודא שמיקום מסד הנתונים לא משפיע על אזור ספציפי

מאפייני ברירת מחדל

Performance Monitoring אוסף באופן אוטומטי מגוון מאפייני ברירת מחדל בהתאם לסוג המעקב.

בנוסף למאפייני ברירת המחדל האלה, אפשר גם ליצור מאפיינים מותאמים אישית במעקב אחר קוד מותאם אישית כדי לפלח נתונים לפי קטגוריות ספציפיות לאפליקציה. לדוגמה, במשחק אפשר לפלח נתונים לפי רמת המשחק.

מאפייני ברירת המחדל שנאספים לאפליקציות אינטרנט

כברירת מחדל, כל הטראסים של אפליקציות אינטרנט אוספים את המאפיינים הבאים:

דפדפן
מדינה
סוג החיבור בפועל
כתובת דף
סטטוס של קובץ שירות (service worker)
סטטוס החשיפה

איסוף נתוני משתמשים

איסוף נתוני משתמשים: Performance Monitoring לא אוסף בעצמו פרטים אישיים מזהים (PII), כמו שמות, כתובות אימייל או מספרי טלפון. מפתחים יכולים לאסוף נתונים נוספים באמצעות Performance Monitoring על ידי יצירת מאפיינים מותאמים אישית במעקב אחר קוד מותאם אישית. אסור שהנתונים האלה שנאספים דרך Performance Monitoring יכילו מידע שמאפשר ל-Google לזהות אדם מסוים.

דוגמה להודעת יומן שלא מכילה פרטים אישיים מזהים:

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

הנה דוגמה למאפיין מותאם אישית שכן מכיל פרטים אישיים מזהים (אין להשתמש בסוג כזה של מאפיין מותאם אישית באפליקציה):

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

נתונים שמכילים פרטים אישיים מזהים (PII) כפופים למחיקה ללא הודעה מראש.

יצירת מאפיינים מותאמים אישית

אפשר ליצור מאפיינים מותאמים אישית בכל אחד מהמקורות של קוד בהתאמה אישית שנוספו למעקב.

משתמשים ב-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());
```
נתונים שמכילים פרטים אישיים מזהים (PII) כפופים למחיקה ללא הודעה מראש.

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