داده های Firebase Crashlytics را به BigQuery صادر کنید

می توانید داده های Crashlytics خود را برای تجزیه و تحلیل بیشتر به BigQuery صادر کنید. BigQuery به شما امکان می‌دهد داده‌ها را با استفاده از BigQuery SQL تجزیه و تحلیل کنید، آن‌ها را به یک ارائه‌دهنده ابر دیگر صادر کنید و از آن برای تجسم و داشبوردهای سفارشی با Google Data Studio استفاده کنید.

صادرات BigQuery را فعال کنید

1. به صفحه ادغام در کنسول Firebase بروید.
2. در کارت BigQuery ، روی پیوند کلیک کنید.
3. دستورالعمل های روی صفحه را برای فعال کردن BigQuery دنبال کنید.

وقتی پروژه خود را به BigQuery پیوند می دهید:

• Firebase همگام‌سازی روزانه داده‌های شما را از پروژه Firebase با BigQuery تنظیم می‌کند.
• به‌طور پیش‌فرض، همه برنامه‌های پروژه شما به BigQuery مرتبط می‌شوند و هر برنامه‌ای که بعداً به پروژه اضافه می‌کنید به‌طور خودکار به BigQuery مرتبط می‌شود. می‌توانید مدیریت کنید که کدام برنامه‌ها داده‌ها را ارسال می‌کنند .
• Firebase یک کپی از داده های موجود شما را به BigQuery صادر می کند . برای هر برنامه پیوند داده شده، این شامل یک جدول دسته‌ای است که حاوی داده‌های همگام‌سازی روزانه است.
• اگر صادرات پخش جریانی Crashlytics BigQuery را فعال کنید، همه برنامه‌های پیوند داده شده نیز یک جدول بیدرنگ حاوی داده‌های در حال به‌روزرسانی دائمی خواهند داشت.

برای غیرفعال کردن صادرات BigQuery، پیوند پروژه خود را در کنسول Firebase لغو کنید.

چه داده هایی به BigQuery صادر می شود؟

داده های Firebase Crashlytics به یک مجموعه داده BigQuery به نام firebase_crashlytics صادر می شود. به طور پیش فرض، جداول جداگانه در مجموعه داده های Crashlytics برای هر برنامه در پروژه شما ایجاد می شود. Firebase جداول را بر اساس شناسه بسته برنامه نام‌گذاری می‌کند و نقطه‌ها به زیرخط تبدیل می‌شوند و یک نام پلتفرم به انتها اضافه می‌شود.

برای مثال، داده‌های یک برنامه با شناسه com.google.test در جدولی به نام com_google_test_ANDROID قرار می‌گیرد. این جدول دسته ای هر روز یک بار به روز می شود. اگر صادر کردن جریان Crashlytics BigQuery را فعال کنید، داده‌های Firebase Crashlytics نیز به‌صورت هم‌زمان در com_google_test_ANDROID_REALTIME پخش می‌شود.

هر ردیف در جدول نشان دهنده رویدادی است که در برنامه رخ داده است، از جمله خرابی ها، خطاهای غیر کشنده و ANR.

صادرات جریان Crashlytics BigQuery را فعال کنید

با BigQueryStreaming می‌توانید داده‌های Crashlytics خود را به‌صورت هم‌زمان پخش کنید. می‌توانید از آن برای هر هدفی که به داده‌های زنده نیاز دارد، استفاده کنید، مانند ارائه اطلاعات در داشبورد زنده، تماشای پخش زنده، یا نظارت بر مشکلات برنامه‌ای که هشدارها و گردش‌های کاری سفارشی را ایجاد می‌کنند.

صادر کردن جریان Crashlytics BigQuery برای جعبه ایمنی BigQuery در دسترس نیست.

وقتی صادرات جریان Crashlytics BigQuery را فعال می کنید، علاوه بر جدول دسته ای، یک جدول بیدرنگ خواهید داشت. در اینجا تفاوت هایی وجود دارد که باید بین جداول از آنها آگاه باشید:

جدول دسته ای برای تجزیه و تحلیل طولانی مدت و شناسایی روندها در طول زمان ایده آل است، زیرا ما رویدادها را قبل از نوشتن آنها به طور بادوام ذخیره می کنیم و می توان آنها را تا 90 روز روی جدول پر کرد. وقتی داده‌ها را در جدول بیدرنگ شما می‌نویسیم، بلافاصله آن را در BigQuery می‌نویسیم، و بنابراین برای داشبوردهای زنده و هشدارهای سفارشی ایده‌آل است. این دو جدول را می توان با یک جستجوی دوخت ترکیب کرد تا از مزایای هر دو بهره مند شود. مثال 9 را در زیر ببینید.

به‌طور پیش‌فرض، جدول Realtime زمان انقضای پارتیشن 30 روزه دارد. برای یادگیری نحوه تغییر این، به به روز رسانی انقضای پارتیشن مراجعه کنید.

پخش جریانی Crashlytics BigQuery را فعال کنید

برای فعال کردن استریم، به بخش Crashlytics در صفحه ادغام‌های BigQuery بروید و کادر بررسی شامل پخش جریانی را انتخاب کنید.

قالب Data Studio

برای فعال کردن داده‌های بی‌درنگ در قالب Data Studio خود، دستورالعمل‌های موجود در Visualizing Crashlytics صادر شده با Data Studio را دنبال کنید.

بازدیدها

می توانید با استفاده از رابط کاربری BigQuery، پرس و جوهای مثال زیر را به نما تبدیل کنید. برای دستورالعمل های دقیق به ایجاد نماها مراجعه کنید.

با داده های صادر شده چه کاری می توانید انجام دهید؟

صادرات BigQuery حاوی داده‌های خرابی خام از جمله نوع دستگاه، سیستم عامل، استثنائات (برنامه‌های Android) یا خطاها (برنامه‌های اپل) و گزارش‌های Crashlytics و همچنین داده‌های دیگر است.

کار با داده های Firebase Crashlytics در BigQuery

مثال‌های زیر پرس‌و‌جوهایی را نشان می‌دهند که می‌توانید روی داده‌های Crashlytics خود اجرا کنید. این پرسش‌ها گزارش‌هایی تولید می‌کنند که در داشبورد Crashlytics در دسترس نیستند.

نمونه هایی از پرس و جوهای Crashlytics

مثال‌های زیر نشان می‌دهند که چگونه می‌توان گزارش‌هایی تولید کرد که داده‌های رویداد خرابی را در خلاصه‌های قابل فهم‌تر جمع‌آوری می‌کند.

مثال 1: خرابی در روز

پس از تلاش برای رفع هر چه بیشتر باگ‌های ممکن، یک توسعه‌دهنده اصلی فکر می‌کند تیم او بالاخره آماده راه‌اندازی برنامه جدید اشتراک‌گذاری عکس خود هستند. قبل از انجام این کار، آنها می‌خواهند تعداد خرابی‌های ماه گذشته در روز را بررسی کنند تا مطمئن شوند که باگ-باش آن‌ها برنامه را در طول زمان پایدارتر کرده است:

SELECT
  COUNT(DISTINCT event_id) AS number_of_crashes,
  FORMAT_TIMESTAMP("%F", event_timestamp) AS date_of_crashes
FROM
 `projectId.firebase_crashlytics.package_name_ANDROID`
GROUP BY
  date_of_crashes
ORDER BY
  date_of_crashes DESC
LIMIT 30;

مثال 2: بیشتر خرابی های فراگیر را پیدا کنید

برای اولویت‌بندی صحیح برنامه‌های تولید، یک مدیر پروژه به این فکر می‌کند که چگونه به 10 خرابی فراگیر در محصول خود اشاره کند. آنها یک پرس و جو تولید می کنند که نقاط مربوط به داده ها را ارائه می دهد:

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
  `projectId.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 دستگاه برتر خراب

پاییز فصل جدید گوشی است! یک توسعه‌دهنده می‌داند که این بدان معناست که فصل مشکلات خاص دستگاه جدید است. برای پیشی گرفتن از نگرانی‌های احتمالی سازگاری، آنها پرس و جوی را جمع‌آوری کردند که 10 دستگاهی را که بیشترین خرابی‌ها را در هفته گذشته تجربه کرده‌اند، شناسایی می‌کند:

SELECT
  device.model,
COUNT(DISTINCT event_id) AS number_of_crashes
FROM
  `projectId.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 تنظیم می کنند و هر بار که کاربر به سطح جدیدی می رسد آن را به روز می کند.

CrashlyticsKit setIntValue:3 forKey:@"current_level";

Crashlytics.sharedInstance().setIntValue(3, forKey: "current_level");

Crashlytics.setInt("current_level", 3);

با استفاده از آن کلید در صادرات BigQuery، آنها سپس یک پرس و جو می نویسند تا توزیع مقادیر current_level مرتبط با هر رویداد خرابی را گزارش کند:

SELECT
COUNT(DISTINCT event_id) AS num_of_crashes,
  value
FROM
  `projectId.firebase_crashlytics.package_name_ANDROID`
UNNEST(custom_keys)
WHERE
  key = "current_level"
GROUP BY
  key,
  value
ORDER BY
  num_of_crashes DESC

مثال 5: استخراج شناسه کاربری

یک توسعه دهنده یک برنامه در دسترسی اولیه دارد. اکثر کاربران آنها آن را دوست دارند، اما سه نفر از آنها تعداد غیرعادی خرابی را تجربه کرده اند. برای اینکه به ته مشکل برسند، آنها یک پرس و جو می نویسند که با استفاده از شناسه کاربری آنها، تمام رویدادهای خرابی را برای آن کاربران نشان می دهد:

SELECT *
FROM
  `projectId.firebase_crashlytics.package_name_ANDROID`
WHERE
  user.id IN ("userid1", "userid2", "userid3")
ORDER BY
  user.id
 

مثال 6: همه کاربرانی که با مشکل خرابی خاصی مواجه هستند را پیدا کنید

یک توسعه‌دهنده یک باگ مهم را برای گروهی از آزمایش‌کنندگان بتا منتشر کرده است. تیم توانست از عبارت مثال 2 بالا برای شناسایی شناسه مشکل خرابی خاص استفاده کند. اکنون آن‌ها می‌خواهند برای استخراج فهرست کاربران برنامه‌ای که تحت تأثیر این خرابی قرار گرفته‌اند، یک پرس و جو اجرا کنند:

SELECT user.id as user_id
FROM
  `projectId.firebase_crashlytics.package_name_ANDROID`
WHERE
  issue_id = "YOUR_ISSUE_ID"
  AND application.display_version = ""
  AND user.id != ""
ORDER BY
  user.id;

مثال 7: تعداد کاربرانی که تحت تأثیر یک مشکل خرابی قرار گرفته اند، به تفکیک کشور

اکنون تیم یک باگ مهم را در طول عرضه نسخه جدید شناسایی کرده است. آنها توانستند از عبارت مثال 2 در بالا برای شناسایی شناسه مشکل خرابی خاص استفاده کنند. اکنون تیم مایل است ببیند که آیا این خرابی به کاربران کشورهای مختلف در سراسر جهان سرایت کرده است یا خیر.

برای نوشتن این پرسش، تیم باید:

1. صادرات BigQuery را برای Google Analytics فعال کنید. صادرات داده های پروژه به BigQuery را ببینید.

2. برنامه آن‌ها را به‌روزرسانی کنید تا یک شناسه کاربری را به Google Analytics SDK و Crashlytics SDK ارسال کنید.

   هدف-C

   CrashlyticsKit setUserIdentifier:@"123456789";
   FIRAnalytics setUserID:@"12345678 9";
   

   سریع

   Crashlytics.sharedInstance().setUserIdentifier("123456789");
   Analytics.setUserID("123456789");
   

   جاوا

   Crashlytics.setUserIdentifier("123456789");
   mFirebaseAnalytics.setUserId("123456789");
   

3. درخواستی بنویسید که از فیلد شناسه کاربر برای پیوستن به رویدادهای مجموعه داده‌های Google Analytics BigQuery با خرابی‌ها در مجموعه داده‌های BigQuery Crashlytics استفاده کند:

   SELECT DISTINCT c.issue_id, a.geo.country, COUNT(DISTINCT c.user.id) as num_users_impacted
   FROM `projectId.firebase_crashlytics.package_name_ANDROID` c
   INNER JOIN  `projectId.analytics_YOUR_TABLE.events_*` a on c.user.id = a.user_id
   WHERE
    c.issue_id = "YOUR_ISSUE_ID"
    AND a._TABLE_SUFFIX BETWEEN '20190101'
    AND '20200101'
   GROUP BY
    c.issue_id,
    a.geo.country,
    c.user.id
   

مثال 8: 5 موضوع برتر تا کنون امروز

به فعال کردن صادرات جریان Crashlytics BigQuery نیاز دارد

SELECT
  issue_id,
  COUNT(DISTINCT event_id) AS events
FROM
  `your_project.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، از جمله امروز

به فعال کردن صادرات جریان Crashlytics BigQuery نیاز دارد.

در این مثال، ما جداول دسته ای و بیدرنگ را ترکیب می کنیم تا اطلاعات بیدرنگ را به داده های دسته ای قابل اعتماد اضافه کنیم. از آنجایی که event_id یک کلید اولیه است، می‌توانیم از DISTINCT event_id برای حذف رویدادهای رایج از دو جدول استفاده کنیم.

SELECT
  issue_id,
  COUNT(DISTINCT event_id) AS events
FROM (
  SELECT
    issue_id,
    event_id,
    event_timestamp
  FROM
    `your_project.firebase_crashlytics.package_name_ANDROID_REALTIME`
  UNION ALL
  SELECT
    issue_id,
    event_id,
    event_timestamp
  FROM
    `your_project.firebase_crashlytics.package_name_ANDROID`)
WHERE
  event_timestamp >= "2020-01-13"
GROUP BY
  issue_id
ORDER BY
  events DESC
LIMIT
  5;

آشنایی با طرح Firebase Crashlytics در BigQuery

وقتی Crashlytics را با BigQuery پیوند می‌دهید، Firebase رویدادهای اخیر (خراب‌ها، خطاهای غیرمرگبار، و ANR) را صادر می‌کند، از جمله رویدادهای حداکثر تا دو روز قبل از پیوند، با گزینه تکمیل تا نود روز.

از آن زمان تا زمانی که پیوند را غیرفعال کنید، Firebase رویدادهای Crashlytics را به صورت روزانه صادر می کند. ممکن است چند دقیقه طول بکشد تا داده ها در BigQuery پس از هر بار صادرات در دسترس قرار گیرند.

مجموعه داده ها

Firebase Crashlytics یک مجموعه داده جدید در BigQuery برای داده های Crashlytics ایجاد می کند. مجموعه داده کل پروژه شما را پوشش می دهد، حتی اگر چندین برنامه داشته باشد.

جداول

Firebase Crashlytics یک جدول در مجموعه داده برای هر برنامه در پروژه شما ایجاد می کند، مگر اینکه از صادرات داده برای آن برنامه منصرف شده باشید. Firebase جداول را بر اساس شناسه بسته برنامه نام‌گذاری می‌کند و نقطه‌ها به زیرخط تبدیل می‌شوند و یک نام پلتفرم به انتها اضافه می‌شود.

برای مثال، داده‌های یک برنامه Android با شناسه com.google.test در جدولی به نام com_google_test_ANDROID و داده‌های بی‌درنگ (در صورت فعال بودن) در جدولی به نام com_google_test_ANDROID_REALTIME قرار خواهند گرفت.

جداول شامل مجموعه استانداردی از داده های Crashlytics علاوه بر کلیدهای Crashlytics سفارشی تعریف شده توسط توسعه دهندگان است.

ردیف ها

هر ردیف در جدول نشان دهنده خطایی است که برنامه با آن مواجه شده است.

ستون ها

ستون‌های جدول برای خرابی‌ها، خطاهای غیرمرگبار و ANR یکسان هستند. اگر صادر کردن جریان Crashlytics BigQuery فعال باشد، جدول بیدرنگ همان ستون‌های جدول دسته‌ای خواهد داشت. ستون های داخل صادرات در زیر فهرست شده اند.

بدون رد پشته

ستون‌هایی در ردیف‌هایی وجود دارند که رویدادها را بدون ردپای پشته نشان می‌دهند.

تجسم داده های صادر شده Crashlytics با Data Studio

Google Data Studio مجموعه داده‌های Crashlytics شما را در BigQuery به گزارش‌هایی تبدیل می‌کند که خواندن آن آسان، به اشتراک‌گذاری آسان و کاملاً قابل تنظیم است.

برای کسب اطلاعات بیشتر در مورد استفاده از Data Studio، راهنمای شروع سریع Data Studio را امتحان کنید، به Data Studio خوش آمدید .

با استفاده از الگوی گزارش Crashlytics

Data Studio یک گزارش نمونه برای Crashlytics دارد که شامل مجموعه ای جامع از ابعاد و معیارهای طرحواره Crashlytics BigQuery صادر شده است. اگر صادر کردن جریان Crashlytics BigQuery را فعال کرده‌اید، می‌توانید آن داده‌ها را در صفحه روندهای Realtime الگوی Data Studio مشاهده کنید. می‌توانید از نمونه به عنوان الگو برای ایجاد سریع گزارش‌ها و تجسم‌های جدید بر اساس داده‌های خرابی خام برنامه خود استفاده کنید:

1. قالب داشبورد Crashlytics Data Studio را باز کنید.
2. روی Use Template در گوشه سمت راست بالا کلیک کنید.
3. در منوی کشویی New Data Source ، Create New Data Source را انتخاب کنید.
4. در کارت BigQuery روی Select کلیک کنید.
5. با انتخاب My Projects > [your-project-name] > firebase_crashlytics > [your-table-name]، جدولی حاوی داده‌های Crashlytics صادر شده را انتخاب کنید. جدول دسته ای شما همیشه برای انتخاب در دسترس است. اگر صادر کردن جریان Crashlytics BigQuery فعال باشد، می‌توانید به جای آن جدول بیدرنگ خود را انتخاب کنید.
6. در قسمت پیکربندی ، سطح الگوی Crashlytics را روی پیش‌فرض تنظیم کنید.
7. برای ایجاد منبع داده جدید روی Connect کلیک کنید.
8. برای بازگشت به الگوی Crashlytics روی افزودن به گزارش کلیک کنید.
9. در نهایت، روی ایجاد گزارش کلیک کنید تا یک کپی از قالب داشبورد Crashlytics Data Studio ایجاد کنید.