הגדרת שילובים בסיסיים של התראות עם 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.

במאמרי העזרה של Slack מוסבר איך שולחים הודעות באמצעות התראות לפעילות מאפליקציות אחרות (webhooks).

שלב 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 שציינתם אם באפליקציות לנייד יש בעיות חדשות, בעיות שחזרו או בעיות שמתגברות במהירות.