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

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

ภาพรวม

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับรายการบันทึกของ 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)

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

คุณสามารถกรองรายการบันทึกเว็บฮุคใน Log Explorer ได้โดยใช้การค้นหา เช่น หากต้องการค้นหารายการบันทึกทั้งหมดที่เกี่ยวข้องกับการส่งเว็บฮุค ให้ทำดังนี้

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"