Giản đồ nhật ký cho dữ liệu đã xuất trong Cloud Logging

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


Crashlytics giản đồ

Event

Thông báo mô tả một sự kiện Crashlytics duy nhất.

Biểu diễn dưới dạng JSON

{
  "name": string,
  "platform": string,
  "bundleOrPackage": string,
  "eventId": string,
  "sessionId": string,
  "eventTime": string,
  "receivedTime": string,
  "issue": {
    object (Issue)
  },
  "issueVariant": {
    object (IssueVariant)
  },
  "device": {
    object (Device)
  },
  "memory": {
    object (Memory)
  },
  "storage": {
    object (Storage)
  },
  "operatingSystem": {
    object (OperatingSystem)
  },
  "browser": {
    object (Browser)
  },
  "version": {
    object (Version)
  },
  "user": {
    object (User)
  },
  "customKeys": {
    string: string,
    ...
  },
  "installationUuid": string,
  "crashlyticsSdkVersion": string,
  "appOrientation": string,
  "deviceOrientation": string,
  "logs": [
    {
      object (Log)
    }
  ],
  "breadcrumbs": [
    {
      object (Breadcrumb)
    }
  ],
  "blameFrame": {
    object (Frame)
  },
  "exceptions": [
    {
      object (Exception)
    }
  ],
  "errors": [
    {
      object (Error)
    }
  ],
  "threads": [
    {
      object (Thread)
    }
  ],
  "processState": string,
  "issueTitle": string,
  "issueSubtitle": string,
  "buildStamp": string
}
Trường Mô tả
name string

Bắt buộc. Chỉ có đầu ra. Không thể thay đổi. Giá trị nhận dạng. Tên của tài nguyên sự kiện. Định dạng: projects/{project}/apps/{app_id}/events/{event}.
platform string

Nền tảng di động (Android hoặc iOS).
bundleOrPackage string

Tên gói cho ứng dụng iOS hoặc tên gói của ứng dụng Android. Định dạng: com.mycompany.myapp.
eventId string

Chỉ có đầu ra. Không thể thay đổi. Giá trị nhận dạng sự kiện duy nhất được chỉ định trong quá trình xử lý.
sessionId string

Giá trị nhận dạng duy nhất cho phiên Firebase.
eventTime string (Timestamp format)

Dấu thời gian của thiết bị tại thời điểm ghi lại sự kiện.

Dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
receivedTime string (Timestamp format)

Dấu thời gian của máy chủ tại thời điểm Crashlytics nhận được sự kiện.

Dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
issue object (Issue)

Thông tin chi tiết về [Vấn đề] được chỉ định cho [Sự kiện] này.
issueVariant object (IssueVariant)

Thông tin chi tiết về [IssueVariant] được chỉ định cho [Event] này.
device object (Device)

Siêu dữ liệu của thiết bị di động.
memory object (Memory)

Mức sử dụng bộ nhớ của thiết bị di động.
storage object (Storage)

Mức sử dụng ổ đĩa/bộ nhớ flash của thiết bị di động.
operatingSystem object (OperatingSystem)

Hệ điều hành và phiên bản.
browser object (Browser)

Trình duyệt và phiên bản.
version object (Version)

Phiên bản ứng dụng di động.
user object (User)

Giá trị nhận dạng người dùng cuối cho chủ sở hữu thiết bị.
customKeys map (key: string, value: string)

Khoá tuỳ chỉnh do nhà phát triển đặt trong phiên.

Một đối tượng chứa danh sách các cặp "khoá": giá trị. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
installationUuid string

Giá trị nhận dạng riêng biệt cho quá trình cài đặt ứng dụng trên thiết bị. Trường này được dùng để tính số lượng người dùng riêng biệt chịu ảnh hưởng.
crashlyticsSdkVersion string

Phiên bản Crashlytics SDK.
appOrientation string

Hướng của ứng dụng tại thời điểm xảy ra sự cố (dọc hoặc ngang).
deviceOrientation string

Hướng thiết bị tại thời điểm xảy ra sự cố (dọc hoặc ngang).
logs[] object (Log)

Ghi lại các thông báo do nhà phát triển ghi lại trong phiên.
breadcrumbs[] object (Breadcrumb)

Các sự kiện Analytics do SDK Analytics ghi lại trong phiên.
blameFrame object (Frame)

Khung dấu vết ngăn xếp do quá trình xử lý Crashlytics gây ra. Có thể không xuất hiện trong trình phân tích cú pháp trong tương lai.
exceptions[] object (Exception)

Chỉ dành cho thiết bị 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, để bản ghi cuối cùng là ngoại lệ đầu tiên được đưa ra.
errors[] object (Error)

Chỉ dành cho Apple. Lỗi không nghiêm trọng do iOS SDK và dấu vết ngăn xếp của lỗi đó ghi lại.
threads[] object (Thread)

Các luồng ứng dụng xuất hiện tại thời điểm sự kiện được ghi lại. Mỗi tệp chứa một dấu vết ngăn xếp. Một luồng sẽ bị đổ lỗi cho lỗi này.
processState string

Trạng thái của quy trình ứng dụng tại thời điểm xảy ra sự kiện.
issueTitle string

Tiêu đề của vấn đề mà sự kiện được nhóm vào. Đây thường là tên tệp nguồn hoặc tên phương thức.
issueSubtitle string

Phụ đề của vấn đề mà sự kiện được nhóm vào. Đây thường là một biểu tượng hoặc thông báo ngoại lệ.
buildStamp string

Siêu dữ liệu do hệ thống bản dựng của ứng dụng cung cấp, bao gồm cả thông tin về kho lưu trữ kiểm soát phiên bản.

Memory

Mức sử dụng bộ nhớ của thiết bị di động.

Biểu diễn dưới dạng JSON

{
  "used": string,
  "free": string
}
Trường Mô tả
used string (int64 format)

Số byte đang được sử dụng.
free string (int64 format)

Số byte trống.

Storage

Mức sử dụng ổ đĩa/bộ nhớ flash của thiết bị di động. Không được báo cáo cho tất cả thiết bị.

Biểu diễn dưới dạng JSON

{
  "used": string,
  "free": string
}
Trường Mô tả
used string (int64 format)

Số byte đã dùng.
free string (int64 format)

Số byte trống.

User

Giá trị nhận dạng người dùng cuối do nhà phát triển cung cấp.

Biểu diễn dưới dạng JSON

{
  "id": string
}
Trường Mô tả
id string

Mã nhận dạng người dùng (nếu nhà phát triển ứng dụng cung cấp).

Frame

Một khung trong dấu vết ngăn xếp.

Biểu diễn dưới dạng JSON

{
  "line": string,
  "file": string,
  "symbol": string,
  "offset": string,
  "address": string,
  "library": string,
  "owner": string,
  "blamed": boolean
}
Trường Mô tả
line string (int64 format)

Số dòng trong tệp của khung hình.
file string

Tên của tệp nguồn mà khung hình được tìm thấy.
symbol string

Biểu tượng khung sau khi được gỡ rối mã nguồn hoặc thay thế bằng biểu tượng. Ký hiệu thô từ thiết bị nếu không thể được bổ sung.
offset string (int64 format)

Độ lệch byte trong hình ảnh nhị phân chứa mã. Hiện tại cho các khung hình gốc.
address string (int64 format)

Địa chỉ trong hình ảnh nhị phân chứa mã. Trình bày cho các khung hình gốc.
library string

Tên hiển thị của thư viện chứa khung hình.
owner string

Một trong các giá trị DEVELOPER, VENDOR, RUNTIME, PLATFORM hoặc SYSTEM.
blamed boolean

True (đúng) khi quá trình phân tích Crashlytics xác định rằng khung này có thể là nguyên nhân gây ra lỗi.

Exception

Một ngoại lệ Java và dấu vết ngăn xếp của ngoại lệ đó, chỉ từ các ứng dụng Android.

Biểu diễn dưới dạng JSON

{
  "type": string,
  "exceptionMessage": string,
  "nested": boolean,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ]
}
Trường Mô tả
type string

Loại ngoại lệ, ví dụ: java.lang.IllegalStateException.
exceptionMessage string

Thông báo liên kết với trường hợp ngoại lệ.
nested boolean

Đúng cho tất cả, ngoại trừ ngoại lệ được ném cuối cùng (tức là bản ghi đầu tiên).
title string

Tiêu đề của ngoại lệ.
subtitle string

Phụ đề của trường hợp ngoại lệ.
blamed boolean

True khi quá trình phân tích Crashlytics xác định rằng lỗi xảy ra ở luồng này.
frames[] object (Frame)

Các khung trong dấu vết ngăn xếp của ngoại lệ.

Error

Lỗi không nghiêm trọng và dấu vết ngăn xếp của lỗi đó, chỉ từ các ứng dụng của Apple.

Biểu diễn dưới dạng JSON

{
  "queue": string,
  "code": string,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ]
}
Trường Mô tả
queue string

Hàng đợi mà luồng đang chạy.
code string (int64 format)

Mã lỗi liên kết với NSError tuỳ chỉnh được ghi lại của ứng dụng.
title string

Tiêu đề của lỗi.
subtitle string

Phụ đề của lỗi.
blamed boolean

True khi quá trình phân tích Crashlytics xác định rằng dấu vết ngăn xếp trong lỗi này là nơi xảy ra lỗi.
frames[] object (Frame)

Các khung trong dấu vết ngăn xếp của lỗi.

Thread

Một luồng ứng dụng.

JSON representation</code></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td><code>{
  "crashed": boolean,
  "name": string,
  "queue": string,
  "signal": string,
  "signalCode": string,
  "crashAddress": string,
  "title": string,
  "subtitle": string,
  "blamed": boolean,
  "frames": [
    {
      object (Frame)
    }
  ],
  "threadId": string,
  "sysThreadId": string,
  "threadState": enum (State)
}
Trường Mô tả
crashed boolean

Đúng khi luồng gặp sự cố.
name string

Tên của luồng.
queue string

Hàng đợi mà luồng đang chạy.
signal 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 bị lỗi.
signalCode 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 bị lỗi.
crashAddress string (int64 format)

Đị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 bị lỗi.
title string

Tiêu đề của chuỗi.
subtitle string

Phụ đề của chuỗi tin nhắn.
blamed boolean

True khi quá trình phân tích Crashlytics xác định rằng dấu vết ngăn xếp trong luồng này là nơi xảy ra lỗi.
frames[] object (Frame)

Các khung trong stacktrace của luồng.
threadId string (int64 format)

Mã nhận dạng của luồng, chỉ có sẵn cho các luồng ANR.
sysThreadId string (int64 format)

Mã nhận dạng hệ thống của luồng, chỉ có sẵn cho các luồng ANR.
threadState enum (State)

Chỉ có đầu ra. Trạng thái của luồng tại thời điểm xảy ra lỗi ANR.

State

Trạng thái của một luồng khi xảy ra lỗi ANR.

Enum Mô tả
STATE_UNSPECIFIED

Trạng thái luồng không xác định.
THREAD_STATE_TERMINATED

Chuỗi đã bị chấm dứt.
THREAD_STATE_RUNNABLE

Luồng có thể chạy.
THREAD_STATE_TIMED_WAITING

Luồng đang chờ hết thời gian chờ.
THREAD_STATE_BLOCKED

Chuỗi đã bị chặn.
THREAD_STATE_WAITING

Luồng đang chờ.
THREAD_STATE_NEW

Luồng đã bắt đầu, nhưng chưa chạy bất kỳ nội dung nào.
THREAD_STATE_NATIVE_RUNNABLE

Luồng này là luồng gốc và chúng tôi không thể xác định một cách phỏng đoán rằng luồng này đang chờ, vì vậy, hãy giả định rằng luồng này có thể chạy.
THREAD_STATE_NATIVE_WAITING

Chúng tôi xác định một cách kinh nghiệm rằng luồng đang chờ.


Lược đồ phiên Firebase

FirebaseSessionEvent

Các phiên do Firebase App Quality Sessions SDK ghi lại.

Biểu diễn dưới dạng JSON

{
  "sessionId": string,
  "eventType": enum (SessionEventType),
  "firstSessionId": string,
  "sessionIndex": integer,
  "firebaseInstallationId": string,
  "eventTime": string,
  "version": {
    object (Version)
  },
  "device": {
    object (Device)
  },
  "operatingSystem": {
    object (OperatingSystem)
  }
}
Trường Mô tả
sessionId string

Giá trị nhận dạng duy nhất cho phiên Firebase.
eventType enum (SessionEventType)

Loại sự kiện trong phiên. Hiện tại, SDK chỉ hỗ trợ các sự kiện SESSION_START.
firstSessionId string

Giá trị nhận dạng của phiên đầu tiên kể từ lần khởi động nguội gần đây nhất. Mã nhận dạng này và sessionId sẽ giống nhau đối với các lần khởi chạy ứng dụng.
sessionIndex integer

Cho biết số phiên kể từ lần khởi động nguội gần đây nhất.
firebaseInstallationId string

Xác định duy nhất một thiết bị đã cài đặt ứng dụng Firebase.
eventTime string (Timestamp format)

Dấu thời gian bắt đầu cho sự kiện trong phiên.

Dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
version object (Version)

Số phiên bản của ứng dụng di động.
device object (Device)

Siêu dữ liệu của thiết bị di động.
operatingSystem object (OperatingSystem)

Hệ điều hành và phiên bản.

SessionEventType

Các loại SessionEvent được ghi lại.

Enum Mô tả
SESSION_EVENT_TYPE_UNKNOWN

Chưa biết.
SESSION_START

Phiên ứng dụng đã bắt đầu.


Lược đồ Nhật ký thiết bị

DeviceLog

Biểu thị cấu trúc của các mục deviceLog.

Biểu diễn dưới dạng JSON

{
  "eventId": string,
  "sessionId": string,

  // Union field payload can be only one of the following:
  "log": {
    object (Log)
  },
  "breadcrumb": {
    object (Breadcrumb)
  }
  // End of list of possible types for union field payload.
}
Trường Mô tả
eventId string

Chỉ có đầu ra. Không thể thay đổi. Giá trị nhận dạng của sự kiện mà thông số này được liên kết.
sessionId string

Giá trị nhận dạng duy nhất cho phiên Firebase.

Trường nhóm payload. Tải trọng có thể là nhật ký Crashlytics hoặc Breadcrumb. payload chỉ có thể là một trong những trạng thái sau:
log object (Log)

Nhật ký Crashlytics.
breadcrumb object (Breadcrumb)

Đường dẫn Crashlytics.

Log

Các dòng nhật ký do nhà phát triển cung cấp được ghi lại trong phiên.

Biểu diễn dưới dạng JSON

{
  "logTime": string,
  "message": string
}
Trường Mô tả
logTime string (Timestamp format)

Dấu thời gian của thiết bị khi dòng được ghi nhật ký.

Dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
message string

Thông báo nhật ký.

Breadcrumb

Các sự kiện Analytics được ghi lại trong phiên.

Biểu diễn dưới dạng JSON

{
  "eventTime": string,
  "title": string,
  "params": {
    string: string,
    ...
  }
}
Trường Mô tả
eventTime string (Timestamp format)

Dấu thời gian của thiết bị cho sự kiện.

Dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
title string

Tên sự kiện phân tích.
params map (key: string, value: string)

Thông số sự kiện.

Một đối tượng chứa danh sách các cặp "khoá": giá trị. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.