Google Home 生態系統適用的 Cloud Logging

您可以從 Google Cloud Logging 存取整合的事件日誌。使用 Cloud Logging 瀏覽日誌、建立指標和警報，或使用 Google Cloud Pub/Sub 將日誌匯出到其他應用程式。

訪問日誌

若要從 Google Cloud Console 存取 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`。

Cloud-to-cloud 項目支援雲端日誌記錄中的以下事件：

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

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

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

屬性	說明
`requestId`	通知請求 ID。
`structName`	通知結構體的名稱，例如「ObjectDetection」。
`status`	表示通知的狀態。

Cloud-to-cloud 專案預設為接收錯誤日誌，開發者也可以選擇接收成功日誌。這在開發階段尤其有用，當您計劃從幾個代理程式捕獲所有日誌時。如果您超出日誌記錄配額，您的項目可能會產生額外費用。

您可以透過以下方式控制專案的日誌等級：

開發人員可以使用記錄查詢語言建立記錄排除項目，以更靈活的方式進一步自訂記錄。日誌查詢語言也被日誌資源管理器使用，因此您可以使用日誌資源管理器來協助建立查詢。

您可以依照本指南中的步驟建立排除過濾器（為 _Default 接收器設定排除過濾器）。

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

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