התאמה אישית של התראות המהירות

התראות על מהירות השינוי מאפשרות להודיע לצוות שלכם כשבעיה ספציפית גורמת לבעיה דחופה באפליקציה. ב-Crashlytics, בעיה היא קבוצה של קריסות דומות או אירועים של אפליקציה שלא מגיבה (ANR).

פלטפורמות של אפל: גרסה 10.8.0 ואילך | Android: גרסה 18.6.0 ואילך (BoM גרסה 32.6.0 ואילך) | Flutter: גרסה 3.4.5 ואילך | Unity: גרסה 11.7.0 ואילך

מה מפעיל התראה?

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

אתם מגדירים את הסף להתראות על מהירות השינוי במונחים של אחוז המשתמשים ומספר המשתמשים המינימלי שהושפעו מהקריסה או מה-ANR. אפשר להגדיר את ערך הסף באחוזים בין 0% ל-100% מהסשנים. אפשר להגדיר את סף המשתמשים המינימלי לכל מספר שגדול מ-10 או שווה לו. כברירת מחדל, סף ההתראה על מהירות השינוי מוגדר ל-1% מהסשנים ו-25 משתמשים.

התראה מופעלת אם במהלך תקופה של 30 דקות, כל התנאים הבאים מתקיימים:

  • בעיה באפליקציה חורגת מסף האחוזים שהוגדר וחורגת ממספר המשתמשים המינימלי שהוגדר לאפליקציה הזו.
  • באפליקציה יש לפחות 10 משתמשים בתקופת הזמן הזו.
  • לא הוצגה בעבר התראה לגבי הבעיה באפליקציה בגרסה הזו.

הגדרת ספי התראה על מהירות

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

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

  1. נכנסים למסוף Firebase ובוחרים את הפרויקט.

  2. לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט). לוחצים על הכרטיסייה התראות.

  3. עוברים לכרטיס ההתראות Crashlytics ובוחרים בכרטיסייה Velocity Alerts (התראות על מהירות).

  4. הגדרת ספי ההתראה לאפליקציה.

קבלת התראות

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

כברירת מחדל, Firebase יכול לשלוח התראות Crashlytics באימייל. בנוסף, מערכת Firebase יכולה להציג התראות על שינויים מהירים ועל רגרסיות במסוף Firebase.

כדי לקבל התראות של Crashlytics באמצעות מנגנון ברירת המחדל הזה, אתם צריכים את ההרשאה firebase.projects.update. התפקידים הבאים כוללים את ההרשאה הנדרשת הזו כברירת מחדל: אדמין ב-Firebase או בעלים או עורך של הפרויקט.

כברירת מחדל, כל חבר בפרויקט (שיש לו את ההרשאות הנדרשות לקבלת התראות) יקבל אימייל כשהתראה מ-Crashlytics מופעלת.

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

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

  1. נכנסים למסוף Firebase ובוחרים את הפרויקט.

  2. לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט). לוחצים על הכרטיסייה התראות.

  3. עוברים לכרטיס ההתראות Crashlytics ובוחרים בכרטיסייה Velocity Alerts (התראות על מהירות).

  4. מגדירים את העדפות החשבון לגבי התראות על Crashlytics.

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

לגבי התראות Crashlytics, Firebase מציעה מנגנון לשליחת התראות לשירותי הצד השלישי הבאים: Slack, Jira או PagerDuty.

  1. אפשר להגדיר את אפשרויות ההתראה הבסיסיות האלה באמצעות תהליכי עבודה מודרכים בכרטיסייה Integrations (שילובים) בהגדרות הפרויקט.

  2. בוחרים את ההגדרה שבה רוצים להשתמש עבור אפליקציות ספציפיות, ומגדירים את היעד של התראות אחרות בכרטיס Crashlytics של הכרטיסייה Alerts ב Project settings.

שימו לב: אם אתם רוצים יותר שליטה והתאמה אישית בשליחת התראות לכל שירות צד שלישי (לא רק ל-Slack, ל-Jira או ל-PagerDuty), כדאי לעיין בקטע הגדרת התראות מתקדמות לשירותי צד שלישי שמתאר אפשרויות מתקדמות לשליחת התראות.

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

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

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

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

    1. מגדירים סביבת פיתוח ל-Node.js או ל-Python.
    2. מתקינים את Firebase CLI ונכנסים לחשבון.
    3. מאתחלים את Cloud Functions for Firebase באמצעות ה-CLI של Firebase.

  2. כותבים ופורסים פונקציה שתתעד אירוע התראה מ-Crashlytics ותטפל במטען הייעודי (payload) של האירוע (לדוגמה, תפרסם את פרטי ההתראה בהודעה ב-Discord).

כדי לקבל מידע על כל Crashlytics אירועי ההתראות שאפשר לתעד, אפשר לעיין במסמכי העזר בנושא Crashlytics התראות.