שאלות נפוצות ופתרון בעיות במעקב אחר ביצועים

איך להציג הודעות ביומן של אירועי ביצועים

1. פותחים את הכלים למפתחים בדפדפן (לדוגמה, הכרטיסייה Network בכלי הפיתוח ל-Chrome או Network Monitor ב-Firefox).

2. מרעננים את אפליקציית האינטרנט בדפדפן.

3. בודקים אם יש הודעות שגיאה בהודעות היומן.

4. אחרי כמה שניות, מחפשים קריאה לרשת אל firebaselogging.googleapis.com בכלים למפתחים בדפדפן. אם הקריאה הזו קיימת, סימן שהדפדפן שולח נתוני ביצועים ל-Firebase.

אם האפליקציה לא מתעדת אירועי ביצועים, כדאי לעיין בטיפים לפתרון בעיות.

הוספתי את ה-SDK לאפליקציה, אבל במסוף עדיין כתוב שצריך להוסיף את ה-SDK

מערכת Firebase יכולה לזהות אם הוספתם בהצלחה את ה-SDK של Performance Monitoring לאפליקציה כשהיא מקבלת מידע על אירועים (כמו אינטראקציות עם האפליקציה) מהאפליקציה. בדרך כלל, תוך 10 דקות מהפעלת האפליקציה, מרכז הבקרה של הביצועים במסוף Firebase מציג את ההודעה "SDK detected" (זוהה SDK). אחרי 30 דקות, הנתונים הראשוניים שעובדו יוצגו במרכז הבקרה.

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

ב-Console כתוב שערכת ה-SDK זוהתה, אבל לא מוצגים נתונים

‫Performance Monitoring מעבד את נתוני האירועים של הביצועים לפני שהם מוצגים בלוח הבקרה Performance.

אם עברו יותר מ-24 שעות מאז שהופיעה ההודעה "SDK detected" ועדיין לא מופיעים נתונים, צריך לבדוק בFirebase Status Dashboard אם יש הפסקה ידועה בשירות. אם אין הפסקה, פנו לתמיכה של Firebase.

האפליקציה לא מתעדת אירועי ביצועים

אם אתם לא רואים הודעות ביומן לאירועי ביצועים, נסו את השלבים הבאים לפתרון בעיות:

1. מוודאים שערכת ה-SDK של Performance Monitoring הופעלה בצורה תקינה באפליקציה.

2. מוודאים ש-SDK של Performance Monitoring לא מושבת באמצעות הדגל הבא:

   • performance.instrumentationEnabled

3. חשוב לוודא שהשמירה במטמון של הדפדפן מושבתת, אחרת יכול להיות שהדפדפן לא יקלוט הגדרות חדשות של כלי מדידה.

4. סוגרים את הכרטיסייה של דף האינטרנט ופותחים אותה מחדש. בודקים שוב אם יש רישום ביומן.

   אם הוספתם לאחרונה את ה-SDK של Performance Monitoring לאפליקציה, יכול להיות שתצטרכו להפעיל מחדש את האפליקציה כדי שה-SDK יתחיל לפעול.

5. אם לא מצאתם שום דבר מושבת באפליקציה, פנו לתמיכה של Firebase.

בלוח בקרה לביצועי הענן חסרים נתונים לגבי מהירות התגובה לאינטראקציה ראשונה (FID)

באפליקציות מודרניות לא משתמשים ב-_fid כי מהירות התגובה לאינטראקציה באתר (INP) החליפה את מהירות התגובה לאינטראקציה ראשונה (FID).

כדי לתעד את ה-FID בדפדפנים ישנים יותר:

1. מוסיפים את ה-polyfill של FID מהגרסה הקודמת.

2. מוודאים שהמשתמש יוצר אינטראקציה עם הדף תוך 5 שניות מהטעינה. Performance Monitoring מתעד את ה-FID רק במהלך החלון הזה.

בלוח בקרה לביצועי הענן חסרים נתוני מעקב בהתאמה אישית

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

1. בודקים את ההגדרה של מעקבי קוד בהתאמה אישית שנוספו באמצעות Trace API, ובמיוחד את הדברים הבאים:

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

   שימו לב שאם אתם משתמשים ב-record(), אתם לא צריכים להתחיל או להפסיק את המעקב באופן מפורש.

2. מוודאים שאיסוף הנתונים של Performance Monitoring לא מושבת באמצעות הדגל הבא:

   • performance.dataCollectionEnabled

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

3. בודקים את הודעות היומן כדי לוודא ש-Performance Monitoring מתעד את המעקבים הצפויים של הקוד בהתאמה אישית.

4. אם Performance Monitoring מתעד אירועים, אבל לא מוצגים נתונים אחרי 24 שעות, פנו לתמיכה של Firebase.

לוח בקרה לביצועי הענן חסרים נתונים על בקשות לאחזור מהרשת

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

• ‫Performance Monitoring אוסף באופן אוטומטי מדדים של בקשות לאחזור מהרשת שמדווחות על ידי ה-API של הדפדפן. הדוחות האלה לא כוללים בקשות לאחזור מהרשת שנכשלו.

• בהתאם להתנהגות של הקוד ושל ספריות הרשת שבהן הקוד משתמש, יכול להיות ש-Performance Monitoring ידווח רק על בקשות לאחזור מהרשת שהושלמו. כלומר, יכול להיות שחיבורי HTTP/S שיישארו פתוחים לא ידווחו.

נתוני הבקשות לאחזור מהרשת לא נצברים כמו שצריך

איך Performance Monitoring צובר נתונים של בקשות לאחזור מהרשת לפי תבניות של כתובות URL

אתם יכולים גם לנסות תבניות URL מותאמות אישית.

מה קרה ל"בעיות עיקריות" בכרטיס "ביצועים" בדף הבית של הפרויקט?

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

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

מידע נוסף על התראות זמין במאמר הגדרת התראות לגבי בעיות בביצועים.

מה קרה לאפשרות להגדיר ערכי סף לבעיות במסוף?

ב-Performance Monitoring אפשר להגדיר התראות למדדים שחורגים מסף מסוים. כדי למנוע בלבול עם הספים האלה שניתנים להגדרה למדדי ביצועים, הסרנו את האפשרות להגדיר ספים לבעיות.

מה קרה למידע בקטעים "פרטים" ו"מדדים" במסוף Firebase?

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

למה מספר הדגימות שונה ממה שציפיתי?

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

כדי לנהל את נפח הנתונים שאנחנו אוספים, ב-Performance Monitoring משתמשים באפשרויות הדגימה הבאות:

• הגבלת קצב של יצירת בקשות במכשיר: כדי למנוע ממכשיר לשלוח פרצי יומני מעקב פתאומיים, אנחנו מגבילים את מספר יומני המעקב אחר קוד ויומני מעקב של בקשות לאחזור מהרשת שנשלחים ממכשיר ל-300 אירועים בכל 10 דקות. הגישה הזו מגינה על המכשיר מפני אינסטרומנטציה בלולאה שיכולה לשלוח כמויות גדולות של נתוני ביצועים, ומונעת ממכשיר אחד להטות את מדידות הביצועים.

• דגימה דינמית: Performance Monitoring אוסף מספר מוגבל של יומני מעקב של קוד ויומני מעקב של בקשות לאחזור מהרשת לכל אפליקציה מדי יום, מכל משתמשי האפליקציה. תדירות דגימה דינמית נשלפת במכשירים (באמצעות Firebase Remote Config) כדי לקבוע אם מכשיר אקראי צריך לתעד ולשלוח נתוני מעקב. מכשיר שלא נבחר לדגימה לא שולח אירועים. תדירות הדגימה הדינמית היא ספציפית לאפליקציה, והיא משתנה כדי להבטיח שהנפח הכולל של הנתונים שנאספים לא חורג מהמגבלה.

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

• הגבלת קצב של יצירת בקשות בצד השרת: כדי לוודא שהאפליקציות לא חורגות ממגבלת הדגימה, יכול להיות ש-Performance Monitoring ישתמש בדגימה בצד השרת כדי להשמיט חלק מהאירועים שהתקבלו מהמכשירים. למרות שההגבלה הזו לא משנה את היעילות של המדדים שלנו, היא עלולה לגרום לשינויים קלים בדפוסים, כולל:

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

מה קרה לכרטיסייה בעיות במסוף?

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

מה קרה לכרטיסיות במכשיר ורשת במסוף? איך אפשר לראות את המעקבים שהיו בדפים האלה?

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

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

אפשר לראות את המעקבים בכרטיסיות המשנה הבאות של טבלת המעקבים:

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

כדי לקבל פרטים על טבלת המעקבים ועל הצגת מדדים ונתונים, אפשר להיכנס לדף הסקירה הכללית במסוף (iOS+‎ | Android | אינטרנט).

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

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

איך מוסיפים לאפליקציית האינטרנט את Performance Monitoring JS SDK הקטן יותר, עם מרחב השמות (ה-SDK העצמאי)?

אם Performance Monitoring הוא המוצר היחיד של Firebase באפליקציה, אפשר להשתמש ב-SDK העצמאי של Performance Monitoring (ובסקריפט הכותרת המומלץ שבהמשך) אם רוצים:

• שימוש בספרייה עם מרחב שמות
• הקטנת הגודל של חבילת ה-SDK
• עיכוב ההפעלה של ה-SDK עד לאחר טעינת הדף

כדי לכלול באפליקציה את ערכת ה-SDK העצמאית של Performance Monitoring ולדחות את ההפעלה שלה עד אחרי טעינת הדף:

1. מוסיפים את הסקריפט הבא לכותרת של קובץ האינדקס.
2. חשוב להוסיף את אובייקט ההגדרות האישיות של הפרויקט ב-Firebase של האפליקציה.

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

כאשר:

• ‫performance_standalone הוא 'https://www.gstatic.com/firebasejs/13.1.0/firebase-performance.js'
• ‫firebaseConfig הוא אובייקט ההגדרות האישיות של Firebase באפליקציה

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

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

כמה תבניות URL מותאמות אישית אפשר ליצור?

אפשר ליצור עד 400 תבניות של כתובות URL מותאמות אישית לכל אפליקציה, ועד 100 תבניות של כתובות URL מותאמות אישית לכל דומיין באפליקציה הזו.

מה המשמעות של נתוני ביצועים "כמעט בזמן אמת"?

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

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

איך אפשר לקבל נתוני ביצועים כמעט בזמן אמת לגבי האפליקציה?

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

אלה גרסאות ה-SDK שתואמות לדיווח בזמן אמת:

• ‫iOS – גרסה 7.3.0 ואילך
• ‫tvOS – גרסה 8.9.0 ואילך
• ‫Android – גרסה 19.0.10 ואילך (או Firebase Android BoM גרסה 26.1.0 ואילך)
• אינטרנט – גרסה 7.14.0 ואילך

חשוב לזכור שתמיד מומלץ להשתמש בגרסה העדכנית של ה-SDK, אבל כל גרסה שמופיעה למעלה תאפשר ל-Performance Monitoring לעבד את הנתונים כמעט בזמן אמת.

אילו גרסאות של ה-SDK של Performance Monitoring נחשבות לתואמות לבידינג בזמן אמת?

אלה גרסאות ה-SDK שתואמות לעיבוד נתונים בזמן אמת:

• ‫iOS – גרסה 7.3.0 ואילך
• ‫tvOS – גרסה 8.9.0 ואילך
• ‫Android – גרסה 19.0.10 ואילך (או Firebase Android BoM גרסה 26.1.0 ואילך)
• אינטרנט – גרסה 7.14.0 ואילך

חשוב לזכור שתמיד מומלץ להשתמש בגרסה העדכנית של ה-SDK, אבל כל גרסה שמופיעה למעלה תאפשר ל-Performance Monitoring לעבד את הנתונים כמעט בזמן אמת.

מה יקרה אם לא אעדכן את האפליקציה לגרסת SDK שתואמת לבידינג בזמן אמת?

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

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

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

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

למה אני לא רואה תצוגה בזמן אמת של נתוני הביצועים?

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

• ‫iOS – גרסה 7.3.0 ואילך
• ‫tvOS – גרסה 8.9.0 ואילך
• ‫Android – גרסה 19.0.10 ואילך (או Firebase Android BoM גרסה 26.1.0 ואילך)
• אינטרנט – גרסה 7.14.0 ואילך

חשוב לזכור שתמיד מומלץ להשתמש בגרסה העדכנית של ה-SDK, אבל כל גרסה שמופיעה למעלה תאפשר ל-Performance Monitoring לעבד את הנתונים כמעט בזמן אמת.