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


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

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

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

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

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

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

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

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

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

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

מאפיינים מותאמים אישית ומדדים מותאמים אישית מוצגים במסוף 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 מדדים (כולל מדד ברירת המחדל Duration).

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

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();

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

מעקב אחרי מדדים ספציפיים במרכז הבקרה

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

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

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

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

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

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

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

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

מידע נוסף על הצגת נתונים של עקבות

השלבים הבאים