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

אתם יכולים להשתמש בהתראות של 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 alerts.
  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 ומטפלת במטען הייעודי (payload) של האירוע (לדוגמה, פרסום פרטי ההתראה בהודעה ב-Discord).

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

הסרה אוטומטית של התראות לא תקינות

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

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

אם אחד מהתנאים האלה לא מתקיים, Performance Monitoring מסירה את ההתראה.

הגדרת התראה

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

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

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

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

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

  2. גוללים למטה לטבלה Traces בתחתית המסך.

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

  4. בקצה השמאלי של השורה, פותחים את תפריט האפשרויות הנוספות () ובוחרים באפשרות Alert settings.

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

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

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

  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.