Tính năng ghi nhật ký trên đám mây cho hệ sinh thái Google Home

Từ đám mây đến đám mây    Matter

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 View all products (Xem tất cả sản phẩm), sau đó chuyển đến Operations (Hoạt động) > Logging (Ghi nhật ký).

Chuyển đến Cloud Logging

Quyền truy cập vào dữ liệu ghi nhật ký được quản lý thông qua Identity and Access Management (IAM) (Quản lý danh tính và quyền truy cập) cho người dùng dự án Actions của bạn. Để biết thêm thông tin chi tiết về các vai trò và quyền đối với dữ liệu ghi nhật ký, hãy xem bài viết Kiểm soát quyền truy cập vào Cloud Logging .

Các mục nhật ký được giữ lại trong 30 ngày theo chính sách giữ lại dữ liệu 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 Một vùng chứa cho Dự án trên Google Cloud được liên kết với một Hành động của Trợ lý.
  • project_id: Mã nhận dạng của dự án hiện tại được liên kết với tài nguyên này, ví dụ: my-project.

Nhật ký sự kiện

Các dự án Cloud-to-cloud hỗ trợ các 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 SYNC
Lỗi ý địnhQUERY
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 syncLog:

Thuộc tính Mô tả
requestId Mã yêu cầu ý định 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 phản hồi ý định.

Nhật ký thực thi

Bảng dưới đây liệt kê giản đồ của một mục 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 Giao 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 hoạt động tích hợp của bạn.
actionType Chỉ báo không bắt buộc về hành động của người dùng đã thực hiện, ví dụ: QUERY hoặc EXECUTE. Đối với các hành động EXECUTE, bao gồm lệnh được gửi đến quá trình 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 đượ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ị bị ảnh hưởng bởi 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 quá trình thực hiện trên đám mây sau khi xảy ra lỗi từ quá trình thực hiện cục bộ 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 quá trình thực hiện cung cấp.
externalDebugString Thông báo gỡ lỗi chi tiết không bắt buộc đượ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 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.

Cài đặt cấp độ nhật ký

Các dự án Cloud-to-cloud được thiết lập để nhận nhật ký lỗi theo mặc định, và nhà phát triển có thể chọn nhận cả 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 dự định thu thập tất cả nhật ký từ một vài 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:

  1. Trong Actions on Google Console, hãy chuyển đến trang Projects (Dự án).

    Chuyển đến Bảng điều khiển Actions on Google

  2. Chọn dự án nhà thông minh của bạn.

  3. Chọn thẻ Develop (Phát triển), rồi nhấp vào Actions (Hành động) trên thanh bên.

  4. Chọn All (Tất cả) trong danh sách thả xuống Log control ingestion (Thu thập dữ liệu kiểm soát nhật ký).

Tiêu chí loại trừ nhật ký

Nhà phát triển có thể tạo tiêu chí loại trừ nhật ký bằng ngôn ngữ truy vấn nhật ký để tuỳ chỉnh nhật ký theo cách linh hoạt hơn. Ngôn ngữ truy vấn nhật ký cũng được Trình khám phá nhật ký sử dụng để bạn có thể dùng Trình khám phá nhật ký để giúp tạo truy vấn.

Bạn có thể làm theo các bước tạo bộ lọc Loại trừ tại hướng dẫn này (định cấu hình bộ lọc Loại trừ cho bồn lưu trữ dữ liệu _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ỉnhthiết lập cảnh báo về các chỉ số dựa trên nhật ký.

Để bắt đầu sử dụng các 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ý bộ đếm.

Để 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: documentation:

  • Giá: Thông tin chi tiết về hạn mức và chi phí vượt quá.
  • 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 lưu giữ đối với việc sử dụng tính năng ghi nhật ký.
  • 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ý.