Xuất dữ liệu Firebase Crashlytics sang BigQuery

Bạn có thể xuất dữ liệu Crashlytics vào BigQuery để phân tích thêm. BigQuery cho phép bạn phân tích dữ liệu bằng BigQuery SQL, xuất dữ liệu đó sang một nhà cung cấp dịch vụ đám mây khác và sử dụng dữ liệu này để trực quan hoá cũng như tạo trang tổng quan tuỳ chỉnh bằng Google Data Studio.

Bật tính năng BigQuery Export

1. Chuyển đến trang Tích hợp trong bảng điều khiển của Firebase.
2. Trong thẻ BigQuery, hãy nhấp vào Liên kết.
3. Làm theo hướng dẫn trên màn hình để bật BigQuery.

Khi bạn liên kết dự án với BigQuery:

• Firebase thiết lập tính năng đồng bộ hoá dữ liệu hằng ngày từ dự án Firebase với BigQuery.
• Theo mặc định, tất cả ứng dụng trong dự án của bạn đều được liên kết với BigQuery và mọi ứng dụng mà sau này bạn thêm vào dự án sẽ tự động được liên kết với BigQuery. Bạn có thể quản lý các ứng dụng gửi dữ liệu.
• Firebase xuất một bản sao dữ liệu hiện có của bạn sang BigQuery. Đối với mỗi ứng dụng được liên kết, tệp này bao gồm một bảng lô chứa dữ liệu của quá trình đồng bộ hoá hằng ngày.
• Nếu bạn bật tính năng xuất trực tuyến BigQuery của Crashlytics, thì tất cả ứng dụng được liên kết cũng sẽ có một bảng theo thời gian thực chứa dữ liệu được cập nhật liên tục.

Để tắt tính năng BigQuery Export, hãy huỷ liên kết dự án của bạn trong bảng điều khiển của Firebase.

Dữ liệu nào được xuất sang BigQuery?

Dữ liệu của Firebase Crashlytics được xuất sang một tập dữ liệu BigQuery có tên là firebase_crashlytics. Theo mặc định, các bảng riêng lẻ sẽ được tạo trong tập dữ liệu Crashlytics cho từng ứng dụng trong dự án của bạn. Firebase đặt tên cho các bảng dựa trên giá trị nhận dạng gói của ứng dụng, với các dấu chấm được chuyển đổi thành dấu gạch dưới và tên nền tảng được thêm vào cuối.

Ví dụ: dữ liệu của ứng dụng có mã nhận dạng com.google.test sẽ nằm trong một bảng có tên là com_google_test_ANDROID. Bảng lô này được cập nhật mỗi ngày một lần. Nếu bạn bật tính năng xuất trực tuyến BigQuery của Crashlytics, thì dữ liệu của Firebase Crashlytics cũng sẽ được truyền theo thời gian thực đến com_google_test_ANDROID_REALTIME.

Mỗi hàng trong bảng biểu thị một sự kiện xảy ra trong ứng dụng, bao gồm sự cố, lỗi không nghiêm trọng và lỗi ANR.

Bật tính năng xuất trực tuyến BigQuery của Crashlytics

Bạn có thể truyền trực tuyến dữ liệu trên Crashlytics theo thời gian thực bằng BigQueryStreaming. Bạn có thể sử dụng API này cho bất kỳ mục đích nào cần dữ liệu trực tiếp, chẳng hạn như trình bày thông tin trong trang tổng quan trực tiếp, xem bản phát hành trực tiếp hoặc theo dõi các sự cố về ứng dụng nhằm kích hoạt cảnh báo và quy trình tuỳ chỉnh.

Tính năng xuất trực tuyến BigQuery của Crashlytics không có sẵn cho hộp cát BigQuery.

Khi bật tính năng xuất trực tuyến BigQuery của Crashlytics, ngoài bảng lô, bạn sẽ có một bảng theo thời gian thực. Dưới đây là những điểm khác biệt giữa các bảng mà bạn cần lưu ý:

Bảng lô là lựa chọn lý tưởng cho hoạt động phân tích dài hạn và xác định xu hướng theo thời gian, vì chúng tôi lưu trữ các sự kiện một cách bền vững trước khi viết và có thể bổ sung các sự kiện đó vào bảng trong tối đa 30 ngày. Khi ghi dữ liệu vào bảng theo thời gian thực, chúng tôi sẽ ghi dữ liệu đó ngay vào BigQuery. Vì vậy, đây là lựa chọn lý tưởng dành cho trang tổng quan trực tiếp và cảnh báo tuỳ chỉnh. Bạn có thể kết hợp 2 bảng này với một truy vấn ghép để tận dụng lợi ích của cả hai. Xem truy vấn Ví dụ 9 dưới đây.

Theo mặc định, bảng theo thời gian thực có thời gian hết hạn phân vùng là 30 ngày. Để tìm hiểu cách sửa đổi chế độ này, hãy xem phần Cập nhật thời hạn phân vùng.

Bật tính năng truyền trực tuyến BigQuery của Crashlytics

Để bật tính năng truyền trực tuyến, hãy chuyển đến phần Crashlytics trong trang tích hợp BigQuery rồi chọn hộp đánh dấu Bao gồm tính năng truyền trực tuyến.

Mẫu Data Studio

Để bật dữ liệu theo thời gian thực trong mẫu Data Studio, hãy làm theo hướng dẫn trong bài viết Hình ảnh hoá dữ liệu Crashlytics đã xuất bằng Data Studio.

Chế độ xem

Bạn có thể chuyển các truy vấn mẫu bên dưới thành chế độ xem bằng cách sử dụng giao diện người dùng BigQuery. Hãy xem phần Tạo thành phần hiển thị để biết hướng dẫn chi tiết.

Bạn có thể làm gì với dữ liệu đã xuất?

Dữ liệu xuất BigQuery chứa dữ liệu sự cố thô bao gồm loại thiết bị, hệ điều hành, ngoại lệ (ứng dụng Android) hoặc lỗi (ứng dụng của Apple) và nhật ký Crashlytics, cũng như các dữ liệu khác.

Làm việc với dữ liệu của Firebase Crashlytics trong BigQuery

Các ví dụ sau đây minh hoạ những truy vấn mà bạn có thể chạy trên dữ liệu Crashlytics. Các truy vấn này tạo ra những báo cáo không có trong trang tổng quan Crashlytics.

Ví dụ về truy vấn Crashlytics

Các ví dụ sau đây minh hoạ cách tạo báo cáo tổng hợp dữ liệu sự kiện sự cố thành các bản tóm tắt dễ hiểu hơn.

Ví dụ 1: Sự cố theo ngày

Sau khi cố gắng khắc phục nhiều lỗi nhất có thể, một nhà phát triển hàng đầu cho rằng nhóm của cô cuối cùng đã sẵn sàng ra mắt ứng dụng chia sẻ ảnh mới. Trước khi làm điều này, họ muốn kiểm tra số lượng sự cố mỗi ngày trong tháng qua để đảm bảo lỗi của họ đã giúp ứng dụng ổn định hơn theo thời gian:

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;

Ví dụ 2: Tìm các sự cố phổ biến nhất

Để ưu tiên hợp lý các kế hoạch sản xuất, một nhà quản lý dự án sẽ cân nhắc cách chỉ ra 10 sự cố phổ biến nhất trong sản phẩm của họ. Chúng tạo ra một truy vấn cung cấp các điểm dữ liệu thích hợp:

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;

Ví dụ 3: 10 thiết bị gặp sự cố hàng đầu

Mùa thu là mùa mới trên điện thoại! Một nhà phát triển biết rằng điều đó cũng có nghĩa là mùa này gặp các vấn đề mới liên quan đến thiết bị. Để chuẩn bị cho những mối lo ngại đáng lo ngại về khả năng tương thích, họ đưa ra một truy vấn xác định 10 thiết bị đã gặp nhiều sự cố nhất trong tuần qua:

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;

Ví dụ 4: Lọc theo khoá tuỳ chỉnh

Một nhà phát triển trò chơi muốn biết cấp độ nào trong trò chơi của họ gặp phải nhiều sự cố nhất. Để giúp họ theo dõi số liệu thống kê đó, họ đặt một khoá Crashlytics tuỳ chỉnh current_level và cập nhật khoá này mỗi khi người dùng đạt đến một cấp mới.

CrashlyticsKit setIntValue:3 forKey:@"current_level";

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

Crashlytics.setInt("current_level", 3);

Với khoá đó trong BigQuery Export, họ sẽ viết một truy vấn để báo cáo việc phân phối các giá trị current_level được liên kết với từng sự kiện lỗi:

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

Ví dụ 5: Trích xuất mã nhận dạng người dùng

Nhà phát triển có một ứng dụng ở giai đoạn tiếp cận sớm. Hầu hết người dùng yêu thích ứng dụng này, nhưng 3 ứng dụng gặp phải một số lượng sự cố bất thường. Để tìm hiểu sâu hơn về vấn đề này, họ sẽ viết một truy vấn lấy tất cả sự kiện sự cố cho những người dùng đó, bằng cách sử dụng mã nhận dạng người dùng của họ:

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

Ví dụ 6: Tìm tất cả người dùng gặp phải một sự cố cụ thể

Một nhà phát triển đã phát hành một lỗi nghiêm trọng cho một nhóm người kiểm thử phiên bản thử nghiệm. Nhóm này có thể sử dụng truy vấn trong Ví dụ 2 ở trên để xác định mã sự cố cụ thể. Bây giờ, họ muốn chạy một truy vấn để trích xuất danh sách người dùng ứng dụng chịu ảnh hưởng của sự cố này:

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;

Ví dụ 7: Số người dùng chịu ảnh hưởng của một sự cố (tính theo quốc gia)

Hiện tại, nhóm phát triển đã phát hiện một lỗi nghiêm trọng trong quá trình ra mắt một bản phát hành mới. Họ có thể sử dụng truy vấn trong Ví dụ 2 ở trên để xác định mã sự cố cụ thể. Bây giờ, nhóm muốn biết liệu sự cố này có lan ra người dùng ở nhiều quốc gia trên thế giới hay không.

Để viết truy vấn này, nhóm cần phải:

1. Bật tính năng xuất dữ liệu của BigQuery cho Google Analytics. Xem bài viết Xuất dữ liệu dự án sang BigQuery.

2. Hãy cập nhật ứng dụng của họ để chuyển mã nhận dạng người dùng vào cả SDK Google Analytics và SDK Crashlytics.

   Objective-C

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

   Swift

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

   Java

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

3. Viết một truy vấn sử dụng trường mã nhận dạng người dùng để kết hợp các sự kiện trong tập dữ liệu BigQuery của Google Analytics có sự cố trong tập dữ liệu BigQuery của 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
   

Ví dụ 8: 5 vấn đề hàng đầu cho đến nay

Yêu cầu bật tính năng xuất trực tuyến BigQuery của Crashlytics

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;

Ví dụ 9: 5 vấn đề hàng đầu kể từ DATE, kể cả hôm nay

Yêu cầu bật tính năng xuất trực tuyến BigQuery của Crashlytics.

Trong ví dụ này, chúng tôi kết hợp các bảng theo lô và bảng theo thời gian thực để thêm thông tin theo thời gian thực vào dữ liệu lô đáng tin cậy. Vì event_id là khoá chính, nên chúng ta có thể sử dụng DISTINCT event_id để loại bỏ mọi sự kiện phổ biến khỏi 2 bảng.

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;

Tìm hiểu giản đồ Firebase Crashlytics trong BigQuery

Khi bạn liên kết Crashlytics với BigQuery, Firebase sẽ xuất các sự kiện gần đây (sự cố, lỗi không nghiêm trọng và lỗi ANR), bao gồm cả các sự kiện diễn ra trong tối đa 2 ngày trước khi liên kết, với lựa chọn chèn lấp tối đa 30 ngày.

Từ thời điểm đó cho đến khi bạn tắt mối liên kết, Firebase sẽ xuất các sự kiện Crashlytics hằng ngày. Có thể mất vài phút để dữ liệu có trong BigQuery sau mỗi lần xuất.

Tập dữ liệu

Firebase Crashlytics sẽ tạo một tập dữ liệu mới trong BigQuery cho dữ liệu Crashlytics. Tập dữ liệu này bao gồm toàn bộ dự án của bạn, ngay cả khi tập dữ liệu đó có nhiều ứng dụng.

Bảng

Firebase Crashlytics sẽ tạo một bảng trong tập dữ liệu cho từng ứng dụng trong dự án của bạn, trừ phi bạn đã chọn không xuất dữ liệu cho ứng dụng đó. Firebase đặt tên cho các bảng dựa trên mã nhận dạng gói của ứng dụng, với dấu chấm được chuyển đổi thành dấu gạch dưới và tên nền tảng được thêm vào cuối.

Ví dụ: dữ liệu của ứng dụng Android có mã com.google.test sẽ nằm trong bảng có tên là com_google_test_ANDROID và dữ liệu theo thời gian thực (nếu được bật) sẽ nằm trong bảng có tên com_google_test_ANDROID_REALTIME

Các bảng chứa một bộ dữ liệu Crashlytics tiêu chuẩn ngoài các khoá Crashlytics tuỳ chỉnh do nhà phát triển xác định.

Hàng

Mỗi hàng trong bảng biểu thị một lỗi mà ứng dụng gặp phải.

Cột

Các cột trong một bảng giống nhau dành cho sự cố, lỗi không nghiêm trọng và lỗi ANR. Nếu bạn bật tính năng xuất trực tuyến BigQuery của Crashlytics, thì bảng theo thời gian thực sẽ có các cột giống với bảng lô. Các cột bên trong dữ liệu xuất được liệt kê ở bên dưới.

Không có dấu vết ngăn xếp

Các cột xuất hiện trong hàng đại diện cho sự kiện không có dấu vết ngăn xếp.

Trực quan hoá dữ liệu Crashlytics đã xuất bằng Data Studio

Google Data Studio biến các tập dữ liệu Crashlytics trong BigQuery của bạn thành các báo cáo dễ đọc, dễ chia sẻ và hoàn toàn có thể tuỳ chỉnh.

Để tìm hiểu thêm về cách sử dụng Data Studio, hãy xem hướng dẫn bắt đầu nhanh về Data Studio, Chào mừng bạn đến với Data Studio.

Sử dụng mẫu báo cáo Crashlytics

Data Studio có một báo cáo mẫu cho Crashlytics bao gồm một tập hợp các phương diện và chỉ số toàn diện từ giản đồ BigQuery của Crashlytics đã xuất. Nếu đã bật tính năng xuất trực tuyến BigQuery của Crashlytics, bạn có thể xem dữ liệu đó trên trang Xu hướng theo thời gian thực của mẫu Data Studio.Bạn có thể sử dụng mẫu làm mẫu để nhanh chóng tạo báo cáo và hình ảnh trực quan mới dựa trên dữ liệu sự cố chưa qua xử lý của ứng dụng:

1. Mở mẫu Trang tổng quan Data Studio của Crashlytics.
2. Nhấp vào Sử dụng mẫu ở góc trên bên phải.
3. Trong trình đơn thả xuống Nguồn dữ liệu mới, hãy chọn Tạo nguồn dữ liệu mới.
4. Nhấp vào Chọn trên thẻ BigQuery.
5. Chọn một bảng chứa dữ liệu Crashlytics đã xuất bằng cách chọn Dự án của tôi > [tên dự án của bạn] > firebase_crashlytics > [tên-bảng của bạn]. Bạn luôn có thể chọn bảng lô để chọn; nếu đã bật tính năng xuất trực tuyến BigQuery của Crashlytics, thì bạn có thể chọn bảng theo thời gian thực.
6. Trong phần Cấu hình, hãy đặt Cấp mẫu Crashlytics thành Mặc định.
7. Nhấp vào Kết nối để tạo nguồn dữ liệu mới.
8. Nhấp vào Thêm vào báo cáo để quay lại mẫu Crashlytics.
9. Cuối cùng, hãy nhấp vào Tạo báo cáo để tạo bản sao cho mẫu Trang tổng quan Data Studio của Crashlytics.