Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

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

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

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

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

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

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

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

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

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

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

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

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

השתמש ב-Performance Monitoring Trace API כדי להוסיף עקבות קוד מותאמים אישית כדי לנטר קוד יישום ספציפי.

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

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

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

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace

myTrace.stop();

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()

(אופציונלי) עקוב אחר שיטות ספציפיות באמצעות @AddTrace

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

לדוגמה, אתה יכול ליצור מעקב קוד מותאם אישית בשם onCreateTrace שפועל כאשר קוראים לשיטת onCreate() ‎.

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@Override
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
}

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
}

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

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

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

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

כדי להוסיף מדד מותאם אישית, הוסף שורת קוד דומה לזו הבאה בכל פעם שהאירוע מתרחש. לדוגמה, מדד מותאם אישית זה סופר אירועים הקשורים לביצועים המתרחשים באפליקציה שלך, כגון התאמות והחמצות במטמון (באמצעות שמות אירועים לדוגמה של item_cache_hit ו- item_cache_miss של 1 ).

Java

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace (and log custom metrics)
Item item = cache.fetch("item");
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1);
} else {
    myTrace.incrementMetric("item_cache_miss", 1);
}

myTrace.stop();

Kotlin+KTX

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace (and log custom metrics)
val item = cache.fetch("item")
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1)
} else {
    myTrace.incrementMetric("item_cache_miss", 1)
}

myTrace.stop()

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

השתמש ב-Performance Monitoring Trace API כדי להוסיף תכונות מותאמות אישית לעקבות קוד מותאמות אישית.

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

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

  • שמות עבור מאפיינים מותאמים אישית חייבים לעמוד בדרישות הבאות:

    • אין רווח לבן מוביל או נגרר, אין תו תחתון מוביל ( _ ).
    • אין רווחים
    • האורך המרבי הוא 32 תווים
    • התווים המותרים עבור השם הם AZ , az ו- _ .
  • כל מעקב אחר קוד מותאם אישית יכול להקליט עד 5 תכונות מותאמות אישית.

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

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

Java

Trace trace = FirebasePerformance.getInstance().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();

Kotlin+KTX

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}

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

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

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

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

כדי להוסיף מדד ללוח המדדים שלך, בצע את השלבים הבאים:

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

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

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

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

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

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

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

אתה יכול לגשת לדף פתרון הבעיות בדרכים הבאות:

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

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

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

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

הצעדים הבאים

  • למידע נוסף על שימוש במאפיינים לבחינת נתוני ביצועים.

  • למידע נוסף על איך לעקוב אחר בעיות ביצועים במסוף Firebase.

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

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