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


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

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

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

בקוד, מגדירים את ההתחלה והסוף של מעקב קוד בהתאמה אישית באמצעות ממשקי ה-API שסופקו על ידי Performance Monitoring 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 מדדים (כולל מדד ברירת המחדל 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, גוללים למטה אל טבלת העקבות ולוחצים על כרטיסיית המשנה המתאימה. בטבלה מוצגים כמה מדדים מובילים לכל עקבה, ואפשר אפילו למיין את הרשימה לפי אחוז השינוי במדד ספציפי.

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

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

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

השלבים הבאים