การบันทึกแพลตฟอร์ม

Google Health API ผสานรวมกับ Cloud Logging เพื่อให้ข้อมูลเชิงลึกโดยละเอียดเกี่ยวกับสถานะและผลลัพธ์ของการนำส่งการแจ้งเตือนผ่านเว็บฮุกแก่ไคลเอ็นต์บุคคลที่สาม การผสานรวมการบันทึกนี้ ช่วยให้ลูกค้าตรวจสอบ แก้ปัญหา และยืนยันความน่าเชื่อถือ ของการนำส่งข้อมูลไปยังปลายทางที่ลงทะเบียนไว้ได้

ภาพรวม

เมื่อมีการเปลี่ยนแปลงข้อมูลผู้ใช้ที่เกี่ยวข้องในแพลตฟอร์ม Google Health แพลตฟอร์มจะส่งการแจ้งเตือน Webhook ไปยังปลายทางที่ลงทะเบียนไว้ล่วงหน้าของไคลเอ็นต์บุคคลที่สามเป็นคำขอ HTTP การบันทึกของแพลตฟอร์มจะบันทึกรายละเอียดธุรกรรมของความพยายามในการนำส่งเหล่านี้ ซึ่งรวมถึงรหัสสถานะ HTTP, ส่วนหัว และเพย์โหลดการตอบกลับ แล้วกำหนดเส้นทางไปยังโปรเจ็กต์ Google Cloud ของไคลเอ็นต์โดยอัตโนมัติ

ดูข้อมูลเพิ่มเติมเกี่ยวกับรายการบันทึกของ Cloud Logging ได้ที่เอกสารประกอบเกี่ยวกับรายการบันทึกของแพลตฟอร์ม Cloud Logging

ทรัพยากรที่มีการตรวจสอบ

ใน Cloud Logging ระบบจะจัดกลุ่มรายการบันทึกไว้ภายใต้ทรัพยากรที่ตรวจสอบ รายการบันทึกการแจ้งเตือนของเว็บฮุคสำหรับ Google Health API จะเชื่อมโยงกับ ประเภททรัพยากรของอินสแตนซ์ผู้ติดตามแต่ละราย

• ประเภททรัพยากร: health.googleapis.com/Subscriber

รายการบันทึกแต่ละรายการจะติดป้ายกำกับเพื่อระบุอินสแตนซ์ของสมาชิกที่ได้รับผลกระทบโดยไม่ซ้ำกันโดยใช้ป้ายกำกับต่อไปนี้

• resource_container: รหัสโปรเจ็กต์ Google Cloud (หรือรหัสองค์กรหรือรหัสโฟลเดอร์ที่เกี่ยวข้อง) ที่เป็นเจ้าของทรัพยากรของสมาชิก
• subscriber_id: รหัสสมาชิกที่ไม่ซ้ำกันที่ไคลเอ็นต์กำหนด เมื่อมีการสร้างสมาชิก
• location: ตั้งค่าเป็น global เนื่องจากคำจำกัดความของผู้ติดตามไม่ได้ แบ่งตามภูมิภาค

ป้ายกำกับเหล่านี้ช่วยให้คุณค้นหาและกรองรายการบันทึกที่เฉพาะเจาะจงสำหรับผู้สมัครใช้บริการรายเดียวใน Log Explorer ของคอนโซล Google Cloud ได้

โครงสร้างและรายละเอียดบันทึก

• ชื่อบันทึก: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
• ประเภทเพย์โหลด: มีWebhookNotificationCloudLogโครงสร้าง ที่ครอบคลุมgoogle.rpc.HttpResponseรายละเอียดของความพยายามในการนำส่ง
• ป้ายกำกับของบันทึก
  • dataType: ประเภทข้อมูลที่เชื่อมโยงกับการสมัครใช้บริการ (เช่น NUTRITION, SLEEP)

กรองรายการบันทึก

คุณกรองรายการบันทึกของ Webhook ใน Log Explorer ได้โดยใช้การค้นหา เช่น หากต้องการค้นหารายการบันทึกทั้งหมดที่เกี่ยวข้องกับการนำส่ง 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"