פתרון בעיות של Crashlytics ושאלות נפוצות

הצגת פורמטים שונים (ולפעמים "וריאציות") עבור בעיות מסוימות בטבלת הבעיות

ייתכן שתבחין בשני פורמטים שונים לבעיות המפורטות בטבלת הבעיות שלך במסוף Firebase. וייתכן שתבחין גם בתכונה הנקראת "וריאנטים" בחלק מהבעיות שלך. הנה למה!

בתחילת 2023, השקנו מנוע ניתוח משופר לקיבוץ אירועים, כמו גם עיצוב מעודכן וכמה תכונות מתקדמות לבעיות חדשות (כמו גרסאות!). עיין בפוסט הבלוג האחרון שלנו לקבלת כל הפרטים, אבל אתה יכול לקרוא להלן עבור הדגשים.

Crashlytics מנתחת את כל האירועים מהאפליקציה שלך (כמו קריסות, קריסות, לא קטלניות ומקרי ANR) ויוצרת קבוצות של אירועים הנקראים בעיות - לכל האירועים בבעיה יש נקודת כשל משותפת.

כדי לקבץ אירועים לבעיות אלו, מנוע הניתוח המשופר בוחן כעת היבטים רבים של האירוע, כולל המסגרות במעקב המחסנית, הודעת החריגה, קוד השגיאה ומאפיינים אחרים של פלטפורמה או סוג שגיאה.

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

הנה מה שתחווה עם השיפורים האלה:

• מטא נתונים מחודשים מוצגים בשורת הבעיה
  עכשיו קל יותר להבין ולבדוק בעיות באפליקציה שלך.

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

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

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

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

כך מתגלגלים השיפורים האלה:

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

• אם אין התאמה, נחיל אוטומטית את אלגוריתם קיבוץ האירועים החכם יותר שלנו על האירוע וניצור בעיה חדשה עם עיצוב המטא-נתונים המחודש.

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

לא רואה מדדים ללא התרסקות ו/או התראות מהירות

אם אינך רואה מדדים ללא קריסות (כמו משתמשים והפעלות ללא קריסות) ו/או התראות על מהירות, ודא שאתה משתמש ב-Crashlytics SDK 11.7.0+.

לא רואה יומני פירורי לחם

אם אינך רואה יומני פירורי לחם , אנו ממליצים לבדוק את תצורת האפליקציה שלך עבור Google Analytics. ודא שאתה עומד בדרישות הבאות:

• הפעלת את Google Analytics בפרויקט Firebase שלך.

• הפעלת שיתוף נתונים עבור Google Analytics. קבל מידע נוסף על הגדרה זו ב'ניהול הגדרות שיתוף הנתונים שלך ב-Analytics'

• הוספת אתהוסיף את Firebase SDK עבור Google Analyticsלאפליקציה שלך. יש להוסיף SDK זה בנוסף ל-Crashlytics SDK.

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

הצגת עקבות מחסנית לא סימבולית עבור אפליקציות אנדרואיד בלוח המחוונים של Crashlytics

אם אתה משתמש ב-Unity IL2CPP ואתה רואה עקבות מחסנית לא סימבולית, נסה את הפעולות הבאות:

1. ודא שאתה משתמש בגרסה 8.6.1 ומעלה של Crashlytics Unity SDK.

2. ודא שאתה מוגדר ומפעיל את הפקודה Firebase CLI crashlytics:symbols:upload כדי ליצור ולהעלות את קובץ הסמלים שלך.

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

האם ניתן להשתמש ב-Crashlytics עם אפליקציות המשתמשות ב-IL2CPP?

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

1. ודא שאתה משתמש בגרסה 8.6.0 ואילך של Crashlytics Unity SDK.

2. השלם את המשימות הדרושות עבור הפלטפורמה שלך:

   • עבור אפליקציות פלטפורמת אפל : אין צורך בפעולות מיוחדות. עבור אפליקציות פלטפורמת אפל, הפלאגין Firebase Unity Editor מגדיר באופן אוטומטי את פרויקט Xcode שלך ​​להעלאת סמלים.

   • עבור אפליקציות Android : ודא שאתה מוגדר ומפעיל את הפקודה Firebase CLI crashlytics:symbols:upload כדי ליצור ולהעלות את קובץ הסמלים שלך.

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

כיצד מחושבים משתמשים ללא קריסה?

הערך ללא קריסה מייצג את אחוז המשתמשים שהיו מעורבים באפליקציה שלך אך לא קרסו במהלך פרק זמן מסוים.

הנה הנוסחה לחישוב אחוז המשתמשים ללא התרסקות. ערכי הקלט שלו מסופקים על ידי Google Analytics.

CRASH_FREE_USERS_PERCENTAGE = 1 - ( CRASHED_USERS / ALL_USERS ) x 100

• כאשר מתרחשת קריסה, Google Analytics שולח סוג אירוע app_exception , ו- CRASHED_USERS מייצג את מספר המשתמשים המשויכים לסוג האירוע הזה.

• ALL_USERS מייצג את המספר הכולל של משתמשים שהיו מעורבים באפליקציה שלך במהלך פרק הזמן שבחרת מהתפריט הנפתח בפינה השמאלית העליונה של מרכז השליטה של ​​Crashlytics.

אחוז המשתמשים ללא קריסות הוא צבירה לאורך זמן , לא ממוצע.

לדוגמה, דמיינו לאפליקציה שלכם שלושה משתמשים; נקרא להם משתמש א', משתמש ב' ומשתמש ג'. הטבלה הבאה מציגה אילו משתמשים היו מעורבים באפליקציה שלך בכל יום ואיזה מהמשתמשים הללו קרסה באותו יום:

• ביום רביעי, אחוז המשתמשים ללא קריסות שלך הוא 50% (1 מכל 2 משתמשים היה ללא קריסות).
  שניים מהמשתמשים שלך עסקו באפליקציה שלך ביום רביעי, אבל רק לאחד מהם (משתמש B) לא היו קריסות.

• במשך היומיים האחרונים, אחוז המשתמשים ללא קריסות שלך הוא 33.3% (1 מתוך 3 משתמשים היה ללא קריסות).
  שלושה מהמשתמשים שלך היו מעורבים באפליקציה שלך במהלך היומיים האחרונים, אבל רק לאחד מהם (משתמש C) לא היו קריסות.

• במשך 3 הימים האחרונים, אחוז המשתמשים ללא קריסות שלך הוא 0% (0 מתוך 3 משתמשים היו ללא קריסות).
  שלושה מהמשתמשים שלך היו מעורבים באפליקציה שלך במהלך שלושת הימים האחרונים, אבל לאפס מהם לא היו קריסות.

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

מי יכול להציג, לכתוב ולמחוק הערות בנושא?

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

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

להלן מתאר את הגישה הנדרשת לצפייה, כתיבה ומחיקה של הערות:

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

  • בעל פרויקט או עורך , מנהל Firebase , מנהל איכות או מנהל מערכת Crashlytics

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

  • Project Viewer , Firebase Viewer , Quality Viewer או Crashlytics Viewer

כיצד מחושבים משתמשים ללא קריסה?

ראה הבנת מדדים ללא קריסות .

מי יכול להציג, לכתוב ולמחוק הערות בנושא?

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

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

להלן מתאר את הגישה הנדרשת לצפייה, כתיבה ומחיקה של הערות:

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

  • בעל פרויקט או עורך , מנהל Firebase , מנהל איכות או מנהל מערכת Crashlytics

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

  • Project Viewer , Firebase Viewer , Quality Viewer או Crashlytics Viewer

האפליקציה משתמשת גם ב-Google Mobile Ads SDK אך לא מקבלת קריסות

אם הפרויקט שלך משתמש ב-Crashlytics לצד Google Mobile Ads SDK, סביר להניח שכתבי הקריסה מתערבים ברישום מטפלי חריגים. כדי לפתור את הבעיה, כבה את דיווח קריסה ב-SDK של מודעות לנייד על ידי קריאה disableSDKCrashReporting .

היכן נמצא מערך הנתונים של BigQuery שלי?

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

מהי בעיה שנסוגה?

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

להלן תרחיש לדוגמה המסביר כיצד Crashlytics מסווג בעיה כרגרסיה:

1. בפעם הראשונה אי פעם, Crashlytics מקבל דוח התרסקות על התרסקות "A". Crashlytics פותחת בעיה מתאימה לאותה התרסקות (גיליון "A").
2. אתה מתקן את הבאג הזה במהירות, סוגר את נושא "A" ואז משחרר גרסה חדשה של האפליקציה שלך.
3. Crashlytics מקבל דיווח נוסף על בעיה "A" לאחר שסגרת את הנושא.
   • אם הדוח הוא מגרסת אפליקציה ש-Cashlytics ידעה עליה כשסגרת את הבעיה (כלומר שהגרסה שלחה דוח קריסה לכל קריסה בכלל), אז Crashlytics לא תתייחס לבעיה כשגרה. הנושא יישאר סגור.
   • אם הדוח הוא מגרסת אפליקציה ש-Cashlytics לא ידעה עליה כשסגרת את הבעיה (כלומר שהגרסה מעולם לא שלחה דוח קריסה עבור קריסה כלשהי), אז Crashlytics מחשיבה את הבעיה כנסגרת ותפתח מחדש את הבעיה .

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

מדוע אני רואה בעיות נסגרות עבור גרסאות אפליקציה ישנות יותר?

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

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

אם אינך רוצה שבעיה תיפתח מחדש עקב אלגוריתם הרגרסיה שלנו, "השתיק" את הבעיה במקום לסגור אותה.

מדוע אפליקציה צריכה לדווח על חריגים שלא נתפסו כקטלים?

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

שים לב שאם תתחיל לדווח על קטלניות, סביר להניח שאחוז המשתמשים ללא התרסקות (CFU) שלך יקטן, אבל מדד CFU יהיה מייצג יותר את חוויות משתמשי הקצה עם האפליקציה שלך.

try
{
    methodThatThrowsMyCustomExceptionType();
}
catch(MyCustomExceptionType exception)
{
    // Print the exception to the Unity console at the error level.
    Debug.LogError(exception);
    // Upload the exception to Crashlytics as a non-fatal event.
    Crashlytics.LogException(exception); // not Debug.LogException
    //
    // Code that handles the exception
    //
}