Bạn có thể truy cập vào nhật ký sự kiện cho các hoạt động tích hợp của mình từ Google Cloud Logging. Sử dụng Cloud Logging để khám phá nhật ký, tạo chỉ số và cảnh báo hoặc xuất nhật ký sang các ứng dụng khác bằng Google Cloud Pub/Sub.
Ghi nhật ký truy cập
Để truy cập vào Cloud Logging từ Google Cloud Console, hãy nhấp vào Xem tất cả sản phẩm, sau đó chuyển đến Hoạt động > Ghi nhật ký.
Quyền truy cập vào dữ liệu nhật ký được quản lý thông qua dịch vụ Quản lý danh tính và quyền truy cập (IAM) cho người dùng dự án Actions của bạn. Để biết thêm thông tin về vai trò và quyền đối với dữ liệu ghi nhật ký, hãy xem phần kiểm soát quyền truy cập của Cloud Logging.
Các mục nhật ký được lưu giữ trong 30 ngày theo chính sách lưu giữ của Cloud Logging, sau đó được lên lịch xoá. Bạn cũng có thể xoá các mục theo yêu cầu bằng cách sử dụng giao diện Trình khám phá nhật ký.
Bạn có thể tìm hiểu thêm về cách sử dụng nhật ký một cách hiệu quả trong phần Tìm kiếm nhật ký của Hướng dẫn khắc phục sự cố.
Cloud Logging cung cấp các loại tài nguyên sau:
| Loại tài nguyên | Tên hiển thị | Mô tả | Nhãn |
|---|---|---|---|
assistant_action_project |
Dự án Hành động của Trợ lý Google | Vùng chứa cho Dự án trên Google Cloud được liên kết với một Thao tác của Trợ lý. |
|
Nhật ký sự kiện
Các dự án Cloud-to-cloud hỗ trợ những sự kiện sau trong Cloud Logging:
| Tài nguyên Cloud Logging | Sự kiện |
|---|---|
| Dự án Hành động của Trợ lý Google | Lỗi ý định SYNC |
| Lỗi về ý định QUERY | |
| Lỗi ý định EXECUTE | |
| Thông báo lỗi | |
| Lỗi liên kết tài khoản | |
| Local Home SDK HandlerError |
Nhật ký đồng bộ hoá
Bảng dưới đây liệt kê giản đồ của một mục nhập syncLog:
| Thuộc tính | Mô tả |
|---|---|
requestId |
Mã yêu cầu về ý định đối với nhà thông minh. |
httpLatencyMsec |
Thời gian trôi qua trước khi nhận được phản hồi. |
status |
Cho biết trạng thái của câu trả lời cho ý định. |
Nhật ký thực thi
Bảng dưới đây liệt kê giản đồ của một mục nhập executionLog:
| Thuộc tính | Mô tả |
|---|---|
requestId |
Mã yêu cầu duy nhất, ví dụ: 5325511189174727525. |
latencyMsec |
Thời gian đã trôi qua trước khi nhận được phản hồi, ví dụ: 6000. |
executionType |
Phương thức truyền tải được dùng cho yêu cầu, ví dụ: CLOUD hoặc MATTER, tuỳ thuộc vào chế độ tích hợp của bạn. |
actionType |
Chỉ báo không bắt buộc về hành động mà người dùng đã thực hiện, ví dụ: QUERY hoặc EXECUTE.
Đối với các thao tác EXECUTE, bao gồm lệnh được đưa ra để thực hiện cho các đặc điểm được hỗ trợ, ví dụ: ONOFF_OFF
|
trait |
Đặc điểm không bắt buộc liên kết với hành động này của người dùng. |
deviceTypes |
Danh sách các loại thiết bị chịu ảnh hưởng của sự kiện, ví dụ: LIGHT. |
isSuccess |
Yêu cầu có nhận được phản hồi thành công hay không. |
fallbackToCloud |
Yêu cầu có được chuyển đến dịch vụ thực hiện đơn hàng trên đám mây sau khi xảy ra lỗi từ dịch vụ thực hiện đơn hàng tại địa phương hay không. |
statusType |
Cho biết trạng thái của phản hồi ý định, chẳng hạn như SUCCESS, PENDING hoặc OFFLINE. Đối với các phản hồi ERROR, thuộc tính này chứa errorCode do dịch vụ thực hiện đơn hàng cung cấp.
|
externalDebugString |
Thông báo gỡ lỗi chi tiết không bắt buộc liên kết với hành động này của người dùng. |
locale |
Mã ngôn ngữ được liên kết với yêu cầu. |
Nhật ký thông báo
Bảng dưới đây liệt kê giản đồ của một mục nhập notificationLog:
| Thuộc tính | Mô tả |
|---|---|
requestId |
Mã yêu cầu thông báo. |
structName |
Tên của cấu trúc thông báo, chẳng hạn như "ObjectDetection". |
status |
Cho biết trạng thái của thông báo. |
Chế độ cài đặt cấp độ nhật ký
Theo mặc định, các dự án Cloud-to-cloud được thiết lập để nhận nhật ký lỗi và nhà phát triển cũng có thể chọn nhận nhật ký thành công. Điều này đặc biệt hữu ích trong giai đoạn phát triển khi bạn có kế hoạch ghi lại tất cả nhật ký từ một số tác nhân. Dự án của bạn có thể phải chịu thêm phí nếu bạn vượt quá hạn mức ghi nhật ký.
Bạn có thể kiểm soát cấp độ nhật ký cho dự án của mình bằng cách:
Trong Actions on Google Console, hãy chuyển đến trang Dự án.
Chọn dự án nhà thông minh của bạn.
Chọn thẻ Phát triển rồi nhấp vào Thao tác trên thanh bên.
Chọn Tất cả trong danh sách thả xuống Log control ingestion (Truy cập nhật ký kiểm soát).
Tiêu chí loại trừ nhật ký
Nhà phát triển có thể tạo các loại trừ nhật ký bằng cách sử dụng ngôn ngữ truy vấn ghi nhật ký để tuỳ chỉnh nhật ký theo cách linh hoạt hơn. Logs Explorer cũng sử dụng ngôn ngữ truy vấn ghi nhật ký, vì vậy, bạn có thể dùng Logs Explorer để tạo truy vấn.
Bạn có thể làm theo các bước để tạo bộ lọc loại trừ trong hướng dẫn này (định cấu hình bộ lọc loại trừ cho _Default).
Chỉ số dựa trên nhật ký
Nhà phát triển có thể sử dụng Chỉ số dựa trên nhật ký để theo dõi và phân tích các mẫu trong nhật ký của họ. Bạn cũng có thể tạo biểu đồ tuỳ chỉnh và thiết lập cảnh báo trên các chỉ số dựa trên nhật ký.
Để bắt đầu sử dụng chỉ số dựa trên nhật ký cho nhà thông minh, hãy xem hướng dẫn tạo chỉ số dựa trên nhật ký của bộ đếm.
Thông tin có liên quan
Để tìm hiểu thêm về cách sử dụng Cloud Logging trong dự án của bạn, hãy xem tài liệu sau đây:
- Định giá: Thông tin chi tiết về hạn mức và chi phí vượt hạn mức.
- Hạn mức và giới hạn: Thông tin chi tiết về các giới hạn và chính sách giữ lại đối với việc ghi nhật ký mức sử dụng.
- Truy vấn nhật ký nâng cao: Hướng dẫn sử dụng các biểu thức nâng cao để truy vấn và phân tích dữ liệu nhật ký.