平台記錄

Google Health API 會與 Cloud Logging 整合,為第三方用戶端提供有關 Webhook 通知傳送狀態和結果的詳細深入分析。這項記錄整合功能可協助客戶監控、排解問題,並驗證資料傳送至已註冊端點的可靠性。

總覽

當 Google Health 平台中發生相關使用者資料變更時,平台會以 HTTP 要求的形式,將 Webhook 通知傳送至第三方用戶端預先註冊的端點。平台記錄會擷取這些傳送嘗試的交易詳細資料 (包括 HTTP 狀態碼、標頭和回應酬載),並自動將這些資料傳送至用戶端的 Google Cloud 專案。

如要進一步瞭解 Cloud Logging 記錄項目,請參閱 Cloud Logging 平台記錄項目說明文件

受監控資源

在 Cloud Logging 中,記錄項目會歸類在「受監控的資源」下方。 Google Health API 的 Webhook 通知記錄項目與個別訂閱者執行個體資源類型相關聯:

  • 資源類型health.googleapis.com/Subscriber

每則記錄項目都會加上標籤,使用下列標籤不重複地識別受影響的訂閱者例項:

  • resource_container:擁有訂閱者資源的 Google Cloud 雲端專案 ID (或相關機構 ID 或資料夾 ID)。
  • subscriber_id:用戶端在建立訂閱者時指派的專屬訂閱者 ID。
  • location:設為 global,因為訂閱者定義並未依區域劃分。

您可以在 Google Cloud 控制台的記錄檔探索工具中,查詢及篩選特定訂閱者的記錄項目。

記錄結構和詳細資料

  • 記錄檔名稱projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • 酬載類型:包含 WebhookNotificationCloudLog 結構,包裝遞送嘗試的 google.rpc.HttpResponse 詳細資料。
  • 「Log Labels」(記錄檔標籤)
    • dataType:與訂閱項目相關聯的資料類型 (例如 NUTRITIONSLEEP)。

篩選記錄項目

您可以使用查詢,在記錄檔探索工具中篩選 webhook 記錄項目。舉例來說,如要找出與 Webhook 傳送相關的所有記錄項目,請執行下列操作:

resource.type="health.googleapis.com/Subscriber"
logName="projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification"

如要進一步縮小搜尋範圍,只搜尋特定訂閱者或資料類型,可以附加其他篩選條件:

resource.labels.subscriber_id="YOUR_SUBSCRIBER_ID"
labels.dataType="SLEEP"