透過 Cloud Logging 存取事件記錄檔

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

存取 Logging

如要從 Google Cloud Console 存取 Cloud Logging，請按一下「View all products」，然後前往「Operations」 >「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`。

Cloud-to-cloud 專案支援 Cloud Logging 中的下列事件：

下表列出 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 項目的結構定義：

Cloud-to-cloud 專案預設為接收錯誤記錄檔，開發人員也可以選擇接收成功記錄檔。當您打算從幾個代理程式擷取所有記錄時，這在開發階段尤其實用。超出記錄配額時，您的專案可能會收取額外費用。

您可以透過以下方式控管專案的記錄層級：

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

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

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

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