雲端對雲端的 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 天,然後排定刪除時間。您也可以使用 Logs Explorer 介面,隨時刪除項目。

如要進一步瞭解如何有效使用記錄,請參閱疑難排解指南的「搜尋記錄」一節。

Cloud Logging 提供下列資源類型:

資源類型 顯示名稱 說明 標籤
assistant_action_project Google 助理動作專案 與 Google 助理動作相關聯的 Google Cloud 專案容器。
  • project_id:與此資源相關聯的目前專案 ID,例如 my-project

事件記錄

Cloud-to-cloud 專案在 Cloud Logging 中支援下列事件:

Cloud Logging 資源 活動
Google 助理動作專案 SYNC 意圖錯誤
QUERY 意圖錯誤
EXECUTE 意圖錯誤
通知 errors
帳戶連結錯誤
Local Home SDK HandlerError

同步處理記錄

下表列出 syncLog 項目的結構定義:

屬性 說明
requestId 智慧住宅意圖要求 ID。
httpLatencyMsec 收到回應前經過的時間。
status 這個欄位會顯示意圖回應的狀態。

執行記錄

下表列出 executionLog 項目的結構定義:

屬性 說明
requestId 專屬要求 ID,例如 5325511189174727525
latencyMsec 收到回應前經過的時間,例如 6000
executionType 用於要求的傳輸,例如 CLOUDMATTER,視整合方式而定。
actionType 可選的使用者動作指標,例如 QUERYEXECUTE。針對 EXECUTE 動作,包含針對支援特徵發給執行的命令,例如 ONOFF_OFF
trait 與此使用者動作相關的選用特徵。
deviceTypes 受事件影響的裝置類型清單,例如 LIGHT
isSuccess 要求是否已收到成功回應。
fallbackToCloud 要求是否在本機執行結果發生錯誤後,轉送至雲端執行結果。
statusType 表示意圖回應的狀態,例如 SUCCESSPENDINGOFFLINE。對於 ERROR 回應,這個屬性包含由執行服務提供的 errorCode
externalDebugString 與此使用者動作相關的詳細偵錯訊息 (選用)。
locale 與要求相關聯的語言代碼。

通知記錄

下表列出 notificationLog 項目的結構定義:

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

記錄層級設定

Cloud-to-cloud 專案預設會接收錯誤記錄,開發人員也可以選擇接收成功記錄。在開發階段,如果您打算擷取少數幾個代理程式的所有記錄,這項功能就格外實用。如果您超過記錄配額,專案可能會產生額外費用。

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

  1. Actions on Google Console 中,前往「專案」頁面。

    前往 Actions on Google 主控台

  2. 選取智慧型住宅專案。

  3. 選擇「Develop」分頁標籤,然後按一下側欄中的「Actions」

  4. 在「Log control ingestion」下拉式清單中選取「All」

記錄排除項目

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

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

記錄指標

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

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

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

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