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


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

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

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

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

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

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

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

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

מידע נוסף על צפייה בנתוני המעקב

השלבים הבאים