Matter 適用的 Cloud Logging

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

存取記錄

如要從 Google Cloud Console 存取 Cloud Logging,請按一下「View all Products」,然後依序前往「Operations」 >「Logging」

前往 Cloud Logging

記錄資料的存取權是透過 Actions 專案使用者的 Identity and Access Management (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 要求是否在本機執行要求發生錯誤後轉送至 Cloud 執行要求。
statusType 指出意圖回應的狀態,例如 SUCCESSPENDINGOFFLINE。如果是 ERROR 回應,這個屬性會包含執行要求提供的 errorCode
externalDebugString 與這項使用者動作相關聯的詳細偵錯訊息 (選用)。
locale 與要求相關聯的語言代碼。

記錄排除

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

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

記錄指標

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

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

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

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