Google Home 生態系統適用的 Cloud Logging

雲端對雲端    Matter

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

存取 Logging

如要從 Google Cloud Console 存取 Cloud Logging，請按一下「View all products」(查看所有產品)，然後前往「Operations」(作業) >「Logging」(記錄)。

前往 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 Logging 中的下列事件：

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

同步處理記錄

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

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

執行記錄檔

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

屬性	說明
requestId	不重複的要求 ID，例如 5325511189174727525。
latencyMsec	接收回應前經過的時間，例如 6000。
executionType	用於要求的傳輸，例如 CLOUD 或 MATTER，具體取決於您的整合服務。
actionType	使用者已採取行動的選用指標，例如 QUERY 或 EXECUTE。針對 EXECUTE 動作，請納入針對支援特徵核發的指令，例如 ONOFF_OFF
trait	與這項使用者動作相關聯的選用特徵。
deviceTypes	受事件影響的裝置類型清單，例如 LIGHT。
isSuccess	要求是否收到成功回應。
fallbackToCloud	要求是否在本機執行要求發生錯誤後轉送至 Cloud 執行要求。
statusType	表示意圖回應的狀態，例如 SUCCESS、PENDING 或 OFFLINE。如果是 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. 在「記錄檔控制擷取」下拉式清單中選取「全部」。

記錄檔排除

開發人員可以使用記錄查詢語言建立記錄排除，以更靈活的方式進一步自訂記錄。記錄檔探索工具也會使用 Logging 查詢語言，因此您可以使用記錄檔探索工具協助建立查詢。

您可以依照這份指南的步驟建立排除篩選器 (為 _Default 接收器設定排除篩選器)。

記錄指標

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

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

相關資源

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

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