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

ב-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

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

  • מדד אחד בשם 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