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

ב-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. מגדירים ייצוא של נתוני Crashlytics ושל נתוני הסשנים ב-Firebase (אופציונלי) אל Cloud Logging.

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. מתקינים את ה-CLI של Firebase ונכנסים אליו.
   3. מאתחלים את Cloud Functions for Firebase באמצעות ה-CLI של Firebase.

2. כותבים ופורסים פונקציה שמתעדת אירוע התראה מ-Crashlytics ומטפלת במטען הייעודי (payload) של האירוע (לדוגמה, מפרסמת את פרטי ההתראה בהודעה ב-Discord).

כדי לקבל מידע על כל אירועי ההתראות של Crashlytics שאפשר לתעד, קראו את מאמרי העזרה בנושא התראות של Crashlytics.

איך מטפלים בהתראות של Crashlytics באמצעות Cloud Functions for Firebase