הכלי "מעקב אחר ביצועים" אוסף נתוני מעקב כדי לעזור לכם לעקוב אחר ביצועי האפליקציה. נתוני מעקב הם דוח של נתוני ביצועים שנאספו בין שתי נקודות זמן באפליקציה.
אתם יכולים ליצור מעקבים משלכם כדי לעקוב אחרי נתוני ביצועים שמשויכים לקוד ספציפי באפליקציה. באמצעות מעקב אחר קוד בהתאמה אישית, אתם יכולים למדוד כמה זמן לוקח לאפליקציה להשלים משימה ספציפית או קבוצת משימות, למשל טעינה של קבוצת תמונות או שליחת שאילתה למסד הנתונים.
המדד שמוגדר כברירת מחדל למעקב אחר קוד בהתאמה אישית הוא "משך הזמן" (הזמן בין נקודות ההתחלה והסיום של המעקב), אבל אפשר גם להוסיף מדדים מותאמים אישית.
בקוד שלכם, אתם מגדירים את ההתחלה והסיום של מעקב אחר קוד בהתאמה אישית באמצעות ממשקי ה-API שסופקו על ידי Performance Monitoring SDK.
אפשר להתחיל מעקבים בהתאמה אישית בכל שלב אחרי שהם נוצרו, והם thread-safe.
מכיוון שמדד ברירת המחדל שנאסף למעקבים האלה הוא "משך זמן", לפעמים הם נקראים "מעקבי משך זמן".
אפשר לראות את הנתונים מהמעקבים האלה בכרטיסיית המשנה 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).
כדי להוסיף מדד מותאם אישית, מוסיפים שורת קוד דומה לזו שבהמשך בכל פעם שהאירוע מתרחש. לדוגמה, המדד המותאם אישית הזה סופר אירועים שקשורים לביצועים שמתרחשים באפליקציה, כמו מציאה במטמון (cache hit) או ניסיונות חוזרים.
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();
מעקב, צפייה וסינון של נתוני ביצועים
מעקב אחרי מדדים ספציפיים במרכז הבקרה
כדי לראות את המגמות של המדדים העיקריים, אתם יכולים להוסיף אותם ללוח המדדים בחלק העליון של מרכז הבקרה ביצועים. אתם יכולים לזהות במהירות רגרסיות על ידי הצגת שינויים משבוע לשבוע, או לוודא שהשינויים האחרונים בקוד משפרים את הביצועים.
כדי להוסיף מדד ללוח המדדים, נכנסים ללוח הבקרה Performance במסוף Firebase ולוחצים על הכרטיסייה Dashboard. לוחצים על כרטיס מדד ריק ובוחרים מדד קיים כדי להוסיף אותו ללוח. לוחצים על סמל האפשרויות הנוספות (⋮) בכרטיס מדד מאוכלס כדי להחליף או להסיר מדד.
בלוח המדדים מוצגים נתוני המדדים שנאספו לאורך זמן, גם בצורה גרפית וגם כשינוי מספרי באחוזים.
הצגת נתוני המעקב
כדי לראות את המעקבים, נכנסים ללוח הבקרה Performance במסוף Firebase, גוללים למטה לטבלת המעקבים ולוחצים על כרטיסיית המשנה המתאימה. בטבלה מוצגים כמה מדדים מובילים לכל מעקב, ואפשר אפילו למיין את הרשימה לפי השינוי באחוזים של מדד ספציפי.
אם לוחצים על שם של מעקב בטבלת המעקבים, אפשר לעבור בין מסכים שונים כדי לבחון את המעקב ולהתעמק במדדים שמעניינים אתכם. ברוב הדפים, אפשר להשתמש בכפתור סינון (בפינה הימנית העליונה של המסך) כדי לסנן את הנתונים לפי מאפיין, לדוגמה:
- מסננים לפי גרסת האפליקציה כדי לראות נתונים על גרסה קודמת או על הגרסה האחרונה.
- מסננים לפי מכשיר כדי לראות איך האפליקציה פועלת במכשירים ישנים יותר.
- מסננים לפי מדינה כדי לוודא שהמיקום של מסד הנתונים לא משפיע על אזור ספציפי.
מידע נוסף על הצגת נתונים של מעקבים
השלבים הבאים
איך עוקבים אחרי בעיות בביצועים במסוף Firebase
להגדיר התראות על שינויים בקוד שפוגעים בביצועים של האפליקציה. לדוגמה, אתם יכולים להגדיר התראה באימייל לצוות שלכם אם משך הזמן של מעקב אחר קוד מותאם אישית ספציפי חורג מהסף שהגדרתם.