Giản đồ tập dữ liệu cho dữ liệu được xuất trong BigQuery

Trang này cung cấp giản đồ tập dữ liệu cho dữ liệu Crashlytics đã xuất và dữ liệu phiên Firebase trong BigQuery.

Firebase tạo các tập dữ liệu mới trong BigQuery cho dữ liệu đã xuất của bạn:


Tập dữ liệu Crashlytics

Dữ liệu Crashlytics được xuất vào một tập dữ liệu BigQuery có tên là firebase_crashlytics. Tập dữ liệu này bao gồm toàn bộ dự án của bạn, ngay cả khi dự án đó có nhiều ứng dụng.

Tables

Theo mặc định, Firebase sẽ tạo các bảng riêng lẻ bên trong tập dữ liệu Crashlytics cho mỗi ứng dụng trong dự án được liên kết với BigQuery.

Các bảng được đặt tên dựa trên giá trị nhận dạng của ứng dụng (với dấu chấm được chuyển đổi thành dấu gạch dưới) và được thêm vào nền tảng của ứng dụng (_IOS hoặc _ANDROID). Ví dụ: dữ liệu cho một ứng dụng Android có tên gói com.google.test sẽ nằm trong một bảng có tên com_google_test_ANDROID.

  • Nếu bạn bật tính năng báo cáo truyền trực tuyến sang BigQuery, thì dữ liệu cũng sẽ được truyền trực tuyến theo thời gian thực đến một bảng có thêm _REALTIME (ví dụ: com_google_test_ANDROID_REALTIME).

  • Mỗi hàng trong bảng đại diện cho một sự kiện đã xảy ra trong ứng dụng, bao gồm cả sự cố, lỗi không nghiêm trọng và lỗi ANR.

  • Các bảng này chứa một tập hợp dữ liệu Crashlytics tiêu chuẩn ngoài mọi khoá Crashlytics tuỳ chỉnh do bạn xác định trong ứng dụng (iOS+ | Android | Flutter | Unity).

Hàng

Mỗi hàng trong bảng đại diện cho một lỗi mà ứng dụng gặp phải.

Cột

Các cột trong bảng giống nhau đối với sự cố, lỗi không nghiêm trọng và lỗi ANR.

  • Nếu bạn bật tính năng báo cáo truyền trực tuyến sang BigQuery, thì bảng theo thời gian thực sẽ có các cột giống như bảng theo lô.

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

Sau đây là các cột trong bảng chứa dữ liệu Crashlytics được xuất:

Tên trường Loại dữ liệu Mô tả
app_orientation STRING Ví dụ: PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN, v.v.
application RECORD Ứng dụng đã tạo sự kiện
application.build_version STRING Phiên bản bản dựng của ứng dụng
application.display_version STRING
blame_frame RECORD Khung được xác định là nguyên nhân gốc gây ra sự cố hoặc lỗi
blame_frame.address INT64 Địa chỉ trong hình ảnh nhị phân chứa mã
Chưa đặt cho khung Java
blame_frame.blamed BOOLEAN Liệu Crashlytics có xác định được khung này là nguyên nhân gây ra sự cố hoặc lỗi hay không
blame_frame.file STRING Tên của tệp khung
blame_frame.library STRING Tên hiển thị của thư viện chứa khung hình
blame_frame.line INT64 Số dòng của tệp khung
blame_frame.offset INT64 Độ lệch byte vào tệp nhị phân chứa mã
Không được đặt cho các ngoại lệ Java
blame_frame.owner STRING Ví dụ: DEVELOPER, VENDOR, RUNTIME, PLATFORM hoặc SYSTEM
blame_frame.symbol STRING Ký hiệu được bổ sung hoặc ký hiệu thô nếu không thể bổ sung
breadcrumbs BẢN GHI LẶP LẠI Google AnalyticsĐường dẫn có dấu thời gian, nếu được bật
breadcrumbs.name STRING Tên liên kết với breadcrumb
breadcrumbs.params BẢN GHI LẶP LẠI Tham số liên kết với breadcrumb
breadcrumbs.params.key STRING Khoá tham số liên kết với breadcrumb
breadcrumbs.params.value STRING Giá trị tham số liên kết với breadcrumb
breadcrumbs.timestamp DẤU THỜI GIAN Dấu thời gian liên kết với breadcrumb
bundle_identifier STRING Giá trị nhận dạng riêng biệt của ứng dụng như đã đăng ký trong dự án Firebase (ví dụ: com.google.gmail)
Đối với ứng dụng trên nền tảng Apple, đây là mã nhận dạng gói của ứng dụng.
Đối với ứng dụng Android, đây là tên gói của ứng dụng.
crashlytics_sdk_versions STRING Phiên bản SDK Crashlytics đã tạo sự kiện
custom_keys BẢN GHI LẶP LẠI Cặp khoá-giá trị do nhà phát triển xác định
custom_keys.key STRING Khoá do nhà phát triển xác định
custom_keys.value STRING Giá trị do nhà phát triển xác định
device RECORD Thiết bị xảy ra sự kiện
device_orientation STRING Ví dụ: PORTRAIT, LANDSCAPE, FACE_UP, FACE_DOWN, v.v.
device.architecture STRING Ví dụ: X86_32, X86_64, ARMV7, ARM64, ARMV7S hoặc ARMV7K
device.manufacturer STRING Nhà sản xuất thiết bị
device.model STRING Mẫu thiết bị
error BẢN GHI LẶP LẠI (Chỉ ứng dụng của Apple) lỗi không nghiêm trọng
error_type STRING Loại lỗi của sự kiện (ví dụ: FATAL, NON_FATAL, ANR, v.v.)
error.blamed BOOLEAN Liệu Crashlytics có xác định được khung này là nguyên nhân gây ra lỗi hay không
error.code INT64 Mã lỗi liên kết với NSError đã ghi nhật ký tuỳ chỉnh của ứng dụng
error.frames BẢN GHI LẶP LẠI Khung của dấu vết ngăn xếp
error.frames.address INT64 Địa chỉ trong hình ảnh nhị phân chứa mã
error.frames.blamed BOOLEAN Liệu Crashlytics có xác định được khung này là nguyên nhân gây ra lỗi hay không
error.frames.file STRING Tên của tệp khung
error.frames.library STRING Tên hiển thị của thư viện chứa khung hình
error.frames.line INT64 Số dòng của tệp khung
error.frames.offset INT64 Độ lệch byte vào hình ảnh nhị phân chứa mã
error.frames.owner STRING Ví dụ: DEVELOPER, VENDOR, RUNTIME, PLATFORM hoặc SYSTEM
error.frames.symbol STRING Ký hiệu được bổ sung hoặc ký hiệu thô nếu không thể bổ sung
error.queue_name STRING Hàng đợi mà luồng đang chạy
error.subtitle STRING Tiêu đề phụ của chuỗi
error.title STRING Tiêu đề của chuỗi bài đăng
event_id STRING Mã nhận dạng duy nhất của sự kiện
event_timestamp DẤU THỜI GIAN Thời điểm diễn ra sự kiện
exceptions BẢN GHI LẶP LẠI (Chỉ dành cho Android) Các trường hợp ngoại lệ xảy ra trong sự kiện này. Các ngoại lệ lồng nhau được trình bày theo thứ tự thời gian đảo ngược, nghĩa là bản ghi cuối cùng là ngoại lệ đầu tiên được gửi đi
exceptions.blamed BOOLEAN Đúng nếu Crashlytics xác định ngoại lệ chịu trách nhiệm về lỗi hoặc sự cố
exceptions.exception_message STRING Thông báo liên quan đến trường hợp ngoại lệ
exceptions.frames BẢN GHI LẶP LẠI Khung liên kết với ngoại lệ
exceptions.frames.address INT64 Địa chỉ trong hình ảnh nhị phân chứa mã
Chưa đặt cho khung Java
exceptions.frames.blamed BOOLEAN Liệu Crashlytics có xác định được khung này là nguyên nhân gây ra sự cố hoặc lỗi hay không
exceptions.frames.file STRING Tên của tệp khung
exceptions.frames.library STRING Tên hiển thị của thư viện chứa khung hình
exceptions.frames.line INT64 Số dòng của tệp khung
exceptions.frames.offset INT64 Độ lệch byte vào tệp nhị phân chứa mã
Không được đặt cho các ngoại lệ Java
exceptions.frames.owner STRING Ví dụ: DEVELOPER, VENDOR, RUNTIME, PLATFORM hoặc SYSTEM
exceptions.frames.symbol STRING Ký hiệu được bổ sung hoặc ký hiệu thô nếu không thể bổ sung
exceptions.nested BOOLEAN Đúng cho tất cả ngoại trừ ngoại lệ được gửi gần đây nhất (nghĩa là bản ghi đầu tiên)
exceptions.subtitle STRING Tiêu đề phụ của chuỗi
exceptions.title STRING Tiêu đề của chuỗi bài đăng
exceptions.type STRING Loại ngoại lệ (ví dụ: java.lang.IllegalStateException)
firebase_session_id STRING Mã nhận dạng được tạo tự động cho phiên Firebase được liên kết với sự kiện từ Crashlytics
installation_uuid STRING Mã nhận dạng một lượt cài đặt ứng dụng và thiết bị riêng biệt
is_fatal BOOLEAN Liệu ứng dụng có gặp sự cố hay không
issue_id STRING Vấn đề liên quan đến sự kiện
logs BẢN GHI LẶP LẠI Thông điệp nhật ký có dấu thời gian do trình ghi nhật ký Crashlytics tạo, nếu được bật
logs.message STRING Thông điệp nhật ký
logs.timestamp DẤU THỜI GIAN Thời điểm tạo nhật ký
memory RECORD Trạng thái bộ nhớ của thiết bị
memory.free INT64 Số byte bộ nhớ còn lại
memory.used INT64 Số byte bộ nhớ đã dùng
operating_system RECORD Thông tin chi tiết về hệ điều hành trên thiết bị
operating_system.device_type STRING Loại thiết bị (ví dụ: MOBILE, TABLET, TV, v.v.); còn được gọi là "danh mục thiết bị"
operating_system.display_version STRING Phiên bản hệ điều hành trên thiết bị
operating_system.modification_state STRING Liệu thiết bị có bị sửa đổi hay không (ví dụ: ứng dụng đã bẻ khoá là MODIFIED và ứng dụng đã can thiệp hệ thống là UNMODIFIED)
operating_system.name STRING Tên hệ điều hành trên thiết bị
operating_system.type STRING (Chỉ dành cho ứng dụng của Apple) Loại hệ điều hành đang chạy trên thiết bị (ví dụ: IOS, MACOS, v.v.)
platform STRING Nền tảng của ứng dụng đã đăng ký trong dự án Firebase (giá trị hợp lệ: IOS hoặc ANDROID)
process_state STRING BACKGROUND hoặc FOREGROUND
storage RECORD Bộ nhớ liên tục của thiết bị
storage.free INT64 Dung lượng lưu trữ còn lại (byte)
storage.used INT64 Số byte bộ nhớ đã dùng
threads BẢN GHI LẶP LẠI Các luồng hiện có tại thời điểm xảy ra sự kiện
threads.blamed BOOLEAN Liệu Crashlytics có xác định được khung này là nguyên nhân gây ra sự cố hoặc lỗi hay không
threads.code INT64 (Chỉ dành cho ứng dụng Apple) Mã lỗi của NSError được ghi lại tuỳ chỉnh của ứng dụng
threads.crash_address INT64 Địa chỉ của tín hiệu khiến ứng dụng gặp sự cố; chỉ xuất hiện trên các luồng gốc gặp sự cố
threads.crashed BOOLEAN Liệu luồng có gặp sự cố hay không
threads.frames BẢN GHI LẶP LẠI Khung của chuỗi
threads.frames.address INT64 Địa chỉ trong hình ảnh nhị phân chứa mã
threads.frames.blamed BOOLEAN Liệu Crashlytics có xác định được khung này là nguyên nhân gây ra lỗi hay không
threads.frames.file STRING Tên của tệp khung
threads.frames.library STRING Tên hiển thị của thư viện chứa khung hình
threads.frames.line INT64 Số dòng của tệp khung
threads.frames.offset INT64 Độ lệch byte vào hình ảnh nhị phân chứa mã
threads.frames.owner STRING Ví dụ: DEVELOPER, VENDOR, RUNTIME, PLATFORM hoặc SYSTEM
threads.frames.symbol STRING Ký hiệu được bổ sung hoặc ký hiệu thô nếu không thể bổ sung
threads.queue_name STRING (Chỉ dành cho ứng dụng của Apple) Hàng đợi mà luồng đang chạy
threads.signal_code STRING Mã của tín hiệu khiến ứng dụng gặp sự cố; chỉ xuất hiện trên các luồng gốc gặp sự cố
threads.signal_name STRING Tên của tín hiệu khiến ứng dụng gặp sự cố, chỉ xuất hiện trên các luồng gốc gặp sự cố
threads.subtitle STRING Tiêu đề phụ của chuỗi
threads.thread_name STRING Tên của chuỗi
threads.title STRING Tiêu đề của chuỗi bài đăng
unity_metadata.debug_build BOOLEAN Nếu đây là bản gỡ lỗi
unity_metadata.graphics_copy_texture_support STRING Hỗ trợ sao chép kết cấu đồ hoạ như được xác định trong API Unity
unity_metadata.graphics_device_id INT64 Giá trị nhận dạng của thiết bị đồ hoạ
unity_metadata.graphics_device_name STRING Tên của thiết bị đồ hoạ
unity_metadata.graphics_device_type STRING Loại thiết bị đồ hoạ
unity_metadata.graphics_device_vendor_id INT64 Giá trị nhận dạng của nhà cung cấp bộ xử lý đồ hoạ
unity_metadata.graphics_device_vendor STRING Nhà cung cấp thiết bị đồ hoạ
unity_metadata.graphics_device_version STRING Phiên bản của thiết bị đồ hoạ
unity_metadata.graphics_max_texture_size INT64 Kích thước tối đa dành riêng cho việc kết xuất hoạ tiết
unity_metadata.graphics_memory_size_mb INT64 Bộ nhớ đồ hoạ tính bằng MB
unity_metadata.graphics_render_target_count INT64 Số lượng mục tiêu kết xuất đồ hoạ
unity_metadata.graphics_shader_level INT64 Cấp độ đổ bóng của đồ hoạ
unity_metadata.processor_count INT64 Số lượng bộ xử lý (lõi)
unity_metadata.processor_frequency_mhz INT64 Tần số của(các) bộ xử lý tính bằng MHz
unity_metadata.processor_type STRING Loại bộ xử lý
unity_metadata.screen_refresh_rate_hz INT64 Tốc độ làm mới của màn hình tính bằng Hz
unity_metadata.screen_resolution_dpi STRING DPI của màn hình dưới dạng số thực dấu phẩy động
unity_metadata.screen_size_px STRING Kích thước màn hình tính bằng pixel, được định dạng là chiều rộng x chiều cao
unity_metadata.system_memory_size_mb INT64 Kích thước bộ nhớ của hệ thống tính bằng Mb
unity_metadata.unity_version STRING Phiên bản Unity đang chạy trên thiết bị này
user RECORD (Không bắt buộc) Thông tin thu thập được về người dùng ứng dụng
user.email STRING (Không bắt buộc) Địa chỉ email của người dùng
user.id STRING (Không bắt buộc) Mã nhận dạng dành riêng cho ứng dụng được liên kết với người dùng
user.name STRING (Không bắt buộc) Tên người dùng
variant_id STRING Biến thể vấn đề liên quan đến sự kiện này
Xin lưu ý rằng không phải sự kiện nào cũng có biến thể vấn đề liên quan.


Tập dữ liệu phiên Firebase

Dữ liệu phiên Firebase được xuất vào một tập dữ liệu BigQuery có tên là firebase_sessions. Tập dữ liệu này bao gồm toàn bộ dự án của bạn, ngay cả khi dự án đó có nhiều ứng dụng.

Tables

Theo mặc định, Firebase sẽ tạo các bảng riêng lẻ bên trong tập dữ liệu phiên Firebase cho mỗi ứng dụng trong dự án được liên kết với BigQuery.

Các bảng được đặt tên dựa trên giá trị nhận dạng của ứng dụng (với dấu chấm được chuyển đổi thành dấu gạch dưới) và được thêm vào nền tảng của ứng dụng (_IOS hoặc _ANDROID). Ví dụ: dữ liệu cho một ứng dụng Android có tên gói com.google.test sẽ nằm trong một bảng có tên com_google_test_ANDROID.

Hàng

Mỗi hàng trong bảng đại diện cho một sự kiện phiên đã xảy ra.

Cột

Nếu bạn bật tính năng báo cáo truyền trực tuyến sang BigQuery, thì bảng theo thời gian thực sẽ có các cột giống như bảng theo lô.

Dưới đây là các cột trong bảng chứa dữ liệu phiên Firebase được xuất:

Tên trường Loại dữ liệu Mô tả
instance_id STRING Mã cài đặt Firebase (FID) của thiết bị. Xác định một lượt cài đặt ứng dụng + thiết bị riêng biệt
session_id STRING Mã nhận dạng duy nhất của phiên này
first_session_id STRING Mã nhận dạng đầu tiên của một loạt phiên mà phiên này thuộc về kể từ khi ứng dụng được khởi động nguội. Bạn có thể dùng thuộc tính này để nhóm tất cả các phiên đã diễn ra kể từ khi khởi động nguội. Nếu phiên này là phiên đầu tiên, thì trường này sẽ giống với session_id.
session_index INTEGER Thứ tự của phiên này sau khi ứng dụng khởi động nguội. Đối với phiên đầu tiên sau khi khởi động nguội, giá trị này sẽ là 0. Chỉ mục sẽ tăng lên mỗi khi một phiên được tạo mà không xảy ra khởi động nguội (ví dụ: sau 30 phút không hoạt động).
event_type STRING Loại sự kiện đã xảy ra trong phiên (ví dụ: SESSION_START)
event_timestamp DẤU THỜI GIAN Thời gian xảy ra sự kiện
received_timestamp DẤU THỜI GIAN Thời điểm máy chủ nhận được sự kiện từ thiết bị
performance_data_collection_enabled BOOLEAN Liệu tính năng thu thập dữ liệu của SDK Giám sát hiệu suất Firebase có được bật tại thời điểm diễn ra phiên hay không
crashlytics_data_collection_enabled BOOLEAN Liệu tính năng thu thập dữ liệu của SDK Firebase Crashlytics có được bật tại thời điểm diễn ra phiên hay không
application RECORD Mô tả ứng dụng
application.build_version STRING Phiên bản của bản dựng ứng dụng (ví dụ: 1523456)
application.display_version STRING Phiên bản hiển thị của ứng dụng (ví dụ: 4.1.7)
device RECORD Thiết bị mà sự kiện diễn ra
device.model STRING Mẫu thiết bị
device.manufacturer STRING Nhà sản xuất thiết bị. Đối với các ứng dụng trên nền tảng của Apple, đây sẽ là NULL.
operating_system RECORD Mô tả hệ điều hành của thiết bị
operating_system.display_version STRING Phiên bản hiển thị của hệ điều hành (ví dụ: 10.2.1)
operating_system.name STRING Tên của hệ điều hành
operating_system.type STRING Loại hệ điều hành (ví dụ: IOS). Trường này chỉ được đặt cho các thiết bị của Apple.
operating_system.device_type STRING Loại thiết bị (ví dụ: MOBILE, TABLET, TV)