Matter 適用的 Cloud Logging

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

存取記錄

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

前往 Cloud Logging

您可以透過 Actions 專案使用者的身分與存取權管理 (IAM),管理記錄資料的存取權。如要進一步瞭解記錄資料的角色和權限,請參閱 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 要求使用的傳輸方式,例如 CLOUDMATTER,視整合方式而定。
actionType 使用者採取的動作 (選填),例如 QUERYEXECUTE。 如果是 EXECUTE 動作,則包含針對支援的特徵發出的指令,例如 ONOFF_OFF
trait 與這項使用者動作相關的選用特徵。
deviceTypes 受事件影響的裝置類型清單,例如 LIGHT
isSuccess 要求是否收到成功的回應。
fallbackToCloud 要求是否在區域履行發生錯誤後,轉送至雲端履行。
statusType 指出意圖回應的狀態,例如 SUCCESSPENDINGOFFLINE。如果是 ERROR 回應,這個屬性會包含完成動作提供的 errorCode
externalDebugString (選用) 與這項使用者動作相關的詳細偵錯訊息。
locale 與要求相關聯的語言代碼。

記錄排除

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

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

記錄指標

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

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

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

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