הרצת שאילתות SQL על נתונים שיוצאו ב-BigQuery

אחרי שמייצאים ל-BigQuery את נתוני הסשנים של האפליקציה לנייד ב-Crashlytics וב-Firebase (אופציונלי), אפשר להתחיל לעבוד עם הנתונים:

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

  • שילוב נתונים מקבוצות נתונים שונות
    לדוגמה, אם תבחרו לייצא נתוני סשנים של Firebase כשתגדירו את ייצוא הנתונים של Crashlytics, תוכלו להבין טוב יותר את המשתמשים בלי קריסות ואת הסשנים בלי קריסות (ראו שאילתה לדוגמה). אפשר גם לייצא נתונים ממוצרי Firebase שונים (כמו Performance Monitoring) או מ-Google Analytics, ואז לאחד ולנתח את הנתונים האלה ב-BigQuery עם נתוני Crashlytics.

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

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

מידע על BigQuery SQL

שאילתות לדוגמה לנתוני Crashlytics

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

דוגמה 1: חישוב מדדים ללא קריסות באמצעות נתוני סשנים ב-Firebase

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

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

הנה דוגמאות לשאילתות לאפליקציה ל-Android. לאפליקציה ל-iOS, צריך להשתמש במזהה החבילה שלה וב-IOS (במקום בשם החבילה וב-ANDROID).

משתמשים שהאפליקציה שלהם לא קרסה בגרסה ספציפית:

SELECT
  TIMESTAMP_TRUNC(crashlytics.event_timestamp,DAY) AS event_date,
  (1 - (COUNT (DISTINCT installation_uuid) / COUNT (DISTINCT instance_id))) AS CFU
FROM
  `PROJECT_ID.firebase_sessions.PACKAGE_NAME_ANDROID` AS sessions
LEFT JOIN
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID` AS crashlytics
ON
  TIMESTAMP_TRUNC(sessions.event_timestamp,DAY) = TIMESTAMP_TRUNC(crashlytics.event_timestamp,DAY)
WHERE
  crashlytics.error_type="FATAL"
  AND crashlytics.application.display_version="APP_VERSION"
  AND sessions.application.display_version = "APP_VERSION"
GROUP BY
  event_date
ORDER BY
  event_date

סשנים בלי קריסות בשבוע האחרון (168 השעות האחרונות):

SELECT
  TIMESTAMP_TRUNC(crashlytics.event_timestamp,DAY) AS event_date,
  (1 - (COUNT (DISTINCT crashlytics.firebase_session_id) / COUNT (DISTINCT sessions.session_id))) AS CFS
FROM
  `PROJECT_ID.firebase_sessions.PACKAGE_NAME_ANDROID` AS sessions
LEFT JOIN
  `PROJECT_ID.firebase_crashlytics.PACKAGE_NAME_ANDROID` AS crashlytics
ON
  TIMESTAMP_TRUNC(sessions.event_timestamp,DAY) = TIMESTAMP_TRUNC(crashlytics.event_timestamp,DAY)
WHERE
  crashlytics.error_type="FATAL" AND _PARTITIONTIME >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 168 HOUR)
  AND _PARTITIONTIME < CURRENT_TIMESTAMP()
GROUP BY
  event_date
ORDER BY
  event_date

דוגמה 2: קריסות לפי יום

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

הנה דוגמה לשאילתה לאפליקציה ל-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;

דוגמה 3: איך מוצאים את הקריסות הנפוצות ביותר

כדי לתעדף נכון את תוכניות הייצור, אתם רוצים למצוא את 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;

דוגמה 4: 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;

דוגמה 5: סינון לפי מפתח בהתאמה אישית

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

כדי לעקוב אחרי הנתון הזה, אתם מגדירים מפתח Crashlytics מותאם אישית (iOS+‎ | Android | Flutter | Unity ) בשם 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

דוגמה 6: חילוץ מזהי משתמשים

יש לכם אפליקציה ל-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
 

דוגמה 7: חיפוש כל המשתמשים שנתקלו בבעיית קריסה מסוימת

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

הנה דוגמה לשאילתה לאפליקציה ל-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;

דוגמה 8: מספר המשתמשים שהושפעו מבעיית קריסה, בחלוקה לפי מדינה

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

כדי לכתוב את השאילתה הזו, הצוות שלכם יצטרך לבצע את הפעולות הבאות:

  1. הפעלת ייצוא של נתוני Google Analytics אל BigQuery. ייצוא נתוני פרויקט ל-BigQuery

  2. מעדכנים את האפליקציה לנייד כך שתעביר מזהה משתמש גם ל-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");
    
  3. כותבים שאילתה שמשתמשת בשדה מזהה המשתמש כדי לאחד אירועים במערך הנתונים 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

דוגמה 9: חמש הבעיות המובילות היום עד עכשיו

הנה דוגמה לשאילתה לאפליקציה ל-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;

דוגמה 10: חמש הבעיות המובילות מאז [תאריך], כולל היום

אפשר גם לשלב את טבלאות הנתונים שנאספו באצווה ובזמן אמת באמצעות שאילתת איחוד, כדי להוסיף מידע בזמן אמת לנתונים האמינים שנאספו באצווה. מכיוון שהשדה 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 >= PARSE_TIMESTAMP("%Y_%m_%d", "YYYY_MM_DD")
GROUP BY
  issue_id
ORDER BY
  events DESC
LIMIT
  5;

מה השלב הבא?