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

ב-Firebase יש שתי אפשרויות להגדרת התראות ולשליחתן לערוצי התראות מותאמים אישית.

• (מומלץ) הגדרה ושליחה של התראות בהתאמה אישית לערוצי התראות בהתאמה אישית

  אתם יכולים להשתמש ב-Cloud Monitoring כדי לשלוח התראות בהתאמה אישית מלאה לערוצי התראות בהתאמה אישית על סמך נתונים של Crashlytics ונתוני סשנים של Firebase (אופציונלי) שייצאתם ל-Cloud Logging.

• שליחת התראות ברירת מחדל של Crashlytics לערוצי התראות בהתאמה אישית

  אתם יכולים להשתמש ב-Cloud Functions כדי לשלוח את ההתראות Crashlytics שמוגדרות כברירת מחדל לערוצי התראות מותאמים אישית.

---

(מומלץ) הגדרה ושליחה של התראות בהתאמה אישית לערוצי התראות בהתאמה אישית

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

במקרים כאלה, אפשר להשתמש ב-Cloud Monitoring כדי לשלוח התראות מותאמות אישית לערוצי התראות מותאמים אישית על סמך נתונים מ-Crashlytics (ואופציונלית נתוני סשנים מ-Firebase) שייצאתם אל Cloud Logging.

כדי להשתמש ב-Cloud Monitoring להתראות בהתאמה אישית, צריך להגדיר מדיניות התראות שמתארת את הנסיבות שבהן רוצים לקבל התראה ואת האופן שבו רוצים לקבל אותה.

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

במסמכי Google Cloud אפשר לקרוא מידע נוסף על Cloud Monitoring והתראות, כולל תמחור.

דרישות מוקדמות

1. מוודאים שהפרויקט ב-Firebase מוגדר למינוי Blaze בתשלום לפי שימוש.

2. מגדירים ייצוא ל-Cloud Logging של נתוני Crashlytics ו (אופציונלית) של נתוני סשנים ב-Firebase.

3. מגדירים ערוצי התראות.

הגדרת מדיניות התראות

ההוראות הבאות הן הוראות כלליות. הוראות מפורטות זמינות במסמכי התיעוד של Google Cloud (לדוגמה: יצירת מדיניות התראות מבוססת-מדדים או שימוש ב-PromQL ליצירת מדיניות התראות).

במסגרת הרצת שאילתות, אפשר להגדיר התראה מבוססת-יומן או התראה מבוססת-SQL:

• הגדרת התראה שמבוססת על יומן:

  1. להריץ שאילתה ב-Logs Explorer.

  2. לוחצים על הלחצן הוספת התראה שמופיע.

  3. פועלים לפי ההוראות במסך כדי להוסיף התראה שמבוססת על יומן.

• הגדרת התראה מבוססת-SQL:

  1. מריצים שאילתה ב-Logs Analytics.

  2. לוחצים על הלחצן הוספת התראה שמופיע.

  3. פועלים לפי ההוראות במסך כדי להוסיף התראה מבוססת-SQL.

אפשר גם להגדיר התראות לגבי מדדים מבוססי-יומן באמצעות כלי הגדרת המדיניות במסוף Google Cloud. אפשר לבחור באחת מהאפשרויות הבאות:

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

• ‫PromQL: אתם מספקים שאילתת PromQL למדיניות ההתראות

  דוגמה לשאילתת PromQL

  לדוגמה, נניח שיצרתם שני מדדים שמבוססים על יומנים עבור נתוני הפעלות Crashlytics ו-Firebase שייצאתם:

  • מדד אחד בשם firebase/crashlytics_events עם תווית בשם errorType, וההגדרה שלו היא:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • מדד נוסף בשם firebase/session_events עם תווית eventType, וההגדרה שלו היא:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  הנה דוגמה לשאילתת PromQL שמשתמשת במדדים מבוססי-יומן האלה כדי לשלוח התראה כשהשיעור של משתמשים שלא חוו קריסה יורד מתחת ל-70%:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7

---

שליחת התראות ברירת מחדל של Crashlytics לערוצי התראות מותאמים אישית

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

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

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

מידע נוסף על טיפול בהתראות של Crashlytics באמצעות Cloud Functions for Firebase