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

ב-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 Console או מידע לפתרון בעיות שספציפי לחברה.

במסמכי התיעוד של 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, שבו אפשר לבחור אחת מהאפשרויות הבאות:

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

• ‫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