Plattform-Logging

Die Google Health API ist in Cloud Logging integriert, um Drittanbieter-Clients detaillierte Informationen zum Status und zu den Ergebnissen von Webhook-Benachrichtigungen zu geben. Durch diese Logging-Integration können Clients die Zuverlässigkeit der Datenübermittlung an ihre registrierten Endpunkte überwachen, Fehler beheben und überprüfen.

Übersicht

Wenn sich relevante Nutzerdaten auf der Google Health-Plattform ändern, sendet die Plattform eine Webhook-Benachrichtigung als HTTP-Anfrage an den vorregistrierten Endpunkt des Drittanbieter-Clients. Bei der Plattformprotokollierung werden die Transaktionsdetails dieser Übermittlungsversuche erfasst, einschließlich HTTP-Statuscodes, Headern und Antwortnutzlasten, und automatisch an das Google Cloud-Projekt des Clients weitergeleitet.

Weitere Informationen zu Cloud Logging-Logeinträgen finden Sie in der Dokumentation zu Plattform-Logeinträgen in Cloud Logging.

Überwachte Ressource

In Cloud Logging werden Logeinträge unter einer überwachten Ressource gruppiert. Logeinträge zu Webhook-Benachrichtigungen für die Google Health API sind mit dem Ressourcentyp der einzelnen Abonnenteninstanz verknüpft:

  • Ressourcentyp: health.googleapis.com/Subscriber

Jeder Logeintrag wird mit Labels versehen, um die betroffene Abonnenteninstanz eindeutig zu identifizieren. Dazu werden die folgenden Labels verwendet:

  • resource_container: Die Google Cloud-Projekt-ID (oder die entsprechende Organisations-ID oder Ordner-ID), zu der die Abonnenten ressource gehört.
  • subscriber_id: Die eindeutige Abonnenten-ID, die vom Client zugewiesen wurde bei der Erstellung des Abonnenten.
  • location: Auf global festgelegt, da Abonnentendefinitionen nicht regionalisiert sind.

Mit diesen Labels können Sie im Log-Explorer der Google Cloud Console Logeinträge abfragen und filtern, die sich auf einen einzelnen Abonnenten beziehen.

Logstruktur und Details

  • Logname: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Nutzlasttyp: Enthält eine WebhookNotificationCloudLog Struktur die die google.rpc.HttpResponse Details des Übermittlungs versuchs umschließt.
  • Loglabels:
    • dataType: Der Datentyp, der mit dem Abo verknüpft ist, z.B. NUTRITION oder SLEEP.

Log-Einträge filtern

Sie können Webhook-Logeinträge im Log-Explorer mit Abfragen filtern. So finden Sie beispielsweise alle Logeinträge zu Webhook-Übermittlungen:

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

Wenn Sie die Suche weiter auf einen bestimmten Abonnenten oder Datentyp eingrenzen möchten, können Sie zusätzliche Filterkriterien anhängen:

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