שימוש בהתראות של Performance Monitoring כדי להודיע לחברי הפרויקט על שינויים בקוד או על הרשת הבקשות פוגעות בביצועי האפליקציה.
אפשר להגדיר התראות באפליקציה ולהתאים אותן אישית, שיודיעו לכם כש שרמת הביצועים של אירוע חוצה סף מוגדר.
מה מפעיל התראה?
התראה מופעלת כשמדד שקשור לאפליקציה שלכם חוצה סף מסוים להגדיר את האחוזון שצוין (אם רלוונטי) במסוף Firebase. ההתראות מופעלות רק אם האפליקציה שלכם משתמשת בגרסה תואמת של SDK בזמן אמת.
שעת ההפעלה של האפליקציה
כשמגדירים התראה לשעת ההתחלה של האפליקציה, היא מופעלת אם כל התנאים הבאים מתקיימים:
- מערכת Firebase תיעדה לפחות
100 דגימות של_app_start
לעקוב אחר הגרסה האחרונה של האפליקציה בשעה האחרונה. - משך הזמן של המעקב
_app_start
חרג מהסף המוגדר של האפליקציה במהלך השעה האחרונה ובאחוזון שהוגדר. - לא הועלתה בעבר התראה לגבי אותו סף של האפליקציה.
מעקבי קוד בהתאמה אישית
כשמגדירים התראה למדד מותאם אישית למעקב אחרי קוד, ההתראה היא תופעל אם כל התנאים הבאים יתקיימו:
- מערכת Firebase תיעדה לפחות
100 דוגמאות של מעקב הקוד בהתאמה אישית לגרסה האחרונה של האפליקציה בשעה האחרונה. - משך הזמן של המעקב חרג מהסף המוגדר של האפליקציה במהלך בשעה האחרונה ובאחוזון שהוגדר.
- (עבור iOS+ ו-Android בלבד) לא הועלתה בעבר התראה עבור סף זהה בגרסה האחרונה של האפליקציה.
- (לאינטרנט בלבד) לא הועלתה בעבר התראה לגבי אותו סף
ב-
3 הימים האחרונים.
בקשות רשת
כשמגדירים התראה למדד של בקשת רשת, ההתראה מופעלת אם כל התנאים הבאים מתקיימים:
- מערכת Firebase תיעדה לפחות
100 דגימות שתואמות לכתובת ה-URL בכל הגרסאות של האפליקציה בשעה האחרונה. - הערך הנצבר של המדד עבר את הסף שהוגדר במהלך
שעה:
- זמן תגובה: הערך המצטבר חרג מהסף שהוגדר האחוזון המוגדר
- שיעור הצלחה: (ב-iOS+ או ב-Android בלבד) הערך המצטבר ירד מתחת את הסף שהוגדר לכל המשתמשים
- לא הועלתה בעבר התראה לגבי אותו סף
3 ימים .
רינדור מסך
כשמגדירים התראה למדד של עיבוד מסך, ההתראה היא תופעל אם כל התנאים הבאים יתקיימו:
- מערכת Firebase תיעדה לפחות
100 דגימות של מסך רינדור בגרסה העדכנית ביותר של האפליקציה בשעה האחרונה. - הערך המצטבר של המדד חצה את הסף שהוגדר במהלך השעה האחרונה:
- פריימים קפואים: הערך המצטבר חרג מהסף שהוגדר
- פריימים איטיים: הערך המצטבר חרג מהסף שהוגדר
- לא הועלתה בעבר התראה לגבי אותו סף של האפליקציה.
טעינת דפים
כשמגדירים התראה למדד של טעינת דף, ההתראה מופעלת אם כל התנאים הבאים מתקיימים:
- מערכת Firebase רשמה לפחות
100 דגימות של טעינת הדף באפליקציה שלכם בשעה האחרונה. - הערך הנצבר של המדד עבר את הסף שהוגדר במהלך
שעה ולאחוזון המוגדר:
- השהיה לאחר קלט ראשוני: הערך הנצבר חורג מהסף שהוגדר והאחוזון המוגדר
- הצגת התוכן הראשונה (FCP): הערך המצטבר חרג מהסף שהוגדר ומהרבעון העשרונית שהוגדר
- הצגה ראשונה: הערך המצטבר חרג מהסף שהוגדר והאחוזון המוגדר
- לא הועלתה בעבר התראה לגבי אותו סף
3 ימים .
למידע נוסף על הגדרת התראות, אחוזי ברירת מחדל, ושיטות מומלצות להגדרת התראות לסוגים ספציפיים של עקבות ומדדים.
התראות לגבי מדדי ביצועים אחרים או שילובים מובנים של Firebase עם Slack, Jira, וגם PagerDuty אינם זמינים להתראות Performance Monitoring.
קבלת התראות
קבלת התראות ברירת מחדל
כברירת מחדל, מערכת Firebase יכולה לשלוח התראות של Performance Monitoring באימייל.
כדי לקבל התראות Performance Monitoring באמצעות מנגנון ברירת המחדל הזה, צריכה להיות לכם ההרשאה firebaseperformance.config.update
. התפקידים הבאים כוללים את התפקיד הזה
ההרשאה הנדרשת כברירת מחדל:
ההתראות וההגדרות שלהן חלות ברמת הפרויקט. המשמעות היא שכברירת מחדל, בכל חבר בפרויקט (שלא משתייך לקבוצת אימייל ויש לו את ההרשאות הנדרשות לקבלת התראות) יקבל אימייל כשתופעל התראה על ביצועים.
הפעלה או השבתה של התראות בחשבון שלכם
בחשבון שלך, אפשר להפעיל או להשבית התראות של 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.
- מתקינים את ה-CLI של Firebase ונכנסים אליו.
- מפעילים את Cloud Functions for Firebase באמצעות ה-CLI Firebase.
לכתוב ולפרוס פונקציה מתעד אירוע התראה מ-Performance Monitoring ומטפל באירוע מטען ייעודי (payload) (לדוגמה, פרסום פרטי ההתראה בהודעה ב-Discord).
כדי לקבל מידע על כל האירועים של התראות הביצועים שאפשר לתעד, אפשר לעבור אל מאמרי עזרה עבור התראות של מעקב ביצועים.
הסרה אוטומטית של התראות לא חוקיות
Performance Monitoring מאמת את ההתראות כדי לוודא שהנתונים תקינים ושההתראות נמצאות בשימוש פעיל. התראות נחשבות תקפות אם מתקיים אחד מהתנאים הבאים:
- ההתראה נוצרת למזהה משאב שעבורו Performance Monitoring קיבל נתונים ב-90 הימים האחרונים.
- ההתראה נוצרה לאחרונה לגבי תבנית של כתובת URL מותאמת אישית. אחרי שיוצרים של כתובת URL מותאמת אישית ולהגדיר התראה. יש לכם 90 יום לשלוח את הנתונים את הדפוס הזה. אם לא יישלחו נתונים בתקופה של 90 יום, Performance Monitoring מסיר את ההתראה הזו. למידע נוסף על תבניות של כתובות URL מותאמות אישית, אפשר לעיין במאמר נתונים נצברים בדפוסי כתובות URL של לקוחות.
אם אחד מהתנאים האלה לא מתקיים, ההתראה תוסר על ידי Performance Monitoring.
הגדרת התראה
כדי להגדיר התראות של Performance Monitoring, צריך
ההרשאה firebaseperformance.config.update
. התפקידים הבאים כוללים את התפקיד הזה
ההרשאה הנדרשת כברירת מחדל:
אדמין ביצועים ב-Firebase,
אדמין איכות ב-Firebase,
אדמין ב-Firebase,
ופרויקט בעלים או עריכה.
אם עדיין לא עשית את זה, עליך להוסיף את גרסת ה-SDK האחרונה של Performance Monitoring אל באפליקציה שלך. מידע נוסף זמין במדריכים לתחילת העבודה באינטרנט, Android, Apple, וגם פלטפורמות Flutter.
בכל אחת מהאפליקציות הרשומות, משתמשים בטבלת המעקב או בכרטיס הדוח 'מרכז הבקרה' כדי להגדיר התראה לגבי כל מדד שרוצים לעקוב אחריו. לכל אפליקציה יכולה להיות קבוצה שונה של התראות, עם ערך סף שונה לכל אחת (או ללא התראות בכלל).
הגדרת התראה בטבלה 'מעקב'
יש לעבור אל Performance Monitoring מרכז השליטה טאב במסוף Firebase, ולאחר מכן בחר את האפליקציה שעבורה אתה רוצה הגדרת התראה.
גוללים למטה אל טבלת 'מעקב' שבתחתית המסך.
בוחרים כרטיסייה בסוג המעקב שבשבילה רוצים להגדיר התראה. ומוצאים את השורה הרלוונטית.
בקצה השמאלי של השורה, פותחים את תפריט האפשרויות הנוספות (
) ובחירה הגדרת התראות.פועלים לפי ההוראות במסך כדי להגדיר את סף ההתראה, אחוזון (אם רלוונטי) לאפליקציה, או להפעלה/השבתה של ההתראה. ערכי האחוזון שמוגדרים כברירת מחדל הם 90% ל-Android ול-iOS ו-75% לאינטרנט. מידע נוסף על אחוזונים שמוגדרים כברירת מחדל זמין במאמר מעקב אחרי מדדי מפתח במרכז הבקרה.
הגדרת התראה בכרטיס הדוח 'מרכז בקרה'
עוברים לכרטיסייה Performance Monitoring Dashboard במסוף Firebase ובוחרים את האפליקציה שרוצים להגדיר לה התראה.
בכרטיסייה 'כרטיס דוח', מאתרים את כרטיס המדד שעבורו רוצים הגדרת התראה.
בכרטיס המדד הרצוי, פותחים את סמל האפשרויות הנוספות (
) ובוחרים באפשרות הגדרות התראה.פועלים לפי ההוראות במסך כדי להגדיר את סף ההתראה, אחוזון (אם רלוונטי) לאפליקציה, או להפעלה/השבתה של ההתראה. אחוזי ברירת המחדל הם 90 ל-Android ול-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.