歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。

透過 Cloud Logging 存取事件記錄檔

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

您可以透過 Google Cloud Logging 存取整合作業的事件記錄。使用 Cloud Logging 探索記錄、建立指標和快訊,或使用 Google Cloud Pub/Sub 將記錄檔匯出至其他應用程式。

存取紀錄

如要從 Google Cloud Console 存取 Cloud Logging,請按一下 [查看所有產品],然後依序前往 [作業] > [記錄]

前往 Cloud Logging

透過動作與存取管理 (IAM) 來為您的動作專案使用者管理記錄資料的存取權。如要進一步瞭解記錄資料的角色和權限,請參閱 Cloud Logging 存取權控管

根據 Cloud Logging 資料保留政策,記錄項目會保留 30 天,之後便會安排刪除。您也可以使用 Log Explorer 介面,視需求刪除項目。

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

Cloud Logging 提供下列資源類型:

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

事件記錄

Cloud-to-cloud projects support the following events in Cloud Logging:

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 要求是否從本機要求發生錯誤之後轉送至雲端執行要求。
statusType 表示意圖回應的狀態,例如 SUCCESSPENDINGOFFLINE。如為 ERROR 回應,這個屬性會包含出貨資訊提供的 errorCode
externalDebugString (選填) 與這項使用者動作相關聯的詳細偵錯訊息。
locale 與要求相關聯的語言代碼。

通知記錄

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

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

紀錄層級設定

系統預設會將 Cloud-to-cloud 專案設為接收錯誤記錄,開發人員也可以選擇接收成功記錄。在開發階段中,當您計劃從幾個代理程式擷取所有記錄檔時,這個方法特別實用。如果專案超過記錄配額,可能需支付額外費用。

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

  1. Actions on Google Console, go to the Projects page.

    前往 Actions on Google 主控台

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

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

  4. 在「Log Control fetch」(記錄控制擷取) 下拉式清單中選取 [All] (全部)

記錄排除

開發人員可以使用記錄查詢語言建立記錄排除條件,以更靈活的方式進一步自訂記錄。記錄檔探索工具也會使用記錄查詢語言,方便您使用記錄檔探索工具建立查詢。

您可以按照這份指南中的步驟,建立排除篩選器 (設定 _Default 接收器的「排除」篩選器)。

記錄指標

開發人員可以使用記錄指標在記錄檔中追蹤及分析模式。您也可以建立自訂圖表,以及針對記錄指標設定快訊

如要針對智慧型住宅開始使用記錄指標,請參閱建立計數器指標指標指南

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

  • 定價:配額分配和超額費用的詳細資料。
  • 配額與限制:記錄用量的限制與保留政策。
  • 進階記錄查詢:說明如何使用進階運算式查詢及分析記錄資料。