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

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

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

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

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

כדי לבצע ניתוח חזק יותר על סמך מאפיינים, תוכלו לייצא את נתוני הביצועים ל-BigQuery.

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

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

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

מאפייני ברירת מחדל לאפליקציות ל-Apple ול-Android

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

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

בנוסף, בנתוני המעקב אחר בקשות לרשת נאסף גם המאפיין הבא:

סוג MIME

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

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

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

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

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

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

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

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

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

משתמשים ב-Performance Monitoring Trace API (Swift | Obj-C) כדי להוסיף מאפיינים מותאמים אישית למעקב אחר קוד מותאם אישית.

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

שימו לב לנקודות הבאות:

השמות של המאפיינים המותאמים אישית צריכים לעמוד בדרישות הבאות:
- בלי רווחים לבנים בתחילת השורה או בסופה, בלי קו תחתון מוביל (_)
- ללא רווחים
- האורך המקסימלי הוא 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) כפופים למחיקה ללא הודעה מראש.

Swift

הערה: מוצר Firebase הזה לא זמין ביעדים של macOS,‏ Mac Catalyst ו-watchOS.

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

הערה: מוצר Firebase הזה לא זמין ביעדים של macOS,‏ Mac Catalyst ו-watchOS.

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];