Google Home 生態系統適用的 Cloud Logging

雲端對雲端    案件

您可以透過以下途徑存取整合事件記錄: Google Cloud Logging。 使用 Cloud Logging 探索記錄檔、建立指標和快訊,或 透過 Cloud Shell 的指令列 Google Cloud Pub/Sub

存取記錄

如何從以下位置存取「Cloud Logging」: Google Cloud Console, 按一下「查看所有產品」,然後前往「作業」>記錄

前往 Cloud Logging

記錄資料存取權是透過 Identity and Access Management (IAM) 管理 以便支援 Actions 專案的使用者如要進一步瞭解 記錄資料,請前往 Cloud Logging 存取權控管

每個 Cloud Logging 都會保留記錄項目 30 天 保留政策,之後 排定刪除資料。你也可以使用 記錄檔探索工具介面。

如要進一步瞭解如何有效使用記錄,請參閱「搜尋記錄」一節 疑難排解指南

Cloud Logging 提供下列資源類型:

資源類型 顯示名稱 說明 標籤
assistant_action_project Google 助理動作專案 與 Google 助理相關聯的 Google Cloud 專案的容器 開拍
  • project_id:目前專案的 ID 與這項資源相關聯的資源 my-project

事件記錄

Cloud-to-cloud 項專案支援下列 Cloud 事件 記錄:

Cloud Logging 資源 活動
Google 助理動作專案 SYNC 意圖錯誤
QUERY 意圖錯誤
EXECUTE 意圖錯誤
通知 錯誤數
帳戶連結 錯誤數
本機 Home SDK HandlerError

同步處理記錄

下表列出 syncLog 項目的結構定義:

屬性 說明
requestId 智慧型住宅意圖要求 ID。
httpLatencyMsec 收到回應前經過的時間。
status 指出意圖回應的狀態。

執行記錄

下表列出 executionLog 項目的結構定義:

屬性 說明
requestId 不重複的要求 ID,例如 5325511189174727525
latencyMsec 收到回應前經過的時間,例如: 6000
executionType 用於要求的傳輸,例如 CLOUDMATTER (視您的整合服務而定)。
actionType 表示使用者動作的選用指標,例如 QUERYEXECUTE。 如果是 EXECUTE 動作,請加入要發送給以下對象的指令 對支援的特徵 (例如 ONOFF_OFF) 執行要求
trait 與這項使用者動作相關的選用特徵。
deviceTypes 受事件影響的裝置類型清單,例如 LIGHT
isSuccess 要求是否收到成功的回應。
fallbackToCloud 要求是否在發生錯誤後轉送至 Cloud 執行要求 本地出貨。
statusType 指出意圖回應的狀態,例如 SUCCESSPENDINGOFFLINE。適用裝置:ERROR 則這個屬性包含 執行要求提供的 errorCode
externalDebugString 與這項使用者動作相關聯的詳細偵錯訊息 (選用)。
locale 與要求相關聯的語言代碼。

通知記錄

下表列出 notificationLog 項目的結構定義:

屬性 說明
requestId 通知要求 ID。
structName 通知結構的名稱,例如「ObjectDetection」。
status 表示 狀態 通知。

記錄層級設定

Cloud-to-cloud 項專案預設為接收錯誤記錄檔。 開發人員可以選擇接收成功記錄。 在開發階段 來自幾個代理程式的所有記錄檔如果您 超過 記錄配額

您可以透過下列方式控制專案的記錄層級:

  1. Actions on Google Console 中,前往「Projects」(專案) 頁面。

    前往 Actions on Google 控制台

  2. 選取智慧型住宅專案。

  3. 選擇 [開發] 分頁標籤,然後按一下側欄中的 [動作]

  4. 在「Log 控制項擷取」下拉式選單中,選取「全部」

記錄排除

開發人員可以建立 記錄排除 使用記錄查詢 語言 以更靈活的方式進一步自訂記錄檔Logging 查詢語言 記錄檔探索工具也會使用記錄檔探索工具,因此您可以使用記錄檔探索工具 舉個簡單的例子,您可以定義情境 並指示 AI 如何回應服務中心查詢

您可以前往下列網址建立「排除」篩選器: 本指南 (為 _Default 接收器設定排除篩選器)。

記錄指標

開發人員可以使用 記錄指標 追蹤及分析記錄中的模式您也可以 建立自訂圖表設定快訊 深入瞭解記錄指標

如要開始使用根據記錄指標建立智慧型住宅,請前往以下連結: 建立計數器指標指標指南

如要進一步瞭解如何在專案中使用 Cloud Logging,請參閱下列文章: 說明文件

  • 計費方式: 配額和超額用量費用的詳細資料。
  • 配額與限制: 記錄使用情形的限制和保留政策詳細資料。
  • 進階記錄查詢: 使用進階運算式查詢及分析記錄檔資料的指南。