Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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.

Lược đồ Crashlytics
Giản đồ phiên Firebase (nếu dữ liệu phiên được bật để xuất)
Giản đồ nhật ký thiết bị

Crashlytics lược đồ

`Event`

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

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,
  "routePath": 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` ANDROID, IOS hoặc WEB.
`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 riêng biệt của phiên Firebase.
`eventTime`	`string (Timestamp format)` Dấu thời gian của thiết bị khi sự kiện được ghi lại. 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".
`state_update_time`	`string (Timestamp format)` Thời điểm gần đây nhất mà trạng thái của vấn đề thay đổi. 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".
`first_seen_version`	`string` Phiên bản hiển thị đầu tiên của ứng dụng mà vấn đề này xuất hiện, chỉ được điền cho các vấn đề trên thiết bị di động.
`last_seen_version`	`string` display_version gần đây nhất của ứng dụng mà vấn đề này xuất hiện, chỉ được điền sẵn cho các vấn đề trên thiết bị di động.
`first_time_seen`	`string (Timestamp format)` Lần đầu tiên phát hiện vấn đề này. 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".
`last_time_seen`	`string (Timestamp format)` Thời điểm gần đây nhất phát hiện vấ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 lượt cài đặt ứng dụng quản lý thiết bị. Trường này được dùng để tính số người dùng riêng biệt bị ảnh hưởng.
`crashlyticsSdkVersion`	`string` Phiên bản SDK Crashlytics.
`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 của thiết bị tại thời điểm xảy ra sự cố (dọc hoặc ngang).
`logs[]`	`object (Log)` Thông điệp nhật ký do nhà phát triển ghi lại trong phiên.
`breadcrumbs[]`	`object (Breadcrumb)` Sự kiện Analytics được SDK Analytics ghi lại trong phiên.
`blameFrame`	`object (Frame)` Khung dấu vết ngăn xếp bị Crashlytics cho là có lỗi trong quá trình xử lý. Có thể không có trong trình phân tích trong tương lai.
`exceptions[]`	`object (Exception)` Chỉ dành cho Android và web. 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, do đó, bản ghi cuối cùng là ngoại lệ đầu tiên được gửi.
`errors[]`	`object (Error)` Chỉ dành cho Apple. Lỗi không nghiêm trọng do SDK iOS ghi lại và dấu vết ngăn xếp của lỗi đó.
`threads[]`	`object (Thread)` Các luồng ứng dụng có mặt 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 chuỗi sẽ bị coi là nguyên nhân gây ra lỗi.
`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` Tiêu đề 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 xây dựng của ứng dụng cung cấp, bao gồm cả thông tin về kho lưu trữ quản lý phiên bản.
`routePath`	`string` Chỉ web. Đường dẫn của ứng dụng web khi sự kiện xảy ra, không bao gồm các tham số truy vấn và mảnh.

`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)` 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)` 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 do 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.
`file`	`string` Tên của tệp nguồn chứa khung.
`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ể chuyển đổi.
`offset`	`string (int64 format)` Độ lệch byte vào hình ảnh nhị phân chứa mã. Có trong khung hình gốc.
`address`	`string (int64 format)` Địa chỉ trong hình ảnh nhị phân chứa mã. Có trong 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 khi kết quả phân tích của Crashlytics xác định rằng khung này có khả năng là nguyên nhân gây ra lỗi.

`Exception`

Một ngoại lệ Java hoặc Javascript và dấu vết ngăn xếp của ngoại lệ đó. Chỉ từ ứng dụng Android và ứng dụng web.

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 quan đến trường hợp ngoại lệ.
`nested`	`boolean` Đúng cho tất cả ngoại trừ ngoại lệ được gửi gần đây nhất (tức là bản ghi đầu tiên).
`title`	`string` Tiêu đề của trường hợp ngoại lệ.
`subtitle`	`string` Phụ đề của ngoại lệ.
`blamed`	`boolean` Đúng khi phân tích Crashlytics xác định rằng luồng 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 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 đã ghi nhật ký tuỳ chỉnh của ứng dụng.
`title`	`string` Tiêu đề của lỗi.
`subtitle`	`string` Phụ đề của lỗi.
`blamed`	`boolean` Đúng khi bản 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 chuỗi tin nhắn.
`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 gặp sự cố.
`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 gặp sự cố.
`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 bài đăng.
`subtitle`	`string` Phụ đề của chuỗi tin nhắn.
`blamed`	`boolean` Đúng khi bản phân tích của 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 dấu vết ngăn xếp 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ã hệ thống của luồng, chỉ dành cho 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 chuỗi chưa được chỉ đị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ờ và đã 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 gì.
`THREAD_STATE_NATIVE_RUNNABLE`	Luồng này là luồng gốc và chúng tôi không thể xác định theo phương pháp 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 được.
`THREAD_STATE_NATIVE_WAITING`	Chúng tôi đã xác định theo phương pháp phỏng đoán rằng luồng đang chờ.

Giản đồ phiên Firebase

`FirebaseSessionEvent`

Phiên được ghi lại bằng SDK Phiên chất lượng ứng dụng Firebase.

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 riêng biệt của 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 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 ứ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`	Đã bắt đầu phiên đăng ký.

Giản đồ 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 liên kết với giá trị này.
`sessionId`	`string` Giá trị nhận dạng riêng biệt của phiên Firebase.
Trường nhóm `payload`. Trọng tải 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ả

Trường	Mô tả
`logTime`	`string (Timestamp format)` Dấu thời gian của thiết bị khi dòng được ghi lại. 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 điệp nhật ký.

logTime

string (Timestamp format)

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

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 điệp nhật ký.

`Breadcrumb`

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ả

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" }.

eventTime

string (Timestamp format)

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

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" }.

Giản đồ nhật ký cho dữ liệu đã xuất trong Cloud Logging Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Crashlytics lược đồ

Event

Memory

Storage

User

Frame

Exception

Error

Thread

State

Giản đồ phiên Firebase

FirebaseSessionEvent

SessionEventType

Giản đồ Nhật ký thiết bị

DeviceLog

Log

Breadcrumb

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

`Event`

`Memory`

`Storage`

`User`

`Frame`

`Exception`

`Error`

`Thread`

`State`

`FirebaseSessionEvent`

`SessionEventType`

`DeviceLog`

`Log`

`Breadcrumb`