Firebase מציע שילובים בסיסיים של התראות לשליחת התראות ל-Slack, Jira ו-PagerDuty.Crashlytics
כך מגדירים וקובעים את ההגדרות של השילובים האלה במסוף Firebase:
פועלים לפי תהליך העבודה המודרך לכל שירות בכרטיסייה Integrations (שילובים) ב
Project settings (הגדרות הפרויקט).בכרטיס Crashlytics שבכרטיסייה Alerts ב
הגדרות הפרויקט , בוחרים את ההגדרה שבה רוצים להשתמש עבור אפליקציות ספציפיות ומגדירים את היעד של התראות אחרות.
בהמשך הדף מוסבר בפירוט איך להגדיר כל אחד מהשילובים הבסיסיים של התראות.
הגדרה של שילוב בסיסי עם 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
אחרי שמגדירים את השילוב של 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
אחרי שמגדירים את השילוב של 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 שציינתם אם באפליקציות שלכם יש בעיות חדשות, בעיות שחזרו או בעיות שמתרחשות בתדירות גבוהה יותר.