品質監控資訊主頁指標

這套資訊主頁和快訊可協助您主動維護與 Google Home 生態系統的高品質整合。Google 致力於協助合作夥伴為所有客戶開發優質生態系統

資訊主頁分為三個部分，分別涵蓋影響整體整合品質的重要環節。

  1. Google 至合作夥伴指標：評估從 Google 到雲端後端的呼叫健康狀態。

  2. 系統健康狀態 - 合作夥伴至 Google 指標 - 評估從系統到 Google 的通話健康狀態。

  3. 裝置健康狀態 - 狀態準確度：評估 Google 系統儲存狀態的準確度，這些狀態用於處理使用者查詢。

如果指標未達到目標值，系統會以紅色醒目顯示，表示可能存在影響使用者體驗的問題。下列資訊詳細說明各個目標，以及這些目標對使用者的重要性。

前往資訊主頁

Google 傳送給合作夥伴的指標

「查詢/執行成功率 >= 99.5%」指標會測量使用者指令的正確執行頻率，有助於避免 Google 助理回覆「我無法連上裝置」等訊息，或錯誤確認未執行的指令。

什麼是「成功」？

如果 Google Home 平台收到有效的回應，指出已完成預期動作或擷取要求的狀態，系統就會將交易標示為成功。

如果回應包含非封鎖例外狀況 (例如 SUCCESS 狀態和 lowBattery 例外狀況)，系統會將其計為成功交易。指令已傳送至裝置，且意圖已滿足，但發生警告。

什麼是「失敗」？

計算 QUERY 和 EXECUTE 成功率時，常見平台錯誤代碼中標示為「合作夥伴可採取行動」的錯誤會視為「失敗」。

「查詢/執行延遲時間 (p90) <= 1000 毫秒」指標會測量要求動作的等待時間，確保使用者不必等待太久，例如等待幾秒鐘讓燈光關閉。

延遲指標

延遲時間是重要指標，可反映整合功能對使用者來說是否反應迅速。資訊主頁會追蹤第 90 百分位數 (P90) 的延遲時間，代表「最慢」使用者的體驗 (舉例來說，P90 為 800 毫秒表示 90% 的要求會在 800 毫秒內確認)。

為確保技術準確度，Google 會以不同方式測量狀態檢查和裝置指令的延遲時間。

1. 查詢延遲 (疑問)

這項指標會測量 Google 要求裝置目前狀態時的Cloud-to-cloud往返時間。

  • 開始：Google 會將 action.devices.QUERY 要求傳送至你的服務網址。
  • 測量時間範圍：雲端接收、處理及將完整 HTTP 回應傳輸回 Google 所需的時間。
  • 結束：Google 收到並確認服務的最終回應酬載。

2. EXECUTE 延遲時間 (動作)

這項指標會測量 Google 將控制要求傳送至裝置時，裝置確認指令的時間。

  • 開始：Google 會將 action.devices.EXECUTE 要求傳送至你的服務網址。
  • 測量時間範圍：雲端接收指令並傳回確認回應所花費的時間。
  • 結束：Google 收到 SUCCESS、PENDING 或 OFFLINE 狀態的回應。
  • 技術範圍：這項指標會評估 Google Cloud 與您的雲端之間的「回應 Ack」時間。這項指標不會測量實體硬體 (例如燈泡) 完成實體狀態變更所需的時間，因為這通常涉及雲端至雲端路徑以外的本機網狀網路延遲。

系統健康狀態 - 合作夥伴至 Google 的指標

維持成功率 >= 99.5% 有助於確保 Google Home 中的裝置狀態正確無誤、裝置新增及移除作業順利完成、自動化動作觸發，以及歷史記錄事件顯示在 Google Home app (GHA) 的「活動」分頁中。

系統會根據 Google 在雲端推送狀態更新時傳回的 HTTP 回應代碼，計算成功率。為確保合作夥伴不會因 Google 基礎架構問題而受到處罰，這項指標會從失敗次數中排除 Google 內部錯誤。

什麼是「成功」？

  • 2xx (成功)：Home Graph 已成功接收並處理狀態更新。

什麼是「失敗」？

  • 4xx (合作夥伴錯誤)：代表失敗，表示從雲端傳送的請求發生問題。常見代碼包括：
    • 400 Bad Request：伺服器無法處理要求，因為語法無效。常見原因包括 JSON 格式錯誤，或是字串值使用 null 而非「""」。
    • 404 找不到：找不到要求的資源。通常這表示 Google 找不到要求的裝置。也可能表示使用者帳戶未連結，或收到無效的 agentUserId。請確認 agentUserId 與 SYNC 回應中提供的值相符，且您已正確處理 DISCONNECT 意圖。
    • 429 資源用盡：您的整合服務已超過配額上限。 如需配額管理的操作說明，請參閱資訊主頁上方「步驟 1」一節。

裝置健康狀態 - 狀態準確度

狀態準確度 >= 99.5% 有助於確保使用者查看裝置狀態或使用「幫我找 Google Home」等 AI 功能時，看到正確的結果。如果狀態準確度偏低，自動化動作可能不會觸發，且記錄項目可能不會在正確時間顯示於 GHA 的「活動記錄」分頁中。詳情請參閱「回報狀態」。

品質資訊主頁會使用「整體準確度」和「最低類型/特徵組合」這兩項指標，每小時追蹤這項資料。

1. 準確度元件

這項指標是根據「樣本」推算而得，Google 可根據已知的意圖結果，驗證回報的狀態。

2. 資訊主頁指標 (每小時計算)

資訊主頁會根據 1 小時間隔計算準確度。如果某個小時的樣本總數少於 100 個 (S_Total < 100)，該小時的準確率會設為「不適用」。

檢視 1：整體準確度 (全球平均)

這代表整合在所有裝置類型和特徵的總準確度。這項指標會提供整個生態系統健康狀態的加權平均值。

  • 計算方式：所有裝置的總狀態準確度 / 所有裝置的總狀態總數。

檢視畫面 2：最低類型/特徵組合

這會找出整合中最不可靠的特定類別。這可避免高品質的大音量裝置隱藏低品質的小音量裝置。舉例來說，如果燈具的狀態準確度高於 99.5%，但開關的狀態準確度偏低，這就表示開關需要改善，而平均值可能會忽略這點。

  • 計算方式：所有特徵 / 裝置組合的狀態準確度/狀態總數最小值。
下一頁
Cloud Monitoring