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:與訂閱項目相關聯的資料類型 (例如NUTRITION、SLEEP)。
篩選記錄項目
您可以使用查詢,在記錄檔探索工具中篩選 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"