הוספת מעקב מותאם אישית לקוד של אפליקציה ספציפית


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

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

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

בקוד, מגדירים את ההתחלה והסיום של מעקב קוד בהתאמה אישית באמצעות ממשקי ה-API שסופקו על ידי ערכת ה-SDK למעקב ביצועים.

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

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

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

מאפייני ברירת מחדל, מאפיינים מותאמים אישית ומדדים מותאמים אישית

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

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

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

הוספת מעקבי קוד בהתאמה אישית

שימוש ב-Performance Monitoring Trace API כדי להוסיף עקבות קוד בהתאמה אישית למעקב אחרי קוד אפליקציה ספציפי.

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

  • לאפליקציה יכולים להיות כמה מעקבים של קוד בהתאמה אישית.
  • אפשר להריץ בו-זמנית כמה מעקבים של קוד בהתאמה אישית.
  • שמות של מעקבים אחרי קוד בהתאמה אישית חייבים לעמוד בדרישות הבאות: אסור לכלול רווחים לבנים בתחילת השם או בסוף השם, אסור לכלול קו תחתון (_) בתחילת השם, והאורך המקסימלי הוא 100 תווים.
  • מעקבי קוד בהתאמה אישית תומכים בהוספת מדדים מותאמים אישית ומאפיינים מותאמים אישית.

כדי להתחיל ולעצור מעקב אחר קוד מותאם אישית, צריך לעטוף את הקוד שרוצים לעקוב אחריו בקוד דומה לזה:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

הוספת מדדים מותאמים אישית למעקבי קוד בהתאמה אישית

שימוש ב-Performance Monitoring Trace API כדי להוסיף מדדים מותאמים אישית למעקב אחר קוד מותאם אישית.

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

  • השמות של המדדים המותאמים אישית חייבים לעמוד בדרישות הבאות: אסור לכלול רווחים בתחילת השם או בסוף השם, אסור לכלול קו תחתון (_) בתחילת השם, והאורך המקסימלי הוא 100 תווים.
  • כל מעקב אחר קוד מותאם אישית יכול לתעד עד 32 מדדים (כולל מדד ברירת המחדל משך זמן).

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

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

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

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

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

  • שמות של מאפיינים מותאמים אישית חייבים לעמוד בדרישות הבאות: אסור לכלול רווח לבן בתחילת השם או בסוף השם, אסור לכלול קו תחתון (_) בתחילת השם, והאורך המקסימלי הוא 32 תווים.

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

  • אסור להשתמש במאפיינים מותאמים אישית שמכילים מידע שמזהה אדם מסוים ל-Google.

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

מעקב, הצגה וסינון של נתוני ביצועים

מעקב אחר מדדים ספציפיים בלוח הבקרה

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

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

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

איך משתמשים במרכז הבקרה

הצגת עקבות והנתונים שלהם

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

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

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

מידע נוסף על הצגת נתונים של שרטוטים

השלבים הבאים