אפשר להשתמש בהתראות של Performance Monitoring כדי להודיע לחברי הפרויקט אם שינויים בקוד או בקשות לרשת פוגעים בביצועים של האפליקציה.
אתם יכולים להגדיר התראות מותאמות אישית לאפליקציה, שיודיעו לכם כשביצועי אירוע מסוים חוצים סף שהגדרתם.
מה מפעיל התראה?
התראה מופעלת כשערך של מדד לגבי האפליקציה חוצה סף שהגדרתם לאחוזון מסוים (אם רלוונטי) במסוף Firebase. ההתראות מופעלות רק אם האפליקציה שלך משתמשת בגרסת SDK שתואמת לנתונים בזמן אמת.
זמן ההפעלה של האפליקציה
כשמגדירים התראה לגבי זמן ההתחלה של אפליקציה, ההתראה מופעלת אם כל התנאים הבאים מתקיימים:
- מערכת Firebase תיעדה לפחות
100 דגימות של_app_startהמעקב בגרסה האחרונה של האפליקציה בשעה האחרונה. - משך הזמן של
_app_starttrace חרג מהסף שהוגדר לאפליקציה במהלך השעה האחרונה ובאחוזון שהוגדר. - לא הייתה התראה קודמת לגבי אותו סף בגרסה האחרונה של האפליקציה.
עקבות של קוד בהתאמה אישית
כשמגדירים התראה למדד מותאם אישית של מעקב אחר קוד, ההתראה מופעלת אם כל התנאים הבאים מתקיימים:
- מערכת Firebase תיעדה לפחות
100 דגימות של מעקב אחר קוד מותאם אישית בגרסה האחרונה של האפליקציה בשעה האחרונה. - משך התיעוד חרג מהסף שהוגדר לאפליקציה במהלך השעה האחרונה, ומהאחוזון שהוגדר.
- (ל-iOS+ ול-Android בלבד) לא הופקה התראה קודמת לגבי אותו סף בגרסה האחרונה של האפליקציה.
- (לאתרים בלבד) לא הייתה התראה קודמת לגבי אותו סף ב-
3 הימים האחרונים.
בקשות רשת
כשמגדירים התראה למדד של בקשה לאחזור מהרשת, ההתראה מופעלת אם כל התנאים הבאים מתקיימים:
- מערכת Firebase רשמה לפחות
100 דוגמאות שתאמו לתבנית כתובת ה-URL בכל הגרסאות של האפליקציה בשעה האחרונה. - הערך המצטבר של המדד חצה את ערך הסף שהוגדר במהלך השעה האחרונה:
- זמן התגובה: הערך המצטבר חרג מהסף שהוגדר לאחוזון שהוגדר
- שיעור ההצלחה: (ל-iOS+/Android בלבד) הערך המצטבר ירד מתחת לסף שהוגדר אצל כל המשתמשים
- לא הופקה התראה לגבי אותו ערך סף ב-
3 הימים האחרונים.
רינדור המסך
כשמגדירים התראה למדד של עיבוד מסך, ההתראה מופעלת אם כל התנאים הבאים מתקיימים:
- מערכת Firebase תיעדה לפחות
100 דוגמאות של עיבוד מסך בגרסה האחרונה של האפליקציה בשעה האחרונה. - הערך המצטבר של המדד חצה את ערך הסף שהוגדר במהלך השעה האחרונה:
- פריימים שקופאים: הערך המצטבר חרג מהסף שהוגדר
- slow frames: הערך המצטבר חרג מהסף שהוגדר
- לא הייתה התראה קודמת לגבי אותו סף בגרסה האחרונה של האפליקציה.
טעינות דפים
כשמגדירים התראה לגבי מדד של טעינת דף, ההתראה מופעלת אם כל התנאים הבאים מתקיימים:
- מערכת Firebase רשמה לפחות
100 דגימות של טעינת הדף באפליקציה שלך בשעה האחרונה. - הערך המצטבר של המדד חצה את הסף המוגדר במהלך השעה האחרונה, וגם עבור האחוזון שהוגדר:
- השהיה לאחר קלט ראשוני (FID): הערך המצטבר חרג מהסף שהוגדר ומהאחוזון שהוגדר
- הצגת התוכן העיקרי הראשון: הערך המצטבר חרג מהסף שהוגדר ומהאחוזון שהוגדר
- first paint: the aggregated value exceeded the set threshold and the configured percentile
- לא הופקה התראה לגבי אותו ערך סף ב-
3 הימים האחרונים.
מידע נוסף על הגדרת התראות, אחוזונים שמוגדרים כברירת מחדל ושיטות מומלצות להגדרת התראות לסוגים ספציפיים של עקבות ומדדים
התראות לגבי מדדי ביצועים אחרים או לגבי שילובים שהוגדרו במסוף Firebase עם Slack, Jira או PagerDuty לא זמינות להתראות Performance Monitoring.
קבלת התראות
קבלת התראות ברירת מחדל
כברירת מחדל, Firebase יכול לשלוח Performance Monitoring התראות באימייל.
כדי לקבל התראות לגבי Performance Monitoring באמצעות מנגנון ברירת המחדל הזה, צריך לקבל את ההרשאה firebaseperformance.config.update. התפקידים הבאים כוללים את ההרשאה הנדרשת הזו כברירת מחדל:
- אדמין של מעקב אחרי ביצועים ב-Firebase
- אדמין של איכות ב-Firebase
- אדמין ב-Firebase
- בעלי הפרויקט או עריכה בפרויקט
ההתראות וההגדרות שלהן חלות על כל הפרויקט. כלומר, כברירת מחדל, כל חבר בפרויקט יקבל אימייל כשהתראת ביצועים מופעלת. ההתראות נשלחות רק לחברי פרויקט שיש להם הרשאות לקבלת התראות ולכתובות אימייל אישיות (לא לקבוצות של חשבונות כמו קבוצות Google או חשבונות Google Workspace).
הפעלה או השבתה של התראות בחשבון שלכם
בחשבון שלכם, אתם יכולים להפעיל או להשבית את ההתראות של Performance Monitoring בלי שזה ישפיע על חברים אחרים בפרויקט. חשוב לזכור שעדיין צריך את ההרשאות הנדרשות כדי לקבל התראות.
כדי להפעיל או להשבית את ההתראות על Performance Monitoring:
- במסוף Firebase, בפינה השמאלית העליונה, עוברים אל
התראות Firebase . - לאחר מכן, עוברים אל
הגדרות ומגדירים את ההעדפה של החשבון לגבי התראות Performance Monitoring.
הגדרת התראות מתקדמות לשירותי צד שלישי
אפשר גם לשלוח התראות של Performance Monitoring לערוץ ההתראות המועדף של הצוות באמצעות Cloud Functions for Firebase. לדוגמה, אפשר לכתוב פונקציה שתתעד אירוע התראה לגבי זמן הפעלה איטי של אפליקציה, ותפרסם את פרטי ההתראה בשירות של צד שלישי, כמו Discord, Slack או Jira.
כדי להגדיר יכולות מתקדמות של התראות באמצעות Cloud Functions for Firebase, מבצעים את השלבים הבאים:
מגדירים את Cloud Functions for Firebase, שכולל את המשימות הבאות:
- מגדירים סביבת פיתוח ל-Node.js או ל-Python.
- מתקינים את Firebase CLI ונכנסים לחשבון.
- מאתחלים את Cloud Functions for Firebase באמצעות ה-CLI של Firebase.
כתיבה ופריסה של פונקציה שתתעד אירוע התראה מ-Performance Monitoring ותטפל במטען הייעודי (payload) של האירוע (לדוגמה, תפרסם את פרטי ההתראה בהודעה ב-Discord).
כדי לקבל מידע על כל האירועים של התראות על ביצועים שאפשר לתעד, אפשר לעיין במאמרי העזרה בנושא התראות על ביצועים.
הסרה אוטומטית של התראות לא חוקיות
Performance Monitoring מאמת את ההתראות כדי לוודא שהנתונים תקינים ושההתראות נמצאות בשימוש פעיל. התראות נחשבות תקפות אם מתקיים אחד מהתנאים הבאים:
- ההתראה נוצרת עבור מזהה משאב שקיבל נתונים ב-90 הימים האחרונים.Performance Monitoring
- ההתראה נוצרה לאחרונה עבור תבנית כתובת URL מותאמת אישית. אחרי שיוצרים תבנית מותאמת אישית של כתובת URL ומגדירים התראה, יש 90 ימים לשליחת נתונים לגבי התבנית הזו. אם לא יישלחו נתונים בפרק הזמן של 90 יום, Performance Monitoring יסיר את ההתראה הזו. מידע נוסף על תבניות של כתובות URL מותאמות אישית זמין במאמר בנושא צבירת נתונים לפי תבניות של כתובות URL מותאמות אישית.
אם אחד מהתנאים האלה לא מתקיים, Performance Monitoring מסיר את ההתראה.
הגדרת התראה
כדי להגדיר התראות לגבי Performance Monitoring, צריך את ההרשאה firebaseperformance.config.update. ההרשאה הנדרשת הזו כלולה כברירת מחדל בתפקידים הבאים: אדמין של ביצועים ב-Firebase, אדמין של איכות ב-Firebase, אדמין ב-Firebase ובעלים או עורך של הפרויקט.
אם עדיין לא עשיתם את זה, כדאי להוסיף את Performance Monitoring SDK העדכני ביותר לאפליקציה. מידע נוסף זמין במדריכים לתחילת העבודה בפלטפורמות web, Android, Apple ו-Flutter.
בכל אחת מהאפליקציות הרשומות, משתמשים בטבלת העקבות או בכרטיס הדוח בלוח הבקרה כדי להגדיר התראה לכל מדד שרוצים לעקוב אחריו. לכל אפליקציה יכול להיות סט שונה של התראות, שלכל אחת מהן יש סף שונה (או שלא יהיו התראות בכלל).
הגדרת התראה בטבלת המעקב
עוברים לכרטיסייה Performance Monitoring Dashboard במסוף Firebase ובוחרים את האפליקציה שרוצים להגדיר עבורה התראה.
גוללים למטה לטבלת העקבות בתחתית המסך.
בוחרים את הכרטיסייה של סוג העקבות שרוצים להגדיר עבורו התראה, ואז מוצאים את השורה הרלוונטית.
בצד שמאל של השורה, פותחים את תפריט האפשרויות הנוספות () ובוחרים באפשרות הגדרות ההתראות.
פועלים לפי ההוראות במסך כדי להגדיר את סף ההתראה ואת האחוזון (אם רלוונטי) עבור האפליקציה, או כדי להפעיל או להשבית את ההתראה. אחוזי ברירת המחדל הם 90 לאנדרואיד ול-iOS, ו-75 לאינטרנט. מידע נוסף על אחוזונים שמוגדרים כברירת מחדל זמין במאמר מעקב אחרי מדדי מפתח במרכז הבקרה.
הגדרת התראה בכרטיס הדוח 'מרכז בקרה'
עוברים לכרטיסייה Performance Monitoring Dashboard במסוף Firebase ובוחרים את האפליקציה שרוצים להגדיר עבורה התראה.
בכרטיסייה Report card (כרטיס דוח), מאתרים את כרטיס המדד שרוצים להגדיר עבורו התראה.
בכרטיס המדד הרצוי, פותחים את תפריט האפשרויות הנוספות () ובוחרים באפשרות הגדרות התראות.
פועלים לפי ההוראות במסך כדי להגדיר את סף ההתראה ואת האחוזון (אם רלוונטי) עבור האפליקציה, או כדי להפעיל או להשבית את ההתראה. אחוזי ברירת המחדל הם 90 לאנדרואיד ול-iOS, ו-75 לאינטרנט. מידע נוסף על אחוזונים שמוגדרים כברירת מחדל זמין במאמר מעקב אחרי מדדי מפתח במרכז הבקרה.
שיטות מומלצות להגדרת התראת ביצועים
בקשות רשת
מערכת Firebase מצברת את הנתונים מבקשות דומות ברשת לפי תבניות של כתובות URL. התבניות יכולות להיות אחת מהאפשרויות הבאות:
תבניות שהמשתמש מגדיר, שנקראות תבניות URL מותאמות אישית.
תבניות שמקורן ב-Firebase, שנקראות תבניות URL אוטומטיות.
הדפוסים האלה עשויים להשתנות עם הזמן בהתאם להתנהגות השימוש האחרונה באפליקציה.
הגדרת התראות לתבניות של כתובות URL מותאמות אישית
מומלץ להגדיר התראות לכל תבניות כתובות URL מותאמות אישית שהגדרתם. מכיוון שמערכת Firebase מנסה קודם להתאים בקשה לתבנית URL מותאמת אישית, בקשות דומות ממופות באופן עקבי יותר לאותה תבנית URL. כך ההתראות על תבנית כתובת URL מותאמת אישית יהיו משמעותיות ויעילות יותר לצוות שלכם, כי כבר זיהיתם את התבנית הספציפית הזו של בקשות כחשובה לאפליקציה.
הגדרת התראות לתבניות אוטומטיות של כתובות URL
כשמגדירים התראה לתבנית URL אוטומטית, חשוב לוודא שתבנית ה-URL האוטומטית יציבה כבר כמה ימים. חשוב לזכור שתבניות אוטומטיות של כתובות URL עשויות להשתנות לאורך זמן, והגדרות ההתראות לא מועברות לתבניות חדשות של כתובות URL. כתוצאה מכך, יכול להיות שלא תקבלו התראות על הדפוסים שחשובים לכם, או שההתראות יהיו שגויות. אפשר גם ליצור תבנית מותאמת אישית של כתובת URL כדי לוודא שהתבנית הזו יציבה.
טעינות של דפי אינטרנט
מידע על ערכי הסף המומלצים למדידת מדדים באתר מופיע במאמר בנושא Core Web Vitals.
עיבודים של המסך
כדי להבטיח חוויית שימוש אופטימלית באפליקציה, הסשנים של המשתמשים צריכים להיות נקיים מפריימים איטיים וקפואים. Performance Monitoring ממליץ להגדיר התראות לגבי פריימים קפואים שגדולים מ-1% ולהגדיר התראות לגבי פריימים איטיים שגדולים מ-5%. הערכים האלה מוגדרים כברירת מחדל במהלך הגדרת התראות על ביצועים. מידע נוסף על שיעור הפריימים שקופאים ליותר מדי זמן ועל שיטות מומלצות אחרות לשיפור ביצועי האפליקציה זמין בהנחיות של Google Play.