הגדרה של התראות מ-Crashlytics וקבלתן באימייל או במסוף

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

• באפליקציות לנייד (Apple,‏ Android,‏ Flutter ו-Unity):

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

• לאפליקציות אינטרנט:

  • אפשר לקבל התראות באימייל על בעיות חדשות ועל בעיות שחזרו (באמצעות התראות של Cloud Monitoring).
  • התראות מאפליקציית האינטרנט לא נשלחות כברירת מחדל, וצריך להפעיל אותן במסוף Firebase.
  • בשלב הזה, אין תמיכה בהתראות במסוף לאפליקציות אינטרנט.

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

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

בהמשך הדף מוסבר בפירוט איך להגדיר אפשרויות שונות להתראות ברירת המחדל של Crashlytics.

קבלת התראות באימייל ובמסוף

רק חברים ספציפיים בפרויקט יכולים לקבל התראות, ואתם יכולים להפעיל או להשבית את ההתראות בחשבון שלכם.

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

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

ההרשאות הנדרשות כדי לקבל התראות

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

• התראות באפליקציית האינטרנט: מכיוון שההתראות באינטרנט של Crashlytics מבוססות על ההתראות של Cloud Logging, כדי להגדיר ולקבל התראות באימייל באפליקציית האינטרנט צריך את ההרשאות monitoring.alertPolicies.create,‏ monitoring.alertPolicies.update ו-monitoring.notificationChannels.create. התפקידים הבאים כוללים את ההרשאות האלה כברירת מחדל: בעלים או עריכה של פרויקט, או עריכת מעקב.

במאמר אילו הרשאות ותפקידים נדרשים כדי לקבל ולהגדיר התראות של Crashlytics? מופיעה טבלה להשוואה מלאה של ההרשאות הנדרשות.

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

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

1. במסוף Firebase, נכנסים לדף Settings > Alerts.

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

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

קביעת הגדרות ההתראות

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

1. במסוף Firebase, נכנסים לדף Settings > Alerts.

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

3. קובעים את ההגדרות של ההתראה.

---

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

הערה: אין תמיכה בהתראות על קצב התרחשות באפליקציות אינטרנט. כדי לקבל התראות על עלייה חדה בשיעור השגיאות באפליקציות אינטרנט, הגדירו התראות מותאמות אישית באמצעות Cloud Monitoring.

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

חשוב: כדי לקבל התראות על קצב, צריך לוודא שהאפליקציה משתמשת לפחות בגרסאות הבאות של ה-SDK של Crashlytics:
פלטפורמות של אפל: גרסה 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, אדמין ב-Firebase או בעלים או עורך של הפרויקט.

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

1. במסוף Firebase, נכנסים לדף Settings > Alerts.

2. עוברים לכרטיס ההתראות Crashlytics ולוחצים על הכרטיסייה Velocity Alerts.

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