Ghi nhật ký nền tảng

Google Health API tích hợp với Cloud Logging để cung cấp cho các ứng dụng của bên thứ ba thông tin chi tiết về trạng thái và kết quả của việc gửi thông báo webhook. Tính năng tích hợp nhật ký này cho phép các ứng dụng theo dõi, khắc phục sự cố và xác minh độ tin cậy của việc phân phối dữ liệu đến các điểm cuối đã đăng ký.

Tổng quan

Khi dữ liệu người dùng có liên quan thay đổi trong nền tảng Google Health, nền tảng này sẽ gửi thông báo webhook đến điểm cuối đã đăng ký trước của ứng dụng khách bên thứ ba dưới dạng một yêu cầu HTTP. Hoạt động ghi nhật ký nền tảng ghi lại chi tiết giao dịch của những lần gửi này (bao gồm cả Mã trạng thái HTTP, tiêu đề và tải trọng phản hồi) và tự động định tuyến thông tin đó đến dự án trên đám mây của ứng dụng.

Để biết thêm thông tin về các mục nhật ký Cloud Logging, hãy xem tài liệu về các mục nhật ký nền tảng Cloud Logging.

Tài nguyên được theo dõi

Trong Cloud Logging, các mục nhật ký được nhóm theo một Tài nguyên được giám sát. Các mục nhật ký thông báo webhook cho Google Health API được liên kết với từng loại tài nguyên phiên bản người đăng ký riêng lẻ:

  • Loại tài nguyên: health.googleapis.com/Subscriber

Mỗi mục nhập nhật ký đều được gắn nhãn để xác định duy nhất phiên bản thuê bao bị ảnh hưởng bằng các nhãn sau:

  • resource_container: Mã dự án trên đám mây của Google (hoặc mã tổ chức hoặc mã thư mục có liên quan) sở hữu tài nguyên người đăng ký.
  • subscriber_id: Mã nhận dạng riêng biệt của người đăng ký do ứng dụng chỉ định khi người đăng ký được tạo.
  • location: Đặt thành global vì định nghĩa về người đăng ký không được bản địa hoá.

Các nhãn này cho phép bạn truy vấn và lọc các mục nhập nhật ký dành riêng cho một người đăng ký trong Trình khám phá nhật ký của Google Cloud Console.

Cấu trúc và thông tin chi tiết về nhật ký

  • Tên nhật ký: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Loại tải trọng: Chứa cấu trúc WebhookNotificationCloudLog bao bọc thông tin chi tiết google.rpc.HttpResponse về lần thử gửi.
  • Nhãn nhật ký:
    • dataType: Loại dữ liệu được liên kết với gói thuê bao (ví dụ: NUTRITION, SLEEP).

Lọc các mục nhật ký

Bạn có thể lọc các mục nhập nhật ký webhook trong Trình khám phá nhật ký bằng cách sử dụng các truy vấn. Ví dụ: để tìm tất cả các mục nhật ký liên quan đến việc gửi webhook:

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

Để thu hẹp phạm vi tìm kiếm hơn nữa thành một người đăng ký hoặc loại dữ liệu cụ thể, bạn có thể thêm tiêu chí lọc bổ sung:

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