אחרי כמה שניות, מחפשים קריאה לרשת אל firebaselogging.googleapis.com בכלים למפתחים בדפדפן. נוכחות הקריאה הזו לרשת מראה שהדפדפן שולח נתוני ביצועים ל-Firebase.
אם האפליקציה לא מתעדת ביומן אירועי ביצועים, כדאי לעיין בטיפים לפתרון בעיות.
אם אתם מתחילים להשתמש ב-Performance Monitoring (iOS+ | Android | אינטרנט), הטיפים הבאים לפתרון בעיות יכולים לעזור לכם בבעיות שקשורות לזיהוי ה-SDK ב-Firebase או להצגת נתוני הביצועים הראשונים במסוף Firebase.
הוספת ה-SDK לאפליקציה, אבל עדיין מופיעה הודעת הנחיה להוסיף SDK במסוף
מערכת Firebase יכולה לזהות אם הוספתם בהצלחה את ה-SDK של Performance Monitoring לאפליקציה, כשהיא מקבלת ממנה פרטי אירועים (כמו אינטראקציות עם האפליקציה). בדרך כלל, תוך 10 דקות ממועד הפעלת האפליקציה, תוצג ההודעה 'זוהתה ערכת SDK' בלוח הבקרה Performance במסוף Firebase. לאחר מכן, תוך 30 דקות, הנתונים הראשוניים שעברו עיבוד יוצגו במרכז הבקרה.
אם חלפו יותר מ-10 דקות מאז הוספתם את הגרסה האחרונה של ה-SDK לאפליקציה, ועדיין לא ראיתם שינויים, בדקו את הודעות היומן כדי לוודא ש-Performance Monitoring מתעד אירועים. כדי לפתור את הבעיה של הודעת זיהוי SDK באיחור, אפשר לנסות את שלבי פתרון הבעיות המתאימים שמפורטים בהמשך.
האפליקציה מתעדת אירועים ביומן: שלבים לפתרון בעיות
אם אתם עדיין מפתחים באופן מקומי, נסו ליצור עוד אירועים לאיסוף נתונים:
הצגה של אפליקציית האינטרנט בסביבה מקומית.
יצירת אירועים על ידי טעינת דפי משנה באתר, אינטראקציה עם האפליקציה ו/או הפעלת בקשות רשת. חשוב להשאיר את הכרטיסייה בדפדפן פתוחה למשך 10 שניות לפחות אחרי שהדף נטען.
מוודאים שאובייקט התצורה של Firebase נוסף לאפליקציה בצורה נכונה ושלא שיניתם את האובייקט. באופן ספציפי, כדאי לבדוק את הדברים הבאים:
מזהה אפליקציית האינטרנט ב-Firebase (appId) באובייקט התצורה נכון לאפליקציה. מזהה האפליקציה ב-Firebase מופיע בכרטיס האפליקציות שלך בהגדרות הפרויקט של settings.
אם משהו נראה לא בסדר באובייקט התצורה באפליקציה, נסו את הפעולות הבאות:
מוחקים את אובייקט התצורה שנמצא כרגע באפליקציה.
פועלים לפי ההוראות האלה כדי לקבל אובייקט תצורה חדש ולהוסיף אותו לאפליקציית האינטרנט.
אם ה-SDK מתעד אירועים ונראה שכל ההגדרות תקינות, אבל עדיין לא מופיעה הודעת הזיהוי של ה-SDK או נתונים שעברו עיבוד (אחרי שעתיים), פנו לתמיכה של Firebase.
האפליקציה לא מתעדת אירועים ביומן: שלבים לפתרון בעיות
מוודאים ש-Performance Monitoring SDK מופעל בצורה נכונה באפליקציה.
מוודאים ש-SDK של Performance Monitoringלא מושבת באמצעות הדגל הבא:
performance.instrumentationEnabled
חשוב לוודא שהאחסון במטמון בדפדפן מושבת, אחרת יכול להיות שהדפדפן לא יזהה הגדרות חדשות של מכשירי המדידה.
סוגרים את הכרטיסייה של דף האינטרנט ופותחים אותה מחדש. בודקים שוב אם מתבצע רישום ביומן.
אם הוספתם את ה-SDK של Performance Monitoring לאפליקציה, יכול להיות שתצטרכו להפעיל מחדש את האפליקציה כדי שה-SDK יתחיל לפעול.
במסוף מוצגת ההודעה שה-SDK זוהה, אבל לא מוצגים נתונים
Performance Monitoring מעבד את נתוני אירועי הביצועים לפני שהוא מציג אותם במרכז הבקרה לביצועים.
אם חלפו יותר מ-24 שעות מאז שהופיעה ההודעה 'זוהתה גרסת SDK', ועדיין לא מופיעים נתונים, כדאי לבדוק במרכז הבקרה של סטטוס Firebase אם יש הפסקה זמנית בשירות. אם אין הפסקה זמנית בשירות, פנו לתמיכה של Firebase.
פתרון בעיות כלליות
אם הוספתם את ה-SDK בהצלחה ואתם משתמשים ב-Performance Monitoring באפליקציה, הטיפים הבאים לפתרון בעיות יכולים לעזור לכם לפתור בעיות כלליות שקשורות לתכונות ולכלים של Performance Monitoring.
חשוב לדעת שהמדד Performance Monitoring מתעד את המדד הזמן שחלף מהקליק הראשון עד לאינטראקציה הראשונה רק כשמשתמש לוחץ על דף האינטרנט ב-5 השניות הראשונות אחרי טעינת הדף.
חשוב לוודא שהגדרתם את האפליקציה למדידה של המדד הזה. כדי להשתמש במדד השהיה לאחר קלט ראשוני, צריך לבצע הגדרה ידנית.
באופן ספציפי, צריך להוסיף את ספריית ה-polyfill למדד הזה. הוראות ההתקנה מפורטות במסמכי התיעוד של הספרייה.
חשוב לזכור שלא צריך להוסיף את ספריית ה-polyfill הזו כדי ש-Performance Monitoring ישלח דיווח על מדדים אחרים של אפליקציות אינטרנט.
חסרים נתוני מעקב מותאמים אישית בלוח הבקרה של הביצועים
האם נתוני הביצועים מוצגים עבור נתוני מעקב שנאספו באופן אוטומטי אבל לא עבור נתוני מעקב של קוד מותאם אישית? כדאי לנסות את השלבים הבאים לפתרון בעיות:
בודקים את ההגדרה של מעקב אחר קוד מותאם אישית שנוסף באמצעות Trace API, במיוחד את הדברים הבאים:
השמות של מעקבים אחרי קוד מותאם אישית ומדדים מותאמים אישית חייבים לעמוד בדרישות הבאות: אסור לכלול רווחים לבנים בתחילת השם או בסוף השם, אסור לכלול קו תחתון (_) בתחילת השם, והאורך המקסימלי של השם הוא 32 תווים.
צריך להפעיל ולהפסיק את כל המעקבים. כל מעקב שלא הופעל, לא הופסק או הופסק לפני ההפעלה לא יירשם ביומן.
שימו לב שאם אתם משתמשים בשיטה record(), אין צורך להפעיל או להפסיק את המעקב באופן מפורש.
הדגל הזה קובע אם יתבצע איסוף נתונים של שרטוטים של קוד בהתאמה אישית בלבד (ולא של כל הנתונים).
בודקים את הודעות היומן כדי לוודא ש-Performance Monitoring מתעד את עקבות הקוד המותאמים אישית הצפויים.
אם Performance Monitoring מתעד אירועים ביומן אבל לא מוצגים נתונים אחרי 24 שעות, פנו לתמיכה של Firebase.
חסרים נתונים של בקשות רשת בלוח הבקרה של הביצועים
אם חסרים לכם נתוני בקשות מהרשת, חשוב לדעת את הפרטים הבאים:
Performance Monitoring אוסף באופן אוטומטי מדדים של בקשות לרשת שדווחו על ידי API של הדפדפן. הדוחות האלה לא כוללים בקשות רשת שנכשלו.
בהתאם להתנהגות הקוד וספריות הרשתות שבהן הקוד משתמש, יכול להיות ש-Performance Monitoring ידווח רק על בקשות רשת שהושלמו.
כלומר, יכול להיות שלא ידווחו חיבורי HTTP/S שנשארים פתוחים.
ב-Performance Monitoring יש תמיכה בהתראות לגבי מדדים שחורגים מערכי סף מוגדרים. כדי למנוע בלבול עם ערכי הסף הניתנים להתאמה אישית של מדדי הביצועים, הסרנו את האפשרות להגדיר ערכי סף לבעיות.
מה קרה לפרטים ולמדדים במסוף Firebase?
כדי לשפר את האופן שבו אתם פותרים בעיות, החלפנו את הדפים 'פרטים' ו'מדדים' בממשק משתמש (UI) מרכזי שעוצב מחדש. ממשק המשתמש החדש לפתרון בעיות כולל את אותה פונקציונליות ליבה שכלולה בדף 'פרטים' ובדף 'מדדים'. מידע נוסף על פתרון בעיות זמין במאמר הצגת נתונים נוספים על ניתוח נתונים ספציפי.
למה מספר הדגימות לא זה שציפיתי לו?
ב-Performance Monitoring נאספים נתוני ביצועים ממכשירי המשתמשים באפליקציה. אם לאפליקציה יש הרבה משתמשים או שהיא יוצרת כמות גדולה של פעילות ביצועים, יכול להיות ש-Performance Monitoring יגביל את איסוף הנתונים לקבוצת משנה של מכשירים כדי לצמצם את מספר האירועים שעוברים עיבוד. המגבלות האלה גבוהות מספיק כדי שגם אם מספר האירועים יהיה נמוך יותר, ערכי המדדים עדיין ייצגו את חוויית השימוש של המשתמשים באפליקציה.
כדי לנהל את נפח הנתונים שאנחנו אוספים, Performance Monitoring משתמש באפשרויות הדגימה הבאות:
הגבלת קצב שליחה במכשיר: כדי למנוע ממכשיר לשלוח התפרצויות פתאומיות של מעקבים, אנחנו מגבילים את מספר המעקבים אחר קוד ובקשות רשת שנשלחים מהמכשיר ל-300 אירועים בכל 10 דקות. הגישה הזו מגינה על המכשיר מפני מכשירי מדידה במעגל שיכולים לשלוח כמויות גדולות של נתוני ביצועים, ומונעת ממכשיר יחיד להטות את מדידות הביצועים.
דגימה דינמית: Performance Monitoring אוסף מדי יום מספר מוגבל של מעקבים אחר קוד ומעקבים אחר בקשות לרשת לכל אפליקציה, מכל המשתמשים באפליקציה. קצב דגימה דינמי מאוחזר במכשירים (באמצעות Firebase Remote Config) כדי לקבוע אם מכשיר אקראי צריך לתעד ולשלוח נתוני מעקב. מכשיר שלא נבחר לצורך דגימה לא שולח אירועים. קצב הדגימה הדינמי ספציפי לאפליקציה, והוא משתנה כדי לוודא שהנפח הכולל של הנתונים שנאספים יישאר מתחת למגבלה.
סשנים של משתמשים שולחים נתונים מפורטים נוספים מהמכשיר של המשתמש, ולכן נדרשים יותר משאבים כדי לתעד ולשלוח את הנתונים. כדי למזער את ההשפעה של סשנים של משתמשים, Performance Monitoring עשוי גם להגביל את מספר הסשנים.
הגבלת קצב שליחה בצד השרת: כדי לוודא שהאפליקציות לא חורגות ממגבלת הדגימה, יכול להיות ש-Performance Monitoring ישתמש בדגימה בצד השרת כדי לבטל את שליחת חלק מהאירועים שהתקבלו מהמכשירים. אמנם סוג המגבלה הזה לא משנה את היעילות של המדדים שלנו, אבל הוא עלול לגרום לשינויים קלים בדפוסים, כולל:
מספר העקבות יכול להיות שונה ממספר הפעמים שבהן קטע קוד הופעל.
ל-traces שמקושרים זה לזה בקוד יכול להיות מספר שונה של דגימות.
מה קרה לכרטיסייה בעיות במסוף?
החלפנו את הכרטיסייה 'בעיות' בכרטיסייה 'התראות', שמאפשרת לקבל התראות אוטומטיות כשמגיעים לסף שהגדרתם. לא צריך יותר לבדוק ידנית במסוף Firebase כדי לקבוע את הסטטוס של סף. מידע נוסף על התראות זמין במאמר הגדרת התראות על בעיות בביצועים.
מה קרה לכרטיסיות On Device ו-Network במסוף?
איך אפשר לראות את העקבות שהיו בדפים האלה?
עיצבנו מחדש את הקטע Performance Monitoring במסוף Firebase, כך שכרטיסיית Dashboard תציג את מדדי המפתח ואת כל המעקבים שלכם במרחב אחד. כחלק מהעיצוב החדש, הסרנו את הדפים במכשיר ורשת.
בטבלת המעקב שבחלק התחתון של הכרטיסייה Dashboard מוצגים אותם פרטים שמוצגים בכרטיסיות On device ו-Network, אבל עם כמה תכונות נוספות, כולל היכולת למיין את המעקבים לפי שינוי האחוז של מדד ספציפי. כדי להציג את כל המדדים והנתונים של מעקב ספציפי, לוחצים על שם המעקב בטבלת המעקבים.
אפשר להציג את הטרייסים בכרטיסי המשנה הבאים של טבלת הטרייסים:
מעקב אחר בקשות רשת (מובנות ומותאם אישית) – הכרטיסייה המשנית בקשות רשת
מעקב אחר קוד בהתאמה אישית – הכרטיסייה המשנית מעקבים מותאמים אישית
נתוני מעקב של הפעלת אפליקציה, אפליקציה בחזית, אפליקציה ברקע – הכרטיסייה המשנית נתוני מעקב מותאמים אישית
שרטוטים של רינדור המסך – בכרטיסייה המשנית רינדור המסך
נתוני מעקב אחר טעינת דפים – הכרטיסייה המשנית טעינת דף
פרטים על טבלת המעקב ועל הצגת מדדים ונתונים מופיעים בדף הסקירה הכללית של המסוף (iOS+ | Android | אינטרנט).
למה מספר הפריימים האיטיים והפריימים הקפואים לא תואם לציפיות שלי?
פריימים עם רינדור איטי ופריימים קפואים מחושבים על סמך ההנחה שקצב הרענון של המכשיר הוא 60Hz. אם קצב הרענון של המכשיר נמוך מ-60Hz, זמן העיבוד של כל פריים יהיה איטי יותר כי עיבוד פחות פריימים מתבצע בכל שנייה.
זמני עיבוד איטיים יותר עלולים לגרום לדיווח על יותר פריימים איטיים או קפואים, כי יותר פריימים יעברו עיבוד איטי יותר או יקפאו. עם זאת, אם קצב הרענון של המכשיר גבוה מ-60Hz, זמן הרינדור של כל פריים יהיה מהיר יותר.
כתוצאה מכך, פחות פריימים איטיים או קפואים ידווחו. זוהי הגבלה נוכחית ב-SDK של Performance Monitoring.
איך מוסיפים לאפליקציית האינטרנט את ה-SDK של Performance Monitoring JS (ה-SDK 'העצמאי') שהוא קטן יותר ויש לו מרחבי שמות?
אם Performance Monitoring הוא המוצר היחיד של Firebase באפליקציה שלכם, תוכלו להשתמש ב-SDK העצמאי של Performance Monitoring (ובסקריפט הכותרת המומלץ שבהמשך) אם אתם רוצים:
באמצעות ספרייה במרחב שמות
צמצום גודל חבילת ה-SDK
עיכוב ההפעלה של ה-SDK עד אחרי טעינת הדף
כדי לכלול את ה-SDK העצמאי של Performance Monitoring באפליקציה ולהשהות את האינטראקציה הראשונית שלו עד לאחר טעינת הדף:
הסקריפט שלמעלה טוען את ה-SDK העצמאי באופן אסינכררוני, ולאחר מכן מאתחלל את Firebase אחרי הפעלת האירוע onload של החלון. הטקטיקה הזו מפחיתה את ההשפעה של ה-SDK על מדדי טעינת הדף, כי הדפדפן כבר דיווח על מדדי הטעינה שלו כשאתם מאתחלים את ה-SDK.
מידע על ה-SDK הנפרד של Performance Monitoring ועל סקריפט הכותרת
ערכת ה-SDK העצמאית הזו מותאמת לגודל. לאחר דחיסת Gzip, היא תופסת כ-10KB. הוא כולל את כל הפונקציות של Firebase Performance Monitoring, וגם קבוצה מינימלית של הפונקציות של Firebase Core SDK.
Firebase Performance Monitoring משתמש בממשקי ה-API fetch ו-Promise שלא זמינים בדפדפנים ישנים יותר. הפוליפילים של ממשקי ה-API האלה כלולים ב-SDK הסטנדרטי של Firebase Performance Monitoring JS, אבל הם לא נכללים ב-SDK העצמאי כדי לצמצם את הגודל.
ערכת ה-SDK של Performance Monitoring מסתמכת, בין היתר, על Resource Timing API כדי לקבל מהדפדפן מדדים של טעינה של דפים.
קטע הקוד הבא מפרט את סקריפט הכותרת שכולל את האיפוס של ה-SDK ואז מעכב אותו:
(function(sdkSource,firebaseConfigObject){functionload(f,c){//CreatesascripttagtoloadthestandaloneSDKvarsdkScript=document.createElement('script');//Setsittoanasyncscriptsothatitdoesn't interfere with page loadsdkScript.async=1;//SetsthesourceofthescriptsdkScript.src=f;//Insertsthescriptintotheheadofthepagevars=document.getElementsByTagName('script')[0];s.parentNode.insertBefore(sdkScript,s);}//Callstheloadmethodload(sdkSource);//InitializestheSDKonlywhentheonloadmethodiscalledwindow.addEventListener('load',function(){firebase.initializeApp(firebaseConfigObject).performance();});})(performance_standalone,firebaseConfig);
איפה,
performance_standalone הוא 'https://www.gstatic.com/firebasejs/11.1.0/firebase-performance-standalone.js'
Firebase Performance Monitoring מעבד את נתוני הביצועים שנאספו ברגע שהם מגיעים, וכתוצאה מכך הנתונים מוצגים במסוף Firebase כמעט בזמן אמת. הנתונים המעובדים מוצגים במסוף תוך כמה דקות ממועד האיסוף שלהם, ולכן נקרא התהליך 'כמעט בזמן אמת'.
כדי להפיק תועלת מעבדת נתונים כמעט בזמן אמת, חשוב לוודא שהאפליקציה שלכם משתמשת בגרסת SDK תואמת לזמן אמת.
איך אפשר לקבל נתוני ביצועים כמעט בזמן אמת של האפליקציה?
כדי להפיק תועלת מעיבודי נתונים בזמן אמת כמעט, צריך לוודא רק שהאפליקציה שלכם משתמשת בגרסה של Performance Monitoring SDK שתואמת לעיבוד נתונים בזמן אמת.
אלה גרסאות ה-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 לעבד את הנתונים שלכם כמעט בזמן אמת.
אילו גרסאות של Performance Monitoring SDK נחשבות תואמות בזמן אמת?
אלה גרסאות ה-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 בזמן אמת. עם זאת, הנתונים שלא מהתקופה האחרונה כוללים נתוני ביצועים מכל הגרסאות של האפליקציה.
פנייה לתמיכה של Firebase
אם תפנו לתמיכה של Firebase, תמיד צריך לכלול את מזהה האפליקציה ב-Firebase. מזהה האפליקציה ב-Firebase מופיע בכרטיס Your apps (האפליקציות שלך) בקטע Project settings (הגדרות הפרויקט) ב-settings.