Google Health API משתלב עם Cloud Logging כדי לספק ללקוחות צד שלישי תובנות מפורטות לגבי הסטטוס והתוצאות של מסירות התראות של Webhook. שילוב היומנים הזה מאפשר ללקוחות לעקוב אחרי מסירת הנתונים לנקודות הקצה הרשומות שלהם, לפתור בעיות ולאמת את המהימנות שלה.
סקירה כללית
כשמתרחשים שינויים רלוונטיים בנתוני המשתמשים בפלטפורמת Google Health, הפלטפורמה שולחת הודעת webhook לנקודת הקצה הרשומה מראש של לקוח צד שלישי כבקשת HTTP. רישום ביומן בפלטפורמה מתעד את פרטי העסקאות של ניסיונות המסירה האלה – כולל קודי סטטוס HTTP, כותרות ומטעני תגובה – ומנתב אותם אוטומטית לפרויקט Google Cloud של הלקוח.
מידע נוסף על רשומות ביומן של Cloud Logging זמין במאמרי העזרה בנושא רשומות ביומן של פלטפורמת Cloud Logging.
משאב במעקב
ב-Cloud Logging, רשומות ביומן מקובצות תחת משאב במעקב. רשומות ביומן של התראות webhook עבור Google Health API משויכות לסוג המשאב של מופע המנוי הספציפי:
- Resource Type:
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 - סוג המטען הייעודי (Payload): מכיל מבנה
WebhookNotificationCloudLogשעוטף את הפרטיםgoogle.rpc.HttpResponseשל ניסיון המסירה. - תוויות של יומנים:
-
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"