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

Đám mây với đám mây    Vấn đề

Bạn có thể truy cập vào nhật ký sự kiện cho các công cụ 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ý quyền truy cập

Để truy cập Cloud Logging từ Google Cloud Console, nhấp vào Xem tất cả sản phẩm, rồi chuyển đến Vận hành > Ghi nhật ký.

Truy cập Cloud Logging

Quyền truy cập vào dữ liệu ghi nhật ký được quản lý thông qua giải pháp Quản lý danh tính và quyền truy cập (IAM) đối với người dùng trong dự án Actions của bạn. Để biết thêm chi tiết về vai trò và quyền cho dữ liệu ghi nhật ký, xem Ghi nhật ký trên đám mây kiểm soát truy cập.

Các mục nhập nhật ký được lưu giữ trong 30 ngày theo Cloud Logging chính sách giữ lại dữ liệu, sau đó được lập lịch để xóa. 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 của Trình khám phá nhật ký.

Bạn có thể tìm hiểu thêm về cách sử dụng hiệu quả nhật ký trong phần Nhật ký tìm kiếm 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 Google Cloud liên kết với một Trợ lý Hành động.
  • project_id: Giá trị nhận dạng của dự án hiện tại của bạn đượ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 Ghi nhật ký:

Tài nguyên ghi nhật ký trên đám mây Sự kiện
Dự án hành động của Trợ lý Google Lỗi ý định SYNC
Lỗi ý định QUERY
Lỗi ý định EXECUTE
Thông báo các lỗi
Liên kết tài khoản các lỗi
SDK cục bộ cho nhà riêng HandlerError

Đồng bộ hoá nhật ký

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 của ý định nhà thông minh.
httpLatencyMsec Thời gian đã trôi qua trước khi nhận được câu trả lờ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 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 câu trả lời, ví dụ: 6000.
executionType Công cụ di chuyển được dùng cho yêu cầu, ví dụ: CLOUD hoặc MATTER, tuỳ thuộc vào quá trình 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, hãy bao gồm lệnh được đưa ra cho phương thức thực hiện cho các đặc điểm được hỗ trợ, ví dụ: ONOFF_OFF
trait Trait 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 Liệu yêu cầu có nhận được phản hồi thành công hay không.
fallbackToCloud Liệu yêu cầu có được gửi đến phương thức thực hiện trên đám mây sau khi xảy ra lỗi hay không từ việc thực hiện đơn hàng tại địa phươ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. Dành cho ERROR phản hồi, thuộc tính này chứa errorCode do phương thức 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ữ 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, Cloud-to-cloud dự án được thiết lập để nhận nhật ký lỗi, 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 định nắm bắt tất cả nhật ký từ một vài tác nhân. Bạn có thể phải trả thêm phí cho dự án 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 Dự án.

    Truy cập 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ẻ Phát triển, rồi nhấp vào Thao tác trên thanh bên.

  4. Chọn Tất cả trong danh sách thả xuống Nhập kiểm soát nhật ký.

Ghi nhật ký các tùy chọn loại trừ

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

Bạn có thể thực hiện 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ữ _Default).

Các 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 chúng. Bạn cũng có thể tạo biểu đồ tuỳ chỉnhthiết lập cảnh báo vào 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 tham khảo tạo hướng dẫn chỉ số dựa trên nhật ký của bộ đếm.

Để tìm hiểu thêm về cách sử dụng tính năng Ghi nhật ký trên đám mây trong dự án của bạn, hãy xem các nội dung sau tài liệu:

  • Định giá: Thông tin chi tiết về việc phân bổ và chi phí phụ trội.
  • Hạn mức và giới hạn: Thông tin chi tiết về giới hạn và chính sách giữ lại dữ liệu đố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 biểu thức nâng cao để truy vấn và phân tích dữ liệu nhật ký.