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

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