Matter 適用的 Cloud Logging

您可以從 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。

執行記錄檔

下表列出 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	與要求相關聯的語言代碼。

記錄檔排除

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

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

記錄指標

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

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

相關資源

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

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