تتكامل Google Health API مع Cloud Logging لتزويد العملاء الخارجيين بإحصاءات تفصيلية حول حالة عمليات تسليم إشعارات الويب هوك و نتائجها. يتيح هذا التكامل في تسجيل الأحداث للعملاء مراقبة عمليات تسليم البيانات إلى نقاط النهاية المسجّلة وحلّ المشاكل فيها والتحقّق من موثوقيتها.
نظرة عامة
عند حدوث تغييرات ذات صلة ببيانات المستخدِم في منصة Google Health، تُرسِل المنصة إشعار ويب هوك إلى نقطة النهاية المسجّلة مسبقًا لدى العميل الخارجي كطلب HTTP. تسجِّل المنصة تفاصيل المعاملات لمحاولات التسليم هذه، بما في ذلك رموز حالة HTTP والعناوين والحمولات المستجيبة، وتوجِّهها تلقائيًا إلى مشروع العميل على السحابة الإلكترونية من Google.
لمزيد من المعلومات عن إدخالات سجلّات Cloud Logging، يُرجى الاطّلاع على مستندات إدخالات سجلّات منصة Cloud Logging.
المورد المراقب
في Cloud Logging، يتم تجميع إدخالات السجلّات ضمن مورد مراقَب. ترتبط إدخالات سجلّات إشعارات الويب هوك في Google Health API بنوع مورد مثيل المشترك الفردي:
- نوع المورد:
health.googleapis.com/Subscriber
يتم تصنيف كل إدخال في السجلّ لتحديد مثيل المشترك المتأثر بشكلٍ فريد باستخدام التصنيفات التالية:
- resource_container: رقم تعريف مشروع Google Cloud (أو رقم تعريف المؤسسة أو رقم تعريف المجلد ذي الصلة) الذي يملك مورد المشترك.
- subscriber_id: رقم تعريف المشترك الفريد الذي يخصّصه العميل عند إنشاء المشترك
- location: يتم ضبطه على
global، لأنّ تعريفات المشتركين ليست إقليمية.
تتيح لك هذه التصنيفات طلب إدخالات السجلّات الخاصة بمشترك واحد وفلترتها في "مستكشف السجلّات" في Google Cloud Console.
بنية السجلّ وتفاصيله
- اسم السجلّ:
projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification - نوع الحمولة: يحتوي على بنية
WebhookNotificationCloudLogالتي تضم تفاصيلgoogle.rpc.HttpResponseلمحاولة التسليم. - تصنيفات السجلّ:
dataType: نوع البيانات المرتبط بالاشتراك (مثلNUTRITIONأوSLEEP)
فلترة إدخالات السجلّات
يمكنك فلترة إدخالات سجلّات الويب هوك في "مستكشف السجلّات" باستخدام طلبات البحث. على سبيل المثال، للعثور على جميع إدخالات السجلّات المرتبطة بعمليات تسليم الويب هوك:
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"