Chào mừng bạn đến với Trung tâm nhà phát triển Google Home, điểm đến mới để tìm hiểu cách phát triển các hành động nhà thông minh. Lưu ý: Bạn sẽ tiếp tục xây dựng các hành động trong bảng điều khiển Actions.

Truy cập nhật ký sự kiện bằng tính năng Ghi nhật ký trên đám mây

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 phần Thao tác > Ghi nhật ký.

Chuyển đến Cloud Logging

Người dùng dự án Hành động của bạn sẽ được quản lý quyền truy cập vào dữ liệu ghi nhật ký thông qua tính năng Quản lý danh tính và quyền truy cập (IAM). Để 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 tính năng ghi nhật ký trên đám mây.

Các mục nhật ký được lưu giữ trong 30 ngày theo chính sách lưu giữ Ghi nhật ký trên đám mây, 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 Logs Explorer.

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 trong 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 trên Trợ lý Google Vùng chứa cho Dự án trên Google Cloud liên kết với Hành động của Trợ lý.
  • project_id: Giá trị 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ợ những sự kiện sau trong tính năng Ghi nhật ký trên đám mây:

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

Đồng bộ hóa nhật ký

Bảng dưới đây liệt kê giản đồ của một mục nhập syncLog:

Tài sản Mô tả
requestId Mã yêu cầu đối với ý định trong 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 nhập executionLog:

Tài sản 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 sử dụng cho yêu cầu, ví dụ như CLOUD hoặc MATTER, tuỳ thuộc vào khả năng tích hợp của bạn.
actionType Chỉ báo không bắt buộc về thao tác của người dùng đã thực hiện, ví dụ: QUERY hoặc EXECUTE. Đối với hành động EXECUTE, hãy thêm lệnh được thực hiện để thực hiện các đặc điểm được hỗ trợ, ví dụ: ONOFF_OFF
trait Đặc điểm không bắt buộc liên quan đến 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 này, ví dụ: LIGHT.
isSuccess Liệu yêu cầu có phản hồi thành công hay không.
fallbackToCloud Liệu yêu cầu có được chuyển đến phương thức thực hiện trên đám mây hay không sau một lỗi từ phương thức thực hiện trên máy.
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 ERROR phản hồi, 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 liên quan đến hành động của người dùng này.
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:

Tài sản Mô tả
requestId ID 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ý

Theo mặc định, 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. Bạn có thể phải trả thêm phí cho dự án nếu 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.

    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 tab Phát triển và nhấp vào Tác vụ trên thanh bên.

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

Loại trừ nhật ký

Nhà phát triển có thể tạo quy tắc loại trừ nhật ký bằng ngôn ngữ truy vấn nhật ký để tuỳ chỉnh thêm nhật ký một cách linh hoạt hơn. Log Explorer cũng sử dụng ngôn ngữ truy vấn ghi nhật ký để bạn có thể sử dụng Trình khám phá nhật ký để 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ữ _Default).

Chỉ số dựa trên nhật ký

Nhà phát triển có thể sử dụng Các 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 trên 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 bài viết tạo hướng dẫn về chỉ số dựa trên nhật ký.

Để 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 tài liệu sau:

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