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 về phiên hoạt động trên Firebase trong BigQuery.

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


Crashlytics tập dữ liệu

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.

Bảng

Theo mặc định, Firebase sẽ tạo các bảng riêng lẻ 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 là com.google.test sẽ nằm trong một bảng có tên là com_google_test_ANDROID.

  • Nếu bạn bật chế độ xuất 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 vào một bảng có thêm _REALTIME (ví dụ: 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 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 bộ 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 của mình (iOS+ | Android | Flutter | Unity).

Hàng

Mỗi hàng trong bảng thể hiện một lỗi mà ứng dụng gặp phải.

Cột

Các cột trong bảng này 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 xuất theo luồng 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 những 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 cho dữ liệu Crashlytics đã 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 khung này là nguyên nhân gây ra sự cố hay lỗi hay không
blame_frame.file STRING Tên của tệp khung hình
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 hình ảnh nhị phân chứa mã
Chưa đặt cho các trường hợp ngoại lệ Java
blame_frame.owner STRING Ví dụ: DEVELOPER, VENDOR, RUNTIME, PLATFORM hoặc SYSTEM
blame_frame.symbol STRING Biểu tượng được kết hợp hoặc biểu tượng thô nếu không kết hợp được
breadcrumbs REPEATED RECORD Google AnalyticsTập hợp liên kết phân cấp có dấu thời gian (nếu được bật)
breadcrumbs.name STRING Tên liên kết với đường liên kết dạng đánh dấu
breadcrumbs.params REPEATED RECORD Các tham số được liên kết với đường liên kết dạng đánh dấu
breadcrumbs.params.key STRING Khoá thông số được liên kết với đường dẫn
breadcrumbs.params.value STRING Giá trị tham số được liên kết với đường liên kết
breadcrumbs.timestamp DẤU THỜI GIAN Dấu thời gian liên kết với đường đánh dấu
bundle_identifier STRING Giá trị nhận dạng riêng biệt cho ứng dụng khi được đăng ký trong dự án Firebase (ví dụ: com.google.gmail)
Đối với các ứ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 các ứ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 REPEATED RECORD 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ị mà sự kiện diễn ra
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 REPEATED RECORD (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 rằng khung hình 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 tuỳ chỉnh được ghi nhật ký của ứng dụng
error.frames REPEATED RECORD Khung của stacktrace
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 rằng khung hình 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 hình
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 Biểu tượng được kết hợp hoặc biểu tượng thô nếu không kết hợp được
error.queue_name STRING Hàng đợi mà luồng đang chạy
error.subtitle STRING Phụ đề của chuỗi
error.title STRING Tiêu đề của chuỗi
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 xảy ra sự kiện
exceptions REPEATED RECORD (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, tức là bản ghi cuối cùng là ngoại lệ đầu tiên được đưa ra
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 REPEATED RECORD Các khung hình 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 khung này là nguyên nhân gây ra sự cố hay lỗi hay không
exceptions.frames.file STRING Tên của tệp khung hình
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 hình ảnh nhị phân chứa mã
Chưa đặt cho các trường hợp ngoại lệ Java
exceptions.frames.owner STRING Ví dụ: DEVELOPER, VENDOR, RUNTIME, PLATFORM hoặc SYSTEM
exceptions.frames.symbol STRING Biểu tượng được kết hợp hoặc biểu tượng thô nếu không kết hợp được
exceptions.nested BOOLEAN Đúng cho tất cả, trừ ngoại lệ được ném cuối cùng (tức là bản ghi đầu tiên)
exceptions.subtitle STRING Phụ đề của chuỗi
exceptions.title STRING Tiêu đề của chuỗi
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 giúp xác định một lượt cài đặt ứng dụng và thiết bị riêng biệt
is_fatal BOOLEAN Ứng dụng có gặp sự cố hay không
issue_id STRING Vấn đề liên quan đến sự kiện
logs REPEATED RECORD 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 báo được ghi vào 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 Thiết bị đã bị sửa đổi hay chưa (ví dụ: ứng dụng đã bẻ khoá là MODIFIED và ứng dụng đã can thiệp vào hệ thống là UNMODIFIED)
operating_system.name STRING Tên của hệ điều hành trên thiết bị
operating_system.type STRING (Chỉ dành cho ứng dụng 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 như đã đă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ớ ổn định của thiết bị
storage.free INT64 Số byte bộ nhớ còn trống
storage.used INT64 Số byte bộ nhớ đã dùng
threads REPEATED RECORD Các luồng có tại thời điểm xảy ra sự kiện
threads.blamed BOOLEAN Liệu Crashlytics có xác định khung này là nguyên nhân gây ra sự cố hay lỗi hay không
threads.code INT64 (Chỉ dành cho ứng dụng Apple) Mã lỗi của NSError tuỳ chỉnh được ứng dụng ghi lại
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 Chuỗi có bị lỗi hay không
threads.frames REPEATED RECORD Các khung hình của luồng
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 rằng khung hình 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 hình
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 Biểu tượng được tạo hoặc biểu tượng thô nếu không thể tạo
threads.queue_name STRING (Chỉ dành cho ứng dụng Apple) Hàng đợi mà luồng đang chạy
threads.signal_code STRING Mã của tín hiệu gây ra sự cố cho ứng dụng; 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 Phụ đề của chuỗi
threads.thread_name STRING Tên của luồng
threads.title STRING Tiêu đề của chuỗi
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 hoạ tiết đồ hoạ như được xác định trong Unity API
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 Mã 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 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ập phân
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 Dung lượng 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 được thu thập 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 của 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.

Bảng

Theo mặc định, Firebase sẽ tạo các bảng riêng lẻ trong tập dữ liệu phiên Firebase cho từng ứng dụng trong dự án của bạ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 (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 thể hiện một sự kiện phiên đã xảy ra.

Cột

Nếu bạn bật tính năng xuất theo luồng sang BigQuery, thì bảng theo thời gian thực sẽ có các cột giống như bảng theo lô.

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

Tên trường Loại dữ liệu Mô tả
instance_id STRING Mã nhận dạng lượt cài đặt Firebase (FID) trên thiết bị. Xác định một bản cài đặt ứng dụng + thiết bị duy nhấ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 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 đây là phiên đầu tiên, thì trường này sẽ giống với session_id.
session_index INTEGER Thứ tự phiên này xuất hiện 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 có lần khởi động nguội nào xảy ra (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 diễn ra sự kiện
received_timestamp DẤU THỜI GIAN Thời gian 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 bản dựng của ứ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 nền tảng Apple, miền nà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)