Catch up on everthing we announced at this year's Firebase Summit. Learn more

הוסף ניטור מותאם אישית לקוד יישום ספציפי

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

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

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

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

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

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

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

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

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

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

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

השתמש מעקב אחר ביצועי API Trace ( סוויפט | OBJ-C ) כדי להוסיף עקבות קוד אישית כדי לבדוק קוד יישום ספציפי.

שימו לב לדברים הבאים:

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

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

מָהִיר

הערה: מוצר Firebase זו אינו זמין על MacOS, Mac Catalyst, מטרות watchOS.
// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

Objective-C

הערה: מוצר Firebase זו אינו זמין על MacOS, Mac Catalyst, מטרות watchOS.
// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

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

השתמש API Trace מעקב אחר ביצועים ( סוויפט | OBJ-C ) כדי להוסיף ערכים מותאמים אישית עקבות קוד מותאם אישית.

שימו לב לדברים הבאים:

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

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

מָהִיר

הערה: מוצר Firebase זו אינו זמין על MacOS, Mac Catalyst, מטרות watchOS.
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

Objective-C

הערה: מוצר Firebase זו אינו זמין על MacOS, Mac Catalyst, מטרות watchOS.
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

צור תכונות מותאמות אישית עבור עקבות קוד מותאם אישית

השתמש מעקב אחר ביצועי API Trace ( סוויפט | OBJ-C ) כדי להוסיף תכונות מותאמות ל עקבות קוד מותאם אישית.

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

שימו לב לדברים הבאים:

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

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

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

    למידע נוסף על הנחיה זו

מָהִיר

הערה: מוצר Firebase זו אינו זמין על MacOS, Mac Catalyst, מטרות watchOS.
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

הערה: מוצר Firebase זו אינו זמין על MacOS, Mac Catalyst, מטרות watchOS.
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

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

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

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

תמונה של לוח המדדים בלוח המחוונים לניטור הביצועים של Firebase

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

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

למידע נוסף על שימוש בלוח המחוונים .

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

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

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

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

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

הצעדים הבאים

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