Google Home Vitals (Cloud)

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

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

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

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

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

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

如果按下方按鈕後沒有直接前往資訊主頁，請選取「總覽」頁面，然後選取「資訊主頁」，並從「我的資訊主頁」清單中選取「Google Home Vitals Dashboard (Cloud)」，即可查看資訊主頁。

前往資訊主頁

Google 傳送給合作夥伴的指標

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

「成功」的定義為何？

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

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

什麼是「失敗」？

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

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

延遲指標

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

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

1. QUERY Latency (Interrogative)

這項指標會測量 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」時間。這項指標不會測量實體硬體 (例如燈泡) 完成實體狀態變更所需的時間，因為這通常涉及雲端至雲端路徑以外的本機網狀網路延遲。

縮短延遲的選項

地理位置路由的架構建議

如果無法實作任播 IP，建議採用下列經濟實惠的替代方案，確保使用者能透過最接近的區域資料中心取得服務。

  1. 全球負載平衡 (GLB)

    請使用全域應用程式負載平衡器 (適用於大多數主要雲端供應商)，而非靜態路由。

    • 運作方式：您可以在網路邊緣設定單一全域進入點 (網址)，負載平衡器會自動偵測 Google 履行叢集的要求地理來源，並將流量轉送至最近的區域健康後端。

    • 優點：這項功能可提供任播效能，但設定複雜度和成本都大幅降低。

  2. 可感知地理位置的 DNS (GeoDNS)

    • 運作方式：設定 DNS 供應商，根據 DNS 查詢的地理位置，將完成網址解析為不同的 IP 位址。

    • 實作：請確保 DNS 供應商已針對 Google 的輸出點完成最佳化。當 Google 的區域性履行服務 (例如美國、歐盟或亞洲) 解析您的網域時，會收到該特定區域資料中心的 IP 位址。

應用程式層的最佳化策略

除了基礎架構層級的路由，您還可以在應用程式層級實作下列策略，減少要求處理作業的延遲時間。

  1. 「Trampoline」Proxy 方法

    如果必須維護主要資料中心，請使用地區輕量型 Proxy 伺服器 (Trampolines) 處理初始信號交換。

    1. Google 會連線至您的全球網址。

    2. 區域 Proxy (例如輕量型 Nginx 或 Lambda 函式) 會接收要求。

    3. Proxy 會透過內部高速骨幹將酬載轉送至主要資料庫。

    優點：這項功能可縮短「TCP 交握」時間，而這通常是長距離要求延遲的最大因素。

  2. 存取權杖區域提示

    在帳戶連結 (OAuth) 過程中，系統可以識別使用者的住家區域。

    實作：將區域 ID 編碼到發給 Google 的 access_token 中。Google 傳送訂單履行要求時，閘道可以立即檢查權杖，並將要求傳送至正確的區域叢集，不需要進行資料庫查詢。

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

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

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

「成功」的定義為何？

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

什麼是「失敗」？

  • 4xx (合作夥伴錯誤)：代表失敗，表示從雲端傳送的請求發生問題。常見代碼包括：
    • 400 Bad Request：伺服器無法處理要求，因為語法無效。常見原因包括 JSON 格式錯誤，或是字串值使用 null 而非「""」。
    • 404 Not Found：找不到要求的資源。通常這表示 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