Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מָהִיר

// 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

// 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 ערכים (כולל מדד משך ברירת המחדל).

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

מָהִיר

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

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.

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

מָהִיר

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

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

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

הצעדים הבאים

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