您可以從 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 專案容器。 |
|
事件記錄
Cloud-to-cloud 專案支援 Cloud Logging 中的下列事件:
Cloud Logging 資源 | 活動 |
---|---|
Google 助理動作專案 | SYNC 意圖錯誤 |
QUERY 意圖錯誤 | |
EXECUTE 意圖錯誤 | |
通知錯誤 | |
帳戶連結錯誤 | |
Local Home SDK HandlerError |
同步處理記錄
下表列出 syncLog
項目的結構定義:
屬性 | 說明 |
---|---|
requestId |
智慧型住宅意圖要求 ID。 |
httpLatencyMsec |
接收回應前所經過的時間。 |
status |
指出意圖回應的狀態。 |
執行記錄檔
下表列出 executionLog
項目的結構定義:
屬性 | 說明 |
---|---|
requestId |
不重複的要求 ID,例如 5325511189174727525 。 |
latencyMsec |
接收回應前經過的時間,例如 6000 。 |
executionType |
用於要求的傳輸,例如 CLOUD 或 MATTER ,具體取決於您的整合服務。 |
actionType |
使用者已採取行動的選用指標,例如 QUERY 或 EXECUTE 。針對 EXECUTE 動作,請納入針對支援特徵核發的指令,例如 ONOFF_OFF |
trait |
與這項使用者動作相關聯的選用特徵。 |
deviceTypes |
受事件影響的裝置類型清單,例如 LIGHT 。 |
isSuccess |
要求是否收到成功回應。 |
fallbackToCloud |
要求是否在本機執行要求發生錯誤後轉送至 Cloud 執行要求。 |
statusType |
表示意圖回應的狀態,例如 SUCCESS 、PENDING 或 OFFLINE 。如果是 ERROR 回應,這個屬性包含執行要求提供的 errorCode 。 |
externalDebugString |
與這項使用者動作相關的詳細偵錯訊息 (選填)。 |
locale |
與要求相關聯的語言代碼。 |
通知記錄
下表列出 notificationLog
項目的結構定義:
屬性 | 說明 |
---|---|
requestId |
通知要求 ID。 |
structName |
通知結構的名稱,例如「ObjectDetection」。 |
status |
指出通知的狀態。 |
記錄層級設定
根據預設,Cloud-to-cloud 專案會接收錯誤記錄,開發人員也可以選擇接收成功記錄檔。在開發階段,當您計劃從幾個代理程式擷取所有記錄時,這種做法就特別實用。如果您超過記錄配額,您的專案可能會產生額外費用。
您可以透過下列方式控管專案的記錄層級:
在 Actions on Google Console 中,前往「Projects」(專案) 頁面。
選取智慧型住宅專案。
選擇「開發」分頁標籤,然後按一下側欄中的「動作」。
在「記錄檔控制擷取」下拉式清單中選取「全部」。
記錄檔排除
開發人員可以使用記錄查詢語言建立記錄排除,以更靈活的方式進一步自訂記錄。記錄檔探索工具也會使用 Logging 查詢語言,因此您可以使用記錄檔探索工具協助建立查詢。
您可以依照這份指南的步驟建立排除篩選器 (為 _Default
接收器設定排除篩選器)。
記錄指標
開發人員可以使用記錄指標來追蹤及分析記錄檔中的模式。您也可以針對記錄指標建立自訂圖表及設定快訊。
如要開始使用智慧型住宅的記錄指標,請參閱建立計數器記錄指標指南。
相關資源
如要進一步瞭解如何在專案中使用 Cloud Logging,請參閱下列說明文件: