הגדרת התראות לגבי בעיות בביצועים

אתם יכולים להשתמש בהתראות 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 דגימות של טעינת הדף באפליקציה שלכם בשעה האחרונה.
  • הערך המצטבר של המדד חצה את הסף שהוגדר במהלך השעה האחרונה ועבור האחוזון שהוגדר:
    • השהיה לאחר קלט ראשוני (FID): הערך המצטבר חרג מהסף שהוגדר ומהרבעון העשרונית שהוגדר
    • הצגת התוכן הראשונה (FCP): הערך המצטבר חרג מהסף שהוגדר ומהרבעון העשרונית שהוגדר
    • first paint: הערך המצטבר חרג מהסף שהוגדר ומאחוזון העשירון שהוגדר
  • לא התקבלה התראה בעבר על אותו סף ב-3 הימים האחרונים.

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

התראות לגבי מדדי ביצועים אחרים או לגבי שילובים מובנים של Firebase עם Slack,‏ Jira ו-PagerDuty לא זמינות בהתראות Performance Monitoring.

קבלת התראות

קבלת התראות ברירת מחדל

כברירת מחדל, Firebase יכול לשלוח התראות Performance Monitoring באימייל.

כדי לקבל התראות Performance Monitoring באמצעות מנגנון ברירת המחדל הזה, צריכה להיות לכם ההרשאה firebaseperformance.config.update. התפקידים הבאים כוללים את ההרשאה הנדרשת הזו כברירת מחדל:

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

הפעלה או השבתה של התראות בחשבון שלכם

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

כדי להפעיל או להשבית את ההתראות של Performance Monitoring:

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

הגדרת התראות מתקדמות לשירותים של צד שלישי

אפשר גם לשלוח התראות Performance Monitoring לערוץ ההתראות המועדף של הצוות באמצעות Cloud Functions for Firebase. לדוגמה, אפשר לכתוב פונקציה שמתעדת אירוע התראה על זמן הפעלה איטי של אפליקציה, ומפרסמת את פרטי ההתראה בשירות של צד שלישי, כמו Discord, ‏ Slack או Jira.

כדי להגדיר יכולות מתקדמות של התראות באמצעות Cloud Functions for Firebase:

  1. הגדרת Cloud Functions for Firebase, כולל המשימות הבאות:

    1. מגדירים סביבת פיתוח ל-Node.js או ל-Python.
    2. מתקינים את ה-CLI של Firebase ונכנסים לחשבון.
    3. מאתחלים את Cloud Functions for Firebase באמצעות ה-CLI של Firebase.
  2. כותבים ופורסים פונקציה שמתעדת אירוע התראה מ-Performance Monitoring ומטפלת בתוכן הייעודי של האירוע (לדוגמה, מפרסמת את פרטי ההתראה בהודעה ב-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.

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

הגדרת התראה בטבלה Traces

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

  2. גוללים למטה לטבלה Traces (מעקב) שבתחתית המסך.

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

  4. בקצה השמאלי של השורה, פותחים את תפריט ההרחבה () ובוחרים באפשרות הגדרות התראות.

  5. פועלים לפי ההוראות במסך כדי להגדיר את סף ההתראה ואת האחוזון (אם רלוונטי) לאפליקציה, או כדי להפעיל או להשבית את ההתראה. ערכי האחוזון שמוגדרים כברירת מחדל הם 90% ל-Android ול-iOS ו-75% לאינטרנט. למידע נוסף על אחוזונים שמוגדרים כברירת מחדל, ראו מעקב אחרי מדדי מפתח במרכז הבקרה.

הגדרת התראה בכרטיס הדוח של מרכז הבקרה

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

  2. בכרטיסייה Report card (דוח), מאתרים את כרטיס המדד שרוצים להגדיר לו התראה.

  3. בכרטיס המדד הרצוי, פותחים את תפריט האפשרויות הנוספות () ובוחרים באפשרות הגדרות התראות.

  4. פועלים לפי ההוראות במסך כדי להגדיר את סף ההתראה ואת האחוזון (אם רלוונטי) לאפליקציה, או כדי להפעיל או להשבית את ההתראה. ערכי האחוזון שמוגדרים כברירת מחדל הם 90% ל-Android ול-iOS ו-75% לאינטרנט. למידע נוסף על אחוזונים שמוגדרים כברירת מחדל, ראו מעקב אחרי מדדי מפתח במרכז הבקרה.

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

בקשות רשת

מערכת Firebase אוספת את הנתונים מבקשות רשת דומות לפי דפוסי כתובות URL, שיכולים להיות מהסוגים הבאים:

הגדרת התראות לגבי תבניות ה-URL בהתאמה אישית

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

הגדרת התראות לגבי תבניות אוטומטיות של כתובות URL

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

טעינות של דפי אינטרנט

כדי לקבל מידע על ערכי הסף המומלצים למדידת מדדי האתר, אפשר לעיין במסמכי העזרה של Core Web Vitals.

רינדור של מסך

כדי להבטיח חוויית שימוש אופטימלית באפליקציה, סשנים של משתמשים צריכים להיות ללא פריימים איטיים וקפואים. Performance Monitoring ממליץ להגדיר התראות על פריימים קפואים בשיעור של יותר מ-1% ולהגדיר התראות על פריימים איטיים בשיעור של יותר מ-5%. הערכים האלה מופיעים בתור הגדרות ברירת המחדל במהלך הגדרת ההתראות על ביצועים. מידע נוסף על פריימים איטיים או קפואים מדי ועל שיטות מומלצות אחרות לשיפור ביצועי האפליקציה זמין במדריך של Google Play.