Matter 適用的 Cloud Logging

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

存取記錄

如要從 Google Cloud Console 存取 Cloud Logging，請點選「查看所有產品」，然後依序前往「作業」 >「記錄」。

前往 Cloud Logging

您可以透過 Actions 專案使用者的 Identity and Access Management (IAM)，管理記錄資料的存取權。如要進一步瞭解記錄資料的角色和權限，請參閱 Cloud Logging 存取權控管。

根據 Cloud Logging 保留政策，記錄項目會保留 30 天，然後排定刪除。您也可以使用 Logs Explorer 介面，視需要刪除項目。

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

Cloud Logging 提供下列資源類型：

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

執行記錄

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

屬性	說明
requestId	專屬要求 ID，例如 5325511189174727525。
latencyMsec	收到回應前經過的時間，例如 6000。
executionType	要求使用的傳輸方式，例如 CLOUD 或 MATTER (視整合方式而定)。
actionType	使用者採取的動作 (選用指標)，例如 QUERY 或 EXECUTE。 如果是 EXECUTE 動作，則包含針對支援的特徵發出的指令，例如 ONOFF_OFF
trait	與這項使用者動作相關聯的選用特徵。
deviceTypes	受事件影響的裝置類型清單，例如 LIGHT。
isSuccess	要求是否收到成功的回應。
fallbackToCloud	要求是否在本地履行發生錯誤後，改為轉送至雲端履行。
statusType	指出意圖回應的狀態，例如 SUCCESS、PENDING 或 OFFLINE。如果是 ERROR 回應，這個屬性會包含完成動作提供的 errorCode。
externalDebugString	(選用) 與這項使用者動作相關的詳細偵錯訊息。
locale	與要求相關聯的語言代碼。

記錄排除條件

開發人員可以使用記錄查詢語言建立記錄排除項目，以更靈活的方式進一步自訂記錄。Logs Explorer 也使用 Logging 查詢語言，因此您可以使用 Logs Explorer 協助建立查詢。

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

記錄指標

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

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

相關資源

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

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