מערכת Firebase יכולה לשלוח מגוון Crashlyticsהתראות שמוגדרות כברירת מחדל (ראו את דף הסקירה הכללית בנושא התראות). Firebase מציע שילובים בסיסיים של התראות לשליחת התראות ברירת המחדל של Crashlytics ל-Slack, ל-Jira ול-PagerDuty.
ככלל, כך מגדירים וקובעים את ההגדרות של השילובים האלה במסוף Firebase:
פועלים לפי תהליך העבודה המודרך לכל שירות בכרטיסייה Integrations (שילובים) ב
Project settings (הגדרות הפרויקט).בכרטיס Crashlytics שבכרטיסייה Alerts ב
Project settings , בוחרים את ההגדרה שבה רוצים להשתמש עבור אפליקציות ספציפיות ומגדירים את היעד של התראות אחרות.
בהמשך הדף מוסבר בפירוט איך מגדירים כל אחד מהשילובים הבסיסיים של התראות.
Slack: הגדרת שילוב עם Slack
אחרי שמגדירים את השילוב של Firebase עם Slack, הפרויקט יכול לפרסם במרחב העבודה שלכם ב-Slack בתגובה לאירועים שמדווחים על ידי Crashlytics, כמו בעיות חדשות, בעיות שחזרו או בעיות שמתרחשות בתדירות גבוהה יותר.
שלב 1: הגדרת webhook ב-Slack
לפני שמגדירים את השילוב ב-Firebase, צריך להוסיף ב-Slack webhook נכנס כדי לטפל בתקשורת מ-Firebase.
כדי לדעת איך עושים את זה, אפשר לקרוא את המאמר בנושא שליחת הודעות באמצעות Incoming Webhooks במסמכי התיעוד של Slack.
שלב 2: הגדרת השילוב של Slack במסוף Firebase
אחרי שמגדירים את ה-webhook המתאים, אפשר להגדיר את השילוב של Crashlytics:
נכנסים למסוף Firebase ובוחרים את הפרויקט.
לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט).
לוחצים על הכרטיסייה Integrations (שילובים).
בכרטיס השילוב Slack, לוחצים על התקנה.
מגדירים את השילוב על ידי הגדרת ערכים בשדות הבאים:
Webhook URL: מדביקים את כתובת ה-URL של ה-webhook מדף ההגדרות של Slack.
ערוץ ברירת המחדל: מזינים שם של ערוץ. אפשר לשנות את ברירת המחדל הזו בהמשך לכל אפליקציה או לכל התראה בנפרד.
שם המשתמש שפרסם: מזינים שם לשליחת ההודעות.
לוחצים על אימות ושמירה.
אחרי שתאמתו ותשמרו את השילוב עם Slack, אמורה להופיע הודעת אישור בערוץ ברירת המחדל שבחרתם.
שלב 3: הגדרת ההתראות ב-Slack
אפשר להגדיר התראות לפי אפליקציה וסוג אירוע. לדוגמה, אפשר להשבית את ההתראות באפליקציית הבדיקה או להפנות התראות בעדיפות גבוהה באפליקציית הייצור לערוץ #urgent.
סוגי אירועים
השילוב של Firebase עם Slack מאפשר לשלוח התראות בתגובה לסוגי האירועים הבאים:
בעיות קריטיות חדשות: מופעלות כשהאפליקציה קורסת או כשיש ANR שלא נראו קודם ב-Crashlytics.
בעיות חדשות לא קריטיות: מופעלות כשיש באפליקציה בעיה לא קריטית Crashlytics שלא נראתה בעבר.
בעיות שחזרו: מופעלות כשהאפליקציה קורסת אחרי שסימנתם בעיה כסגורה.
נושאים פופולריים: מופעל כשנושא מתחיל להיות פופולרי.
בעיות עם מהירות גדלה: מופעלות כשסוג מסוים של קריסה או ANR משפיע על אחוז מסוים של משתמשים בפרק זמן של 30 דקות לגרסה נתונה של אפליקציה.
הגדרת ההגדרות של כל אפליקציה
כך מגדירים התראות לכל אפליקציה בפרויקט Firebase:
נכנסים למסוף Firebase ובוחרים את הפרויקט.
לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט).
לוחצים על הכרטיסייה התראות.
עוברים לכרטיס ההתראות Crashlytics. בוחרים את האפליקציה שרוצים להגדיר מהתפריט הנפתח.
בוחרים את ערוץ Slack שאליו רוצים לשלוח התראות לגבי האפליקציה הזו.
לכל סוג התראה, בוחרים מהתפריט הנפתח אם רוצים לשלוח את סוג ההתראה הזה ל-Slack.
חוזרים על השלבים האלה לכל אפליקציה שרוצים להגדיר.
זהו זה! מערכת Firebase תשלח התראות לערוצי Slack שציינתם אם באפליקציות שלכם יש בעיות חדשות, בעיות שחזרו או בעיות שמתרחשות בתדירות גבוהה יותר.
Jira: הגדרת שילוב עם Jira
אחרי שמגדירים את השילוב של Firebase עם Jira, פרויקט Firebase יכול לפרסם בפרויקט Jira בתגובה לאירועים שמדווחים על ידי Crashlytics, כמו בעיות חדשות, בעיות שחזרו או בעיות שמתרחשות בתדירות גבוהה יותר. אפשר גם לקשר בעיות ספציפיות ב-Crashlytics לבעיות ב-Jira.
שלב 1: הכנת Jira לשילוב עם Firebase
יצירת טוקן API (Jira Cloud בלבד)
לפני שמגדירים את השילוב ב-Firebase, צריך ליצור טוקן API ב-Jira Cloud.
במסוף של Jira, פותחים את ההגדרות של טוקנים ל-API.
לוחצים על Create API token (יצירת טוקן API).
חשוב לשמור את טוקן ה-API הזה במקום מאובטח, כי תצטרכו אותו בהמשך.
יצירת סוג בעיה 'באג'
השילוב של Firebase עם Jira יוצר בעיות מהסוג Bug. צריך ליצור את סוג הבעיה הזה בפרויקט Jira (אם הוא עדיין לא קיים).
במסוף Jira, עוברים אל Project Settings (הגדרות הפרויקט).
לוחצים על סוגי בעיות.
לוחצים על הוספת סוג בעיה.
בוחרים באפשרות 'באג' או מזינים אותה באופן ידני.
שלב 2: הגדרת השילוב של Jira במסוף Firebase
מגדירים את השילוב של Jira עם Jira Cloud או עם Jira Server.
Jira Cloud
נכנסים למסוף Firebase ובוחרים את הפרויקט.
לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט).
לוחצים על הכרטיסייה Integrations (שילובים).
בכרטיס השילוב Jira, לוחצים על התקנה.
לוחצים על הגדרת שילוב עם Jira.
מזינים את כתובת ה-URL של פרויקט Jira בפורמט הבא:
https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEYמזינים את כתובת האימייל להתחברות ל-Jira ואת אסימון ה-API.
לוחצים על אימות ושמירה.
Jira Server
נכנסים למסוף Firebase ובוחרים את הפרויקט.
לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט).
לוחצים על הכרטיסייה Integrations (שילובים).
בכרטיס השילוב Jira, לוחצים על התקנה.
לוחצים על הגדרת שילוב עם Jira.
מזינים את כתובת ה-URL של פרויקט Jira בפורמט הבא:
https://SERVER_NAME.com/projects/PROJECT_KEYמזינים את כתובת האימייל להתחברות ל-Jira ואת אסימון ה-API.
לוחצים על אימות ושמירה.
שלב 3: הגדרת ההתראות ב-Jira
אפשר להגדיר התראות לפי אפליקציה וסוג אירוע. לדוגמה, אפשר להשבית את ההתראות באפליקציית הבדיקה או להגדיר שהתראות לגבי אפליקציות שונות יועברו לפרויקטים שונים ב-Jira.
סוגי אירועים
השילוב של Firebase עם Jira מאפשר לשלוח התראות בתגובה לסוגי האירועים הבאים:
בעיות קריטיות חדשות: מופעלות כשהאפליקציה קורסת או כשיש ANR שלא נראו קודם ב-Crashlytics.
בעיות חדשות לא קריטיות: מופעלות כשיש באפליקציה בעיה לא קריטית Crashlytics שלא נראתה בעבר.
בעיות שחזרו: מופעלות כשהאפליקציה קורסת אחרי שסימנתם בעיה כסגורה.
נושאים פופולריים: מופעל כשנושא מתחיל להיות פופולרי.
בעיות עם מהירות גדלה: מופעלות כשסוג מסוים של קריסה או ANR משפיע על אחוז מסוים של משתמשים בפרק זמן של 30 דקות לגרסה נתונה של אפליקציה.
הגדרת ההגדרות של כל אפליקציה
כך מגדירים התראות לכל אפליקציה בפרויקט Firebase:
נכנסים למסוף Firebase ובוחרים את הפרויקט.
לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט).
לוחצים על הכרטיסייה התראות.
עוברים לכרטיס ההתראות Crashlytics. בוחרים את האפליקציה שרוצים להגדיר מהתפריט הנפתח.
בוחרים את הפרויקט ב-Jira שאליו רוצים לשלוח התראות לגבי האפליקציה הזו.
לכל סוג התראה, בוחרים מהתפריט הנפתח אם רוצים לשלוח את סוג ההתראה הזה ל-Jira.
חוזרים על השלבים האלה לכל אפליקציה שרוצים להגדיר.
זהו זה! מערכת Firebase תשלח התראות לפרויקטים שציינתם ב-Jira אם באפליקציות שלכם יזוהו בעיות חדשות, בעיות שחזרו או בעיות שמתרחשות בתדירות גבוהה יותר.
(אופציונלי) קישור בעיות ב-Crashlytics ובעיות ב-Jira
בנוסף לבעיות ב-Jira שנוצרות באופן אוטומטי על ידי Firebase, אפשר לקשר את הבעיות ב-Crashlytics לבעיות קיימות ב-Jira. אפשר גם ליצור קריאה חדשה ב-Jira דרך מסוף Firebase. כדי להשתמש בתכונה הזו, צריך להפעיל קודם את השילוב עם Jira.
עוברים לבעיה ב-Crashlytics שרוצים לקשר לבעיה ב-Jira.
לוחצים על קישור ל-Jira.
לוחצים על יצירת בעיה בפרויקט או מדביקים את כתובת ה-URL של הבעיה ב-Jira או את מפתח הבעיה בשדה שמופיע.
ביטול הקישור של בעיה ב-Crashlytics לבעיה ב-Jira
עוברים לבעיה Crashlytics שרוצים לבטל את הקישור שלה ל-Jira.
לוחצים על בעיה מקושרת.
לוחצים על עוד ואז על ביטול הקישור.
PagerDuty: הגדרת שילוב עם PagerDuty
אחרי שמגדירים את השילוב של Firebase עם PagerDuty, פרויקט Firebase מאפשר ל-PagerDuty לשלוח הודעות לצוות התמיכה בתגובה לאירועים שמדווחים על ידי Crashlytics, כמו בעיות חדשות, בעיות שחזרו או בעיות שמתרחשות בתדירות גבוהה יותר.
שלב 1: הגדרת השילוב של PagerDuty במסוף Firebase
נכנסים למסוף Firebase ובוחרים את הפרויקט.
לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט).
לוחצים על הכרטיסייה Integrations (שילובים).
בכרטיס השילוב PagerDuty, לוחצים על התקנה.
פועלים לפי ההוראות במסך כדי להגדיר את השילוב.
לוחצים על אימות ושמירה.
שלב 2: הגדרת התראות ל-PagerDuty
אפשר להגדיר התראות לפי אפליקציה וסוג אירוע. לדוגמה, אתם יכולים להשבית את ההתראות באפליקציית הבדיקה או להגדיר שהתראות לגבי אפליקציות שונות ינותבו לפרויקטים שונים ב-PagerDuty.
סוגי אירועים
השילוב של Firebase עם PagerDuty מאפשר לשלוח התראות בתגובה לסוגי האירועים הבאים:
בעיות קריטיות חדשות: מופעלות כשהאפליקציה קורסת או כשיש ANR שלא נראו קודם ב-Crashlytics.
בעיות חדשות לא קריטיות: מופעלות כשיש באפליקציה בעיה לא קריטית Crashlytics שלא נראתה בעבר.
בעיות שחזרו: מופעלות כשהאפליקציה קורסת אחרי שסימנתם בעיה כסגורה.
נושאים פופולריים: מופעל כשנושא מתחיל להיות פופולרי.
בעיות עם מהירות גדלה: מופעלות כשסוג מסוים של קריסה או ANR משפיע על אחוז מסוים של משתמשים בפרק זמן של 30 דקות לגרסה נתונה של אפליקציה.
הגדרת ההגדרות של כל אפליקציה
כך מגדירים התראות לכל אפליקציה בפרויקט Firebase:
נכנסים למסוף Firebase ובוחרים את הפרויקט.
לוחצים על ואז בוחרים באפשרות Project Settings (הגדרות הפרויקט).
לוחצים על הכרטיסייה התראות.
עוברים לכרטיס ההתראות Crashlytics. בוחרים את האפליקציה שרוצים להגדיר מהתפריט הנפתח.
בוחרים את השירות ב-PagerDuty שאליו רוצים לשלוח התראות לגבי האפליקציה הזו.
לכל סוג התראה, בוחרים מהתפריט הנפתח אם רוצים לשלוח את סוג ההתראה הזה ל-PagerDuty.
חוזרים על השלבים האלה לכל אפליקציה שרוצים להגדיר.
זהו זה! אם באפליקציות שלכם יש בעיות חדשות, בעיות שחזרו או בעיות שמתרחשות בתדירות גבוהה יותר, Firebase יפרסם באגים בשירות PagerDuty שציינתם.