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

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