אפשר לייצא את נתוני Firebase Crashlytics אל BigQuery לצורך ניתוח נוסף. BigQuery מאפשר לנתח את הנתונים באמצעות BigQuery SQL, לייצא אותם לספק ענן אחר ולהשתמש בהם להצגה חזותית וליצירת מרכזי בקרה בהתאמה אישית באמצעות Google Data Studio.
הפעלת הייצוא אל BigQuery
- במסוף Firebase, עוברים אל הדף 'שילובים'.
- בכרטיס BigQuery, לוחצים על קישור.
- פועלים לפי ההוראות במסך כדי להפעיל את הייצוא אל BigQuery.
זה מה שקורה כשמפעילים ייצוא אל BigQuery:
כברירת מחדל, כל האפליקציות בפרויקט שלך מקושרות אל BigQuery האפליקציות שתוסיפו לפרויקט במועד מאוחר יותר יקושרו באופן אוטומטי BigQuery אפשר לקבוע אילו אפליקציות ישלחו נתונים.
מערכת Firebase מגדירה סנכרון יומי של הנתונים מפרויקט Firebase אל BigQuery.
מערכת Firebase מייצאת עותק של הנתונים הקיימים אל BigQuery. המידע הזה כולל טבלה באצווה לכל אפליקציה מקושרת שמכיל את הנתונים מהסנכרון היומי.
אם מפעילים את הייצוא בסטרימינג של Crashlytics אל BigQuery, לכל האפליקציות המקושרות תהיה גם טבלה בזמן אמת שמכילה נתונים שמתעדכנים כל הזמן.
כדי להשבית את הייצוא אל BigQuery, צריך לבטל את הקישור של הפרויקט במסוף Firebase.
אילו נתונים מיוצאים אל BigQuery?
הנתונים של Firebase Crashlytics מיוצאים למערך נתונים של BigQuery בשם firebase_crashlytics
. כברירת מחדל, טבלאות נפרדות ייווצרו בתוך
מערך הנתונים Crashlytics של כל אפליקציה בפרויקט. מערכת Firebase נותנת לשמות הטבלאות שמות על סמך המזהה של האפליקציה, תוך המרה של הנקודות לקוויות תחתונות והוספת שם הפלטפורמה בסוף.
לדוגמה, נתונים של אפליקציה ל-Android עם שם החבילה com.google.test
יופיעו בטבלה בשם com_google_test_ANDROID
. הטבלה המקובצת באצווה מעודכנת
פעם ביום. אם מפעילים ייצוא בסטרימינג של Crashlytics אל
BigQuery, לאחר מכן הנתונים של Crashlytics ישודרו גם בזמן אמת
לטבלה בשם com_google_test_ANDROID_REALTIME
.
כל שורה בטבלה מייצגת אירוע שהתרחש באפליקציה, כולל קריסות, שגיאות לא קטלניות ומקרי ANR.
ייצוא בסטרימינג של Crashlytics אל BigQuery
אפשר לשדר את הנתונים של Crashlytics בזמן אמת באמצעות BigQuery סטרימינג. אפשר להשתמש בו לכל מטרה שדורשת נתונים בזמן אמת, כמו הצגת מידע בלוח בקרה בזמן אמת, צפייה בהשקה בזמן אמת או מעקב אחרי בעיות באפליקציה שמפעילות התראות ותהליכי עבודה מותאמים אישית.
כשמפעילים ייצוא בסטרימינג של Crashlytics אל BigQuery, בנוסף לטבלת האצווה תהיה לכם גם טבלה בזמן אמת. אלה סוגי המודלים הבדלים שעליכם להיות מודעים להם בין הטבלאות:
טבלת באצווה | טבלה 'זמן אמת' |
---|---|
|
|
טבלת האצווה אידיאלית לניתוח לטווח ארוך ולזיהוי מגמות לאורך זמן, כי אנחנו מאחסנים את האירועים באופן עמיד לפני שאנחנו כותבים אותם, ואפשר למלא את הטבלה בנתונים חסרים עד 30 יום. כשאנחנו כותבים נתונים לטבלה בזמן אמת, אנחנו תכתוב אותה מיד ל-BigQuery, כך שזה אידיאלי לשידורים חיים מרכזי שליטה והתראות מותאמות אישית. שתי הטבלאות האלה יכולות להיות בשילוב עם שאילתת רצף תמונות כדי לקבל של שניהם.
כברירת מחדל, תאריך התפוגה של המחיצה בטבלה בזמן אמת הוא 30 יום. שפת תרגום איך לשנות את זה, הגדרת תפוגת המחיצה במסמכי התיעוד בנושא BigQuery.
הפעלת ייצוא סטרימינג של Crashlytics אל BigQuery
- נכנסים לדף Integrations במסוף Firebase.
- בכרטיס BigQuery, לוחצים על Manage (ניהול).
- מסמנים את התיבה Include streaming (הכללת סטרימינג).
הפעולה הזו מאפשרת סטרימינג בכל האפליקציות המקושרות.
מה אפשר לעשות עם הנתונים שיוצאו?
הייצוא אל BigQuery מכיל נתוני קריסה גולמיים, כולל סוג המכשיר, מערכת ההפעלה, חריגות (אפליקציות ל-Android) או שגיאות (אפליקציות ל-Apple), יומני Crashlytics ונתונים אחרים.
בדיקה מדויקת של הנתונים המיוצאים מ-Crashlytics ושל הטבלה שלהם schema בהמשך הדף הזה.
שימוש בתבנית של Data Studio
כדי להפעיל נתונים בזמן אמת בתבנית של Data Studio, פועלים לפי ההוראות במאמר הצגה חזותית של נתוני Crashlytics מיוצאים באמצעות Data Studio.
יצירת תצוגות
אפשר להפוך שאילתות לתצוגות באמצעות ממשק המשתמש של BigQuery. הוראות מפורטות זמינות במאמר יצירת תצוגות במסמכי העזרה של BigQuery.
הרצת שאילתות
הדוגמאות הבאות מדגימות שאילתות שאפשר להריץ נתונים מ-Crashlytics ליצירת דוחות שצוברים בהם נתונים של אירועי קריסה שיהיה קל יותר להבין סיכומים. דוחות מהסוג הזה לא זמינים בלוח הבקרה Crashlytics שבמסוף Firebase, הן יכולות להשלים הניתוח וההבנה של נתוני הקריסה.
דוגמה 1: קריסות לפי יום
אחרי שתיקנתם כמה שיותר באגים, נראה לכם שהצוות שלכם בסוף השבוע מוכן להשיק את האפליקציה החדשה שלך לשיתוף תמונות. לפני כן, כדאי לבדוק מספר הקריסות ביום בחודש האחרון, כדי לוודא שהבאג-באג גרם יציב יותר לאורך זמן.
זוהי דוגמה לשאילתה לאפליקציה ל-Android. באפליקציה ל-iOS, צריך להשתמש במזהה החבילה וב-IOS
(במקום שם החבילה וב-ANDROID
).
SELECT
COUNT(DISTINCT event_id) AS number_of_crashes,
FORMAT_TIMESTAMP("%F", event_timestamp) AS date_of_crashes
FROM
`PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
GROUP BY
date_of_crashes
ORDER BY
date_of_crashes DESC
LIMIT 30;
דוגמה 2: איתור הקריסות שפוגעות בתדירות הגבוהה ביותר
כדי לתת עדיפות לתוכניות הייצור, צריך לאתר את 10 התוכניות המובילות קריסות שמתרחשות באפליקציה. והיא מפיקה שאילתה שמספקת את נקודות נתונים.
זו שאילתה לדוגמה של אפליקציה ל-Android. לאפליקציה ל-iOS, יש להשתמש במזהה החבילה שלה
ו-IOS
(במקום שם החבילה ו-ANDROID
).
SELECT
DISTINCT issue_id,
COUNT(DISTINCT event_id) AS number_of_crashes,
COUNT(DISTINCT installation_uuid) AS number_of_impacted_user,
blame_frame.file,
blame_frame.line
FROM
`PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
WHERE
event_timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(),INTERVAL 168 HOUR)
AND event_timestamp < CURRENT_TIMESTAMP()
GROUP BY
issue_id,
blame_frame.file,
blame_frame.line
ORDER BY
number_of_crashes DESC
LIMIT 10;
דוגמה 3: 10 המכשירים המובילים שמתרסקים
הסתיו הוא העונה לרכישת טלפון חדש! החברה שלכם יודעת גם שזה חדש עונת בעיות ספציפית למכשיר - במיוחד עבור Android. כדי להתחיל העליונות של תאימות, אתם מרכיבים שאילתה שמזהה 10 מכשירים שבהם התרחשו הכי הרבה קריסות בשבוע האחרון (168 שעות).
זו שאילתה לדוגמה של אפליקציה ל-Android. לאפליקציה ל-iOS, יש להשתמש במזהה החבילה שלה
ו-IOS
(במקום שם החבילה ו-ANDROID
).
SELECT
device.model,
COUNT(DISTINCT event_id) AS number_of_crashes
FROM
`PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
WHERE
event_timestamp >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 168 HOUR)
AND event_timestamp < CURRENT_TIMESTAMP()
GROUP BY
device.model
ORDER BY
number_of_crashes DESC
LIMIT 10;
דוגמה 4: סינון לפי מפתח מותאם אישית
אתם מפתחי משחקים שרוצים לדעת באיזה שלב במשחק מתרחשים הכי הרבה קריסות.
כדי לעקוב אחרי הנתונים הסטטיסטיים האלה,
מקש Crashlytics בהתאמה אישית
שנקראה current_level
, ותעדכן אותה בכל פעם שהמשתמש יגיע לרמה חדשה.
Swift
Crashlytics.sharedInstance().setIntValue(3, forKey: "current_level");
Objective-C
CrashlyticsKit setIntValue:3 forKey:@"current_level";
Java
Crashlytics.setInt("current_level", 3);
אחרי שתוסיפו את המפתח הזה לייצוא אל BigQuery, תוכלו לכתוב שאילתה כדי לדווח על התפלגות הערכים של current_level
שמשויכים לכל אירוע התרסקות.
זוהי דוגמה לשאילתה לאפליקציה ל-Android. באפליקציה ל-iOS, צריך להשתמש במזהה החבילה וב-IOS
(במקום שם החבילה וב-ANDROID
).
SELECT
COUNT(DISTINCT event_id) AS num_of_crashes,
value
FROM
`PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
UNNEST(custom_keys)
WHERE
key = "current_level"
GROUP BY
key,
value
ORDER BY
num_of_crashes DESC
דוגמה 5: חילוץ מזהה משתמש
יש לך אפליקציה ל-Android בגישה מוקדמת. רוב המשתמשים שלכם אוהבים את זה, אבל התרחשו מספר חריג של קריסות. כדי להגיע לשורש הבעיה, כותבים שאילתה שמושכת את כל אירועי ההתרסקות של המשתמשים האלה, באמצעות מזהי המשתמשים שלהם.
זוהי דוגמה לשאילתה לאפליקציה ל-Android. באפליקציה ל-iOS, צריך להשתמש במזהה החבילה וב-IOS
(במקום שם החבילה וב-ANDROID
).
SELECT *
FROM
`PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
WHERE
user.id IN ("USER_ID_1", "USER_ID_2", "USER_ID_3")
ORDER BY
user.id
דוגמה 6: חיפוש כל המשתמשים שנתקלו בבעיה ספציפית של קריסה
הצוות שלך שחרר בטעות באג קריטי לקבוצה של בודקי גרסת בטא. הצוות שלך הצליח להשתמש בשאילתה מהדוגמה 'חיפוש התקלות הנפוצות ביותר' שלמעלה כדי לזהות את מזהה הבעיה הספציפית של הקריסה. עכשיו הצוות שלך רוצה להריץ שאילתה כדי לחלץ את רשימת המשתמשים באפליקציה שהושפעו מהקריסה הזו.
זוהי דוגמה לשאילתה לאפליקציה ל-Android. באפליקציה ל-iOS, צריך להשתמש במזהה החבילה וב-IOS
(במקום שם החבילה וב-ANDROID
).
SELECT user.id as user_id
FROM
`PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`
WHERE
issue_id = "ISSUE_ID"
AND application.display_version = "APP_VERSION"
AND user.id != ""
ORDER BY
user.id;
דוגמה 7: מספר המשתמשים שהושפעו מבעיית קריסה, לפי מדינה
הצוות שלכם זיהה באג קריטי במהלך ההשקה של גרסה חדשה. שלך מותר להשתמש בשאילתה "איתור הקריסות הנפוצות ביותר" דוגמה למעלה כדי לזהות את המזהה של בעיית הקריסה הספציפית. עכשיו הצוות שלך רוצה לבדוק אם הקריסה הזו התפשטה למשתמשים במדינות שונות ברחבי העולם.
כדי לכתוב את השאילתה הזו, הצוות שלכם צריך לבצע את הפעולות הבאות:
הפעלת הייצוא של נתוני Google Analytics אל BigQuery. מידע נוסף זמין במאמר ייצוא נתוני פרויקט ל-BigQuery.
צריך לעדכן את האפליקציה כדי להעביר מזהה משתמש ל-SDK של Google Analytics ו-SDK Crashlytics.
Swift
Crashlytics.sharedInstance().setUserIdentifier("123456789"); Analytics.setUserID("123456789");
Objective-C
CrashlyticsKit setUserIdentifier:@"123456789"; FIRAnalytics setUserID:@"12345678 9";
Java
Crashlytics.setUserIdentifier("123456789"); mFirebaseAnalytics.setUserId("123456789");
כותבים שאילתה שמשתמשת בשדה user_id כדי לצרף אירועים במערך הנתונים Google Analytics לתאונות במערך הנתונים Crashlytics.
זוהי דוגמה לשאילתה לאפליקציה ל-Android. באפליקציה ל-iOS, צריך להשתמש במזהה החבילה וב-
IOS
(במקום שם החבילה וב-ANDROID
).SELECT DISTINCT c.issue_id, a.geo.country, COUNT(DISTINCT c.user.id) as num_users_impacted FROM `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID` c INNER JOIN `PROJECT_ID.analytics_TABLE_NAME.events_*` a on c.user.id = a.user_id WHERE c.issue_id = "ISSUE_ID" AND a._TABLE_SUFFIX BETWEEN '20190101' AND '20200101' GROUP BY c.issue_id, a.geo.country, c.user.id
דוגמה 8: 5 הבעיות המובילות עד עכשיו היום
זוהי דוגמה לשאילתה לאפליקציה ל-Android. באפליקציה ל-iOS, צריך להשתמש במזהה החבילה וב-IOS
(במקום שם החבילה וב-ANDROID
).
SELECT
issue_id,
COUNT(DISTINCT event_id) AS events
FROM
`PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID_REALTIME`
WHERE
DATE(event_timestamp) = CURRENT_DATE()
GROUP BY
issue_id
ORDER BY
events DESC
LIMIT
5;
דוגמה 9: 5 הבעיות המובילות מאז DATE, כולל היום
אפשר גם לשלב את הטבלאות של האצווה והטבלאות בזמן אמת עם שאילתת סטיצ'ינג כדי להוסיף מידע בזמן אמת לנתוני האצווה המהימנים. כי event_id
הוא חשבון ראשי
מפתח, אפשר להשתמש בפונקציה DISTINCT event_id
כדי להסיר כפילויות של אירועים נפוצים
בטבלאות.
זוהי דוגמה לשאילתה לאפליקציה ל-Android. באפליקציה ל-iOS, צריך להשתמש במזהה החבילה וב-IOS
(במקום שם החבילה וב-ANDROID
).
SELECT issue_id, COUNT(DISTINCT event_id) AS events FROM ( SELECT issue_id, event_id, event_timestamp FROM `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID_REALTIME` UNION ALL SELECT issue_id, event_id, event_timestamp FROM `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID`) WHERE event_timestamp >= "YYYY_MM_DD" GROUP BY issue_id ORDER BY events DESC LIMIT 5;
הסבר על הסכימה Crashlytics ב-BigQuery
כשמגדירים ייצוא נתונים מ-Crashlytics אל BigQuery, מערכת Firebase מייצאת אירועים מהזמן האחרון (קריסות, שגיאות לא קטלניות ואירועי ANR), כולל אירועים מ-2 ימים לפני הקישור, עם אפשרות למילוי חוסרים עד 30 יום.
מנקודה זו ואילך, עד להשבתת הייצוא, מערכת Firebase תייצא אירועי Crashlytics על בסיס יומי. יכול להיות שיחלפו כמה דקות עד שהנתונים יהיו זמינים ב-BigQuery אחרי כל ייצוא.
מערכי נתונים
Crashlytics יוצר מערך נתונים חדש ב-BigQuery עבור Crashlytics . מערך הנתונים כולל את כל הפרויקט, גם אם הוא כולל מספר אפליקציות.
טבלאות
Crashlytics יוצר טבלה במערך הנתונים לכל אפליקציה בפרויקט, אלא אם ביטלת את ההסכמה לייצוא הנתונים של האפליקציה הזו. השם של Firebase בהתאם למזהה האפליקציה, והנקודות מומרות לקווים תחתונים, שם פלטפורמה שמצורף לסוף.
לדוגמה, נתונים של אפליקציה ל-Android ששם החבילה שלה הוא com.google.test
יופיעו בטבלה בשם com_google_test_ANDROID
, ובנתונים בזמן אמת
(אם הוא מופעל) יופיע בטבלה בשם com_google_test_ANDROID_REALTIME
הטבלאות מכילות קבוצה רגילה של נתוני Crashlytics, בנוסף לכל מפתחות Crashlytics מותאמים אישית שהגדרתם באפליקציה.
שורות
כל שורה בטבלה מייצגת שגיאה שהאפליקציה נתקלה בה.
עמודות
העמודות בטבלה זהות עבור קריסות, שגיאות לא חמורות ומקרי ANR. אם המיקום ייצוא הסטרימינג של Crashlytics אל BigQuery מופעל, ואז הטבלה בזמן אמת תכלול את אותן העמודות כמו הטבלה באצווה. שימו לב שיכול להיות שתראו עמודות בשורות שמייצגות אירועים שאין להם מעקב סטאק.
העמודות בתוך הייצוא מפורטות בטבלה הזו:
שם השדה | סוג הנתונים | תיאור |
---|---|---|
platform |
מחרוזת | הפלטפורמה של האפליקציה כפי שרשומה בפרויקט Firebase (ערכים חוקיים: IOS או ANDROID )
|
bundle_identifier |
מחרוזת | המזהה הייחודי של האפליקציה כפי שהוא רשום בפרויקט Firebase (לדוגמה, com.google.gmail באפליקציות לפלטפורמות של Apple, זהו מזהה החבילה של האפליקציה. באפליקציות ל-Android, זהו שם החבילה של האפליקציה. |
event_id |
מחרוזת | המזהה הייחודי של האירוע |
is_fatal |
בוליאני | האם האפליקציה קרסה |
error_type |
מחרוזת | סוג השגיאה של האירוע (לדוגמה, FATAL , NON_FATAL , ANR וכו') |
issue_id |
מחרוזת | הבעיה שמשויכת לאירוע |
variant_id |
מחרוזת | הווריאנט של הבעיה שמשויך לאירוע הזה לתשומת ליבכם: לא לכל האירועים משויכת וריאציה של הבעיה. |
event_timestamp |
TIMESTAMP | מתי האירוע התרחש |
device |
רשומה | המכשיר שבו התרחש האירוע |
device.manufacturer |
מחרוזת | יצרן המכשיר |
device.model |
מחרוזת | דגם המכשיר |
device.architecture |
מחרוזת | לדוגמה, X86_32 , X86_64 , ARMV7 ,
ARM64 , ARMV7S או ARMV7K |
memory |
רשומה | סטטוס הזיכרון של המכשיר |
memory.used |
INT64 | בייטים מהזיכרון בשימוש |
memory.free |
INT64 | בייטים שנותרו בזיכרון |
storage |
רשומה | האחסון הקבוע של המכשיר |
storage.used |
INT64 | בייטים מנפח האחסון בשימוש |
storage.free |
INT64 | בייטים לנפח האחסון שנותרו |
operating_system |
רשומה | פרטי מערכת ההפעלה במכשיר |
operating_system.display_version |
מחרוזת | גרסת מערכת ההפעלה במכשיר |
operating_system.name |
מחרוזת | שם מערכת ההפעלה במכשיר |
operating_system.modification_state |
מחרוזת | האם המכשיר עבר שינוי (לדוגמה, אפליקציה שנפרצה היא MODIFIED ואפליקציה עם הרשאת Root היא UNMODIFIED ) |
operating_system.type |
מחרוזת | (אפליקציות של Apple בלבד) סוג מערכת ההפעלה שפועלת במכשיר (לדוגמה, IOS , MACOS וכו') |
operating_system.device_type |
מחרוזת | סוג המכשיר (לדוגמה, MOBILE , TABLET , TV וכו'). נקרא גם 'קטגוריית מכשיר' |
application |
רשומה | האפליקציה שבה האירוע נוצר |
application.build_version |
מחרוזת | גרסת ה-build של האפליקציה |
application.display_version |
מחרוזת | |
user |
רשומה | (אופציונלי) מידע שנאסף לגבי משתמש האפליקציה |
user.name |
מחרוזת | (אופציונלי) שם המשתמש |
user.email |
מחרוזת | (אופציונלי) כתובת האימייל של המשתמש |
user.id |
מחרוזת | (אופציונלי) מזהה ספציפי לאפליקציה שמשויך למשתמש |
custom_keys |
רשומה חוזרת | צמדי מפתח/ערך שהמפתח הגדיר |
custom_keys.key |
מחרוזת | מפתח שהוגדר על ידי המפתח |
custom_keys.value |
מחרוזת | ערך שהוגדר על ידי המפתח |
installation_uuid |
מחרוזת | מזהה שמזהה התקנה ייחודית של אפליקציה ומכשיר |
crashlytics_sdk_versions |
מחרוזת | גרסת ה-SDK Crashlytics שבה האירוע נוצר |
app_orientation |
מחרוזת | לדוגמה, PORTRAIT , LANDSCAPE ,
FACE_UP , FACE_DOWN וכו' |
device_orientation |
מחרוזת | לדוגמה, PORTRAIT , LANDSCAPE ,
FACE_UP , FACE_DOWN וכו' |
process_state |
מחרוזת | BACKGROUND או FOREGROUND |
logs |
REPEATED RECORD | הודעות יומן עם חותמות זמן שנוצרו על ידי יומן Crashlytics, אם הוא מופעל |
logs.timestamp |
TIMESTAMP | מתי נוצר היומן |
logs.message |
מחרוזת | ההודעה ביומן |
breadcrumbs |
REPEATED RECORD | חותמת זמן Google Analytics נתיבי ניווט, אם הוא מופעל |
breadcrumbs.timestamp |
TIMESTAMP | חותמת הזמן המשויכת למסלול הניווט |
breadcrumbs.name |
מחרוזת | השם המשויך למסלול הניווט |
breadcrumbs.params |
REPEATED RECORD | פרמטרים שמשויכים לנתיב הניווט |
breadcrumbs.params.key |
מחרוזת | מפתח פרמטר שמשויך לנתיב הניווט |
breadcrumbs.params.value |
מחרוזת | ערך פרמטר שמשויך לנתיב הניווט |
blame_frame |
רשומה | המסגרת שזוהתה כגורם לקריסה או לשגיאה |
blame_frame.line |
INT64 | מספר השורה של קובץ המסגרת |
blame_frame.file |
מחרוזת | שם קובץ המסגרת |
blame_frame.symbol |
מחרוזת | סמל 'שתיית מים' או הסמל הגולמי אם הם לא מתכלים |
blame_frame.offset |
INT64 | היסט הבייט בתוך התמונה הבינארית שמכילה את הקוד לא מוגדר בחריגות של Java |
blame_frame.address |
INT64 | הכתובת בתמונה הבינארית שמכילה את הקוד לא הוגדרה למסגרות Java |
blame_frame.library |
מחרוזת | השם המוצג של הספרייה שכוללת את המסגרת |
blame_frame.owner |
מחרוזת | לדוגמה, DEVELOPER , VENDOR ,
RUNTIME , PLATFORM או SYSTEM |
blame_frame.blamed |
בוליאני | אם Crashlytics קבע שהפריים הזה הוא הגורם לקריסה או לשגיאה |
exceptions |
REPEATED RECORD | (Android בלבד) חריגים שהתרחשו במהלך האירוע הזה. בתוך עץ החריגות מוצגות בסדר כרונולוגי הפוך, כלומר הרשומה האחרונה היא החריגה הראשונה שנדחתה |
exceptions.type |
מחרוזת | סוג החריגה (לדוגמה, java.lang.IllegalStateException) |
exceptions.exception_message |
מחרוזת | הודעה שמשויכת לחריגה |
exceptions.nested |
בוליאני | True לכולם חוץ מהחריגה האחרונה (כלומר, הרשומה הראשונה) |
exceptions.title |
מחרוזת | כותרת השרשור |
exceptions.subtitle |
מחרוזת | כותרת המשנה של השרשור |
exceptions.blamed |
בוליאני | הערך true אם Crashlytics קובע שהחריגה אחראית לשגיאה או לקריסה |
exceptions.frames |
רשומה חוזרת | המסגרות שמשויכות אל החריג |
exceptions.frames.line |
INT64 | מספר השורה של קובץ המסגרת |
exceptions.frames.file |
מחרוזת | שם קובץ המסגרת |
exceptions.frames.symbol |
מחרוזת | סמל 'שתיית מים' או הסמל הגולמי אם הם לא מתכלים |
exceptions.frames.offset |
INT64 | היסט הבייט בתוך התמונה הבינארית שמכילה את הקוד לא מוגדר בחריגות של Java |
exceptions.frames.address |
INT64 | הכתובת בתמונה הבינארית שמכילה את הקוד לא הוגדרה למסגרות Java |
exceptions.frames.library |
מחרוזת | השם המוצג של הספרייה שכוללת את המסגרת |
exceptions.frames.owner |
מחרוזת | לדוגמה, DEVELOPER , VENDOR ,
RUNTIME , PLATFORM או SYSTEM |
exceptions.frames.blamed |
בוליאני | אם Crashlytics קבע שהפריים הזה הוא הגורם לקריסה או לשגיאה |
error |
רשומה חוזרת | (אפליקציות של Apple בלבד) שגיאות לא חמורות |
error.queue_name |
מחרוזת | התור שבו השרשור הופעל |
error.code |
INT64 | קוד שגיאה המשויך ל-NSError בהתאמה אישית של האפליקציה ביומן |
error.title |
מחרוזת | כותרת השרשור |
error.subtitle |
מחרוזת | כותרת המשנה של השרשור |
error.blamed |
בוליאני | האם Crashlytics קבע שהמסגרת הזו היא הגורם שגיאה |
error.frames |
REPEATED RECORD | המסגרות של דוח הקריסות |
error.frames.line |
INT64 | מספר השורה של קובץ המסגרת |
error.frames.file |
מחרוזת | שם קובץ המסגרת |
error.frames.symbol |
מחרוזת | סמל 'שתיית מים' או הסמל הגולמי אם הם לא מתכלים |
error.frames.offset |
INT64 | הסטייה של הבייט לתוך התמונה הבינארית שמכילה את הקוד |
error.frames.address |
INT64 | הכתובת בתמונה הבינארית שמכילה את הקוד |
error.frames.library |
מחרוזת | השם המוצג של הספרייה שכוללת את המסגרת |
error.frames.owner |
מחרוזת | לדוגמה, DEVELOPER , VENDOR ,
RUNTIME , PLATFORM או SYSTEM |
error.frames.blamed |
בוליאני | האם Crashlytics קבע שהמסגרת הזו היא הגורם שגיאה |
threads |
רשומה חוזרת | שרשורים שהיו קיימים בזמן האירוע |
threads.crashed |
בוליאני | האם השרשור קרס |
threads.thread_name |
מחרוזת | שם השרשור |
threads.queue_name |
מחרוזת | (באפליקציות של Apple בלבד) התור שבו פעל השרשור |
threads.signal_name |
מחרוזת | שם האות שגרם לקריסת האפליקציה, מופיע רק בשרשראות מקוריות שנכשלו |
threads.signal_code |
מחרוזת | הקוד של האות שגרם לאפליקציה לקרוס. הוא מופיע רק בשרשראות מקוריות שנכשלו |
threads.crash_address |
INT64 | הכתובת של האות שגרם לאפליקציה לקרוס. נוכחים בלבד על שרשורים מקוריים שקורסו |
threads.code |
INT64 | (אפליקציות של Apple בלבד) קוד שגיאה של רישום האפליקציה ביומן שגיאת NS |
threads.title |
מחרוזת | כותרת השרשור |
threads.subtitle |
מחרוזת | כותרת המשנה של השרשור |
threads.blamed |
בוליאני | אם Crashlytics קבע שהפריים הזה הוא הגורם לקריסה או לשגיאה |
threads.frames |
רשומה חוזרת | הפריימים של השרשור |
threads.frames.line |
INT64 | מספר השורה של קובץ המסגרת |
threads.frames.file |
מחרוזת | שם קובץ המסגרת |
threads.frames.symbol |
מחרוזת | הסמל של המבנה המנוזל, או הסמל הגולמי אם לא ניתן להוסיף לו מים |
threads.frames.offset |
INT64 | הסטייה של הבייט לתוך התמונה הבינארית שמכילה את הקוד |
threads.frames.address |
INT64 | הכתובת בתמונה הבינארית שמכילה את הקוד |
threads.frames.library |
מחרוזת | השם המוצג של הספרייה שכוללת את המסגרת |
threads.frames.owner |
מחרוזת | לדוגמה, DEVELOPER , VENDOR ,
RUNTIME , PLATFORM או SYSTEM |
threads.frames.blamed |
בוליאני | אם Crashlytics קבע שהמסגרת הזו היא הגורם לשגיאה |
unity_metadata.unity_version |
מחרוזת | גרסת Unity שפועלת במכשיר הזה |
unity_metadata.debug_build |
בוליאני | אם מדובר ב-build לניפוי באגים |
unity_metadata.processor_type |
מחרוזת | סוג המעבד |
unity_metadata.processor_count |
INT64 | מספר המעבדים (ליבות) |
unity_metadata.processor_frequency_mhz |
INT64 | התדר של המעבדים ב-MHz |
unity_metadata.system_memory_size_mb |
INT64 | גודל הזיכרון של המערכת ב-Mb |
unity_metadata.graphics_memory_size_mb |
INT64 | זיכרון הגרפיקה ב-MB |
unity_metadata.graphics_device_id |
INT64 | המזהה של המכשיר הגרפי |
unity_metadata.graphics_device_vendor_id |
INT64 | המזהה של ספק מעבד הגרפיקה |
unity_metadata.graphics_device_name |
מחרוזת | השם של מכשיר הגרפיקה |
unity_metadata.graphics_device_vendor |
מחרוזת | הספק של מכשיר הגרפיקה |
unity_metadata.graphics_device_version |
מחרוזת | הגרסה של מכשיר הגרפיקה |
unity_metadata.graphics_device_type |
מחרוזת | סוג המכשיר הגרפי |
unity_metadata.graphics_shader_level |
INT64 | רמת ה-shader של הגרפיקה |
unity_metadata.graphics_render_target_count |
INT64 | מספר היעדים לעיבוד גרפי |
unity_metadata.graphics_copy_texture_support |
מחרוזת | תמיכה בהעתקת הטקסטורה הגרפית כפי שמוגדר API ל-Unity |
unity_metadata.graphics_max_texture_size |
INT64 | הגודל המקסימלי הייעודי לעיבוד טקסטורה |
unity_metadata.screen_size_px |
מחרוזת | גודל המסך בפיקסלים, בפורמט של רוחב x גובה |
unity_metadata.screen_resolution_dpi |
מחרוזת | דחיסות המסך (DPI) כמספר נקודה צפה (floating-point) |
unity_metadata.screen_refresh_rate_hz |
INT64 | קצב הרענון של המסך ב-Hz |
המחשה חזותית של נתוני Crashlytics שיוצאו באמצעות Data Studio
Google Data Studio מעביר את Crashlytics מערכי נתונים בBigQuery לדוחות שקל יותר לקריאה, לשיתוף קל יותר ולאפשרות להתאמה אישית מלאה.
למידע נוסף על השימוש ב-Data Studio, כדאי לנסות את המדריך למתחילים של Data Studio, ברוכים הבאים אל Data Studio.
שימוש בתבנית של דוח Crashlytics
ב-Data Studio יש דוח לדוגמה עבור Crashlytics שכולל קבוצה מקיפה של מאפיינים ומדדים מהמדד Crashlytics שמיוצא סכימה BigQuery. אם הפעלת ייצוא בסטרימינג של Crashlytics עד BigQuery, תוכלו להציג את הנתונים האלה במגמות בזמן אמת בדף של תבנית Data Studio.אפשר להשתמש בדוגמה כתבנית כדי ליצור דוחות חדשים והמחשות ויזואליות על סמך נתוני הקריסה הגולמיים של האפליקציה שלכם:
פותחים את Crashlytics תבנית מרכז השליטה של Data Studio.
לוחצים על שימוש בתבנית בפינה השמאלית העליונה.
בתפריט הנפתח New Data Source, בוחרים באפשרות Create New Data Source.
לוחצים על בחירה בכרטיס BigQuery.
בוחרים טבלה שמכילה נתוני Crashlytics שיוצאו, על ידי בחירה באפשרות My Projects > PROJECT_ID > firebase_crashlytics > TABLE_NAME.
תמיד אפשר לבחור את הטבלה באצווה. אם המיקום ייצוא הסטרימינג של Crashlytics אל BigQuery מופעל, ואז עליך אתם יכולים לבחור את הטבלה של זמן אמת במקום זאת.
בקטע Configuration, מגדירים את Crashlytics Template level לערך Default.
לוחצים על התחברות כדי ליצור את מקור הנתונים החדש.
לוחצים על הוספה לדוח כדי לחזור לתבנית Crashlytics.
לסיום, לוחצים על Create Report (יצירת דוח) כדי ליצור עותק של התבנית Crashlytics של מרכז הבקרה ב-Data Studio.