הגדרת שילובים בסיסיים של התראות עם Slack,‏ Jira ו-PagerDuty

מערכת Firebase יכולה לשלוח מגוון התראות Crashlytics כברירת מחדל (ראו את דף הסקירה הכללית של ההתראות). ב-Firebase יש שילובי התראות בסיסיים שמאפשרים לשלוח את התראות ברירת המחדל של Crashlytics ל-Slack, ל-Jira ול-PagerDuty.

ככלל, כך מגדירים את השילובים האלה במסוף Firebase:

  1. פועלים לפי תהליך העבודה המפורט של כל שירות התראות בדף Settings > Integrations במסוף Firebase.

  2. בכרטיס Crashlytics בדף הגדרות > התראות במסוף Firebase, בוחרים באיזו הגדרה להשתמש לאפליקציות ספציפיות ומגדירים את היעד של התראות אחרות.


בהמשך הדף מוסבר בפירוט איך להגדיר כל שילוב בסיסי של התראות.

Slack Jira PagerDuty


‫Slack: הגדרת שילוב עם Slack

דוגמה להתראה של Crashlytics בערוץ Slack

אחרי שמגדירים את השילוב של Firebase עם Slack, אפשר לפרסם פוסטים מהפרויקט בסביבת העבודה ב-Slack בתגובה לאירועים שדווחו על ידי Crashlytics, כמו בעיות חדשות, בעיות שחזרו או בעיות שקצב ההתרחשות שלהן גדל.

שלב 1: הגדרת Slack webhook

לפני שמגדירים את השילוב ב-Firebase, צריך להוסיף webhook נכנס ב-Slack כדי לטפל בתקשורת מ-Firebase.

כדי ללמוד איך עושים את זה, קראו את המאמר Sending messages using Incoming Webhooks במרכז העזרה של Slack.

שלב 2: הגדרת השילוב של Slack במסוף Firebase

אחרי שמגדירים את ה-webhook המתאים, אפשר להגדיר את השילוב של Crashlytics:

  1. במסוף Firebase, נכנסים לדף Settings > Integrations.

  2. בכרטיס השילוב של Slack, לוחצים על Install (התקנה).

  3. מגדירים את השילוב על ידי הגדרת ערכים בשדות הבאים:

    • כתובת ה-URL של ה-webhook: מדביקים את כתובת ה-URL של ה-webhook מדף ההגדרות של Slack.

    • ערוץ ברירת המחדל: מזינים שם של ערוץ. אפשר לשנות את ברירת המחדל הזו בהמשך לכל אפליקציה או לכל התראה בנפרד.

    • שם המשתמש המפרסם: מזינים את השם שיוצג כשולח ההודעות.

  4. לוחצים על אימות ושמירה.

אחרי שמאמתים ושומרים את השילוב עם Slack, אמורה להופיע הודעת אישור בערוץ ברירת המחדל שבחרתם.

שלב 3: הגדרת ההתראות ב-Slack

אפשר להגדיר התראות לפי אפליקציה וסוג אירוע. לדוגמה, אתם יכולים להשבית את ההתראות באפליקציית הבדיקה, או להפנות התראות בעדיפות גבוהה באפליקציית הייצור לערוץ #urgent.

סוגי אירועים

השילוב של Firebase עם Slack מאפשר לשלוח התראות בתגובה לסוגי האירועים הבאים:

  • בעיות חמורות חדשות: מופעלות כשמתרחשת באפליקציה קריסה או שגיאת ANR שלא נראתה בעבר ב-Crashlytics.

  • בעיות חדשות לא קריטיות: מופעלות כשמתרחשת באפליקציה בעיה לא קריטית שלא זוהתה בעבר על ידי Crashlytics.

  • בעיות שחזרו: מופעלות כשהאפליקציה קורסת בגלל בעיה שכבר סימנתם כסגורה.

  • בעיות פופולריות: מופעלות כשבעיה מתחילה או הופכת לפופולרית.

  • בעיות שקשורות לעלייה בקצב: מופעלות כשסוג אחד של קריסה או ANR משפיע על אחוז מסוים מהמשתמשים בפרק זמן של 30 דקות בגרסה נתונה של האפליקציה.

קביעת הגדרות לכל אפליקציה

כך מגדירים התראות לכל אפליקציה בפרויקט ב-Firebase:

  1. במסוף Firebase, נכנסים לדף Settings > Alerts.

  2. עוברים לכרטיס ההתראות של Crashlytics. בתפריט הנפתח, בוחרים את האפליקציה שרוצים להגדיר.

  3. בוחרים את הערוץ ב-Slack שאליו רוצים לשלוח התראות לגבי האפליקציה הזו.

  4. לכל סוג של התראה, בוחרים בתפריט הנפתח אם רוצים לשלוח את סוג ההתראה הזה ל-Slack.

  5. חוזרים על השלבים האלה לכל אפליקציה שרוצים להגדיר.

זהו זה! מערכת Firebase תשלח התראות לערוצי Slack שציינתם אם באפליקציות שלכם יש בעיות חדשות, בעיות שחזרו או בעיות שקצב ההתרחשות שלהן גדל.


‫Jira: הגדרת שילוב עם Jira

אחרי שמגדירים את השילוב של Firebase עם Jira, פרויקט Firebase יכול לפרסם בפרויקט Jira בתגובה לדוחות אירועים שדווחו על ידי Crashlytics, כמו בעיות חדשות, בעיות שחזרו או בעיות שקצב הדיווח עליהן גדל. אפשר גם לקשר בעיות ספציפיות ב-Crashlytics לבעיות ב-Jira.

שלב 1: הכנת Jira לשילוב עם Firebase

יצירת אסימון API (ב-Jira Cloud בלבד)

לפני שמגדירים את השילוב ב-Firebase, צריך ליצור אסימון API ב-Jira Cloud.

  1. במסוף Jira, פותחים את הגדרות הטוקנים של ה-API.

  2. לוחצים על יצירת טוקן API.

  3. שומרים את אסימון ה-API במקום מאובטח, כי תצטרכו אותו בהמשך.

יצירת סוג בעיה "באג"

השילוב של Firebase עם Jira יוצר קריאות מסוג Bug. צריך ליצור את סוג הבעיה הזה בפרויקט ב-Jira (אם הוא עדיין לא קיים).

  1. במסוף Jira, עוברים אל Project Settings (הגדרות הפרויקט).

  2. לוחצים על סוגי בעיות.

  3. לוחצים על הוספת סוג בעיה.

  4. בוחרים באפשרות "באג" או מזינים אותה ידנית.

שלב 2: הגדרת השילוב של Jira במסוף Firebase

מגדירים את השילוב של Jira ב-Jira Cloud או ב-Jira Server.

Jira Cloud

  1. במסוף Firebase, נכנסים לדף Settings > Integrations.

  2. בכרטיס השילוב של Jira, לוחצים על Install (התקנה).

  3. לוחצים על הגדרת השילוב עם Jira.

  4. מזינים את כתובת ה-URL של הפרויקט ב-Jira בפורמט הבא: https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEY

  5. מזינים את כתובת האימייל להתחברות ל-Jira ואת אסימון ה-API.

  6. לוחצים על אימות ושמירה.

שרת Jira

  1. במסוף Firebase, נכנסים לדף Settings > Integrations.

  2. בכרטיס השילוב של Jira, לוחצים על Install (התקנה).

  3. לוחצים על הגדרת השילוב עם Jira.

  4. מזינים את כתובת ה-URL של הפרויקט ב-Jira בפורמט הבא: https://SERVER_NAME.com/projects/PROJECT_KEY

  5. מזינים את כתובת האימייל להתחברות ל-Jira ואת אסימון ה-API.

  6. לוחצים על אימות ושמירה.

שלב 3: הגדרת ההתראות ב-Jira

אפשר להגדיר התראות לפי אפליקציה וסוג אירוע. לדוגמה, אתם יכולים להשבית את ההתראות באפליקציית הבדיקה, או להפנות התראות לגבי אפליקציות שונות לפרויקטים שונים ב-Jira.

סוגי אירועים

השילוב של Firebase עם Jira מאפשר לשלוח התראות בתגובה לסוגי האירועים הבאים:

  • בעיות חמורות חדשות: מופעלות כשמתרחשת באפליקציה קריסה או שגיאת ANR שלא נראתה בעבר ב-Crashlytics.

  • בעיות חדשות לא קריטיות: מופעלות כשמתרחשת באפליקציה בעיה לא קריטית שלא זוהתה בעבר על ידי Crashlytics.

  • בעיות שחזרו: מופעלות כשהאפליקציה קורסת בגלל בעיה שכבר סימנתם כסגורה.

  • בעיות פופולריות: מופעלות כשבעיה מתחילה או הופכת לפופולרית.

  • בעיות שקשורות לעלייה בקצב: מופעלות כשסוג אחד של קריסה או ANR משפיע על אחוז מסוים מהמשתמשים בפרק זמן של 30 דקות בגרסה נתונה של האפליקציה.

קביעת הגדרות לכל אפליקציה

כך מגדירים התראות לכל אפליקציה בפרויקט ב-Firebase:

  1. במסוף Firebase, נכנסים לדף Settings > Alerts.

  2. עוברים לכרטיס ההתראות של Crashlytics. בתפריט הנפתח, בוחרים את האפליקציה שרוצים להגדיר.

  3. בוחרים את הפרויקט ב-Jira שאליו רוצים לשלוח התראות לגבי האפליקציה הזו.

  4. לכל סוג של התראה, בוחרים בתפריט הנפתח אם רוצים לשלוח את סוג ההתראה הזה ל-Jira.

  5. חוזרים על השלבים האלה לכל אפליקציה שרוצים להגדיר.

זהו זה! מערכת Firebase תשלח התראות לפרויקטים שציינתם ב-Jira אם באפליקציות שלכם יש בעיות חדשות, בעיות שחזרו או בעיות שמתגברות במהירות.

בנוסף לקריאות ב-Jira שנוצרות באופן אוטומטי על ידי Firebase, אפשר לקשר את הבעיות ב-Crashlytics לקריאות קיימות ב-Jira. אפשר גם ליצור דיווח חדש על בעיה ב-Jira ממסוף Firebase. כדי להשתמש בתכונה הזו, צריך להפעיל את השילוב עם Jira.

  1. עוברים לבעיה ב-Crashlytics שרוצים לקשר לבעיה ב-Jira.

  2. לוחצים על קישור ל-Jira.

  3. לוחצים על Create issue in Project (יצירת קריאה בפרויקט) או מדביקים את כתובת ה-URL או את מפתח הקריאה של Jira בשדה שמופיע.

  1. עוברים אל הבעיה ב-Crashlytics שרוצים לבטל את הקישור שלה ל-Jira.

  2. לוחצים על בעיה מקושרת.

  3. לוחצים על עוד ובוחרים באפשרות ביטול הקישור.


‫PagerDuty: הגדרת שילוב עם PagerDuty

אחרי שמגדירים את השילוב של Firebase עם PagerDuty, פרויקט Firebase מאפשר ל-PagerDuty לשלוח הודעות למשיבים בכוננות בתגובה לאירועים שדווחו על ידי Crashlytics, כמו בעיות חדשות, בעיות שחזרו או בעיות שמתגברות במהירות.

שלב 1: הגדרת השילוב של PagerDuty במסוף Firebase

  1. במסוף Firebase, נכנסים לדף Settings > Integrations.

  2. בכרטיס השילוב של PagerDuty, לוחצים על Install.

  3. פועלים לפי ההוראות במסך כדי להגדיר את השילוב.

  4. לוחצים על אימות ושמירה.

שלב 2: קביעת הגדרות ההתראות ב-PagerDuty

אפשר להגדיר התראות לפי אפליקציה וסוג אירוע. לדוגמה, אתם יכולים להשבית את ההתראות באפליקציית הבדיקה או לנתב התראות לגבי אפליקציות שונות לפרויקטים שונים ב-PagerDuty.

סוגי אירועים

השילוב של Firebase עם PagerDuty מאפשר לשלוח התראות בתגובה לסוגי האירועים הבאים:

  • בעיות חמורות חדשות: מופעלות כשמתרחשת באפליקציה קריסה או שגיאת ANR שלא נראתה בעבר ב-Crashlytics.

  • בעיות חדשות לא קריטיות: מופעלות כשמתרחשת באפליקציה בעיה לא קריטית שלא זוהתה בעבר על ידי Crashlytics.

  • בעיות שחזרו: מופעלות כשהאפליקציה קורסת בגלל בעיה שכבר סימנתם כסגורה.

  • בעיות פופולריות: מופעלות כשבעיה מתחילה או הופכת לפופולרית.

  • בעיות שקשורות לעלייה בקצב: מופעלות כשסוג אחד של קריסה או ANR משפיע על אחוז מסוים מהמשתמשים בפרק זמן של 30 דקות בגרסה נתונה של האפליקציה.

קביעת הגדרות לכל אפליקציה

כך מגדירים התראות לכל אפליקציה בפרויקט ב-Firebase:

  1. במסוף Firebase, נכנסים לדף Settings > Alerts.

  2. עוברים לכרטיס ההתראות של Crashlytics. בתפריט הנפתח, בוחרים את האפליקציה שרוצים להגדיר.

  3. בוחרים את השירות ב-PagerDuty שאליו רוצים לשלוח התראות מהאפליקציה הזו.

  4. לכל סוג של התראה, בוחרים בתפריט הנפתח אם רוצים לשלוח את סוג ההתראה הזה ל-PagerDuty.

  5. חוזרים על השלבים האלה לכל אפליקציה שרוצים להגדיר.

זהו זה! מערכת Firebase תפרסם באגים בשירות PagerDuty שציינתם אם באפליקציות שלכם יש בעיות חדשות, בעיות שחזרו או בעיות שקצב ההתרחשות שלהן גדל.