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 לצד תכונות ברירת המחדל ומדד ברירת המחדל עבור המעקב.

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

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

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

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

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

גרסת אינטרנט 9

import { trace } from "firebase/performance";

const t = trace(perf, "CUSTOM_TRACE_NAME");
t.start();

// Code that you want to trace 
// ...

t.stop();

גרסת אינטרנט 8

const trace = perf.trace("CUSTOM_TRACE_NAME");
trace.start();

// Code that you want to trace 
// ...

trace.stop();

הוסף עקבות קוד מותאמות אישית באמצעות ממשק ה- API של תזמון המשתמש

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

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

גרסת אינטרנט 9

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

גרסת אינטרנט 8

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

שים לב performance בדוגמא לעיל מתייחס לדפדפן window.performance אובייקט.

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

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

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

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

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

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

גרסת אינטרנט 9

import { trace } from "firebase/performance";

async function getInventory(inventoryIds) {
  const t = trace(perf, "inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  t.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  t.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  t.stop();

  return inventoryData;
}

גרסת אינטרנט 8

async function getInventory(inventoryIds) {
  const trace = perf.trace("inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  trace.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  trace.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  trace.stop();

  return inventoryData;
}

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

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

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

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

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

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

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

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

גרסת אינטרנט 9

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();

גרסת אינטרנט 8

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

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

// Read attributes
const traceAttributes = trace.getAttributes();

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

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

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

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

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

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

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

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

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

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

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

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

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

הצעדים הבאים