Journalisation de plate-forme

L'API Google Health s'intègre à Cloud Logging pour fournir aux clients tiers des informations détaillées sur l'état et les résultats des notifications de webhook. Cette intégration de journalisation permet aux clients de surveiller, de dépanner et de vérifier la fiabilité de la diffusion des données vers leurs points de terminaison enregistrés.

Présentation

Lorsque des données utilisateur pertinentes sont modifiées sur la plate-forme Google Health, celle-ci envoie une notification de webhook au point de terminaison préenregistré du client tiers sous la forme d'une requête HTTP. La journalisation de la plate-forme capture les détails des transactions de ces tentatives de remise (y compris les codes d'état HTTP, les en-têtes et les charges utiles de réponse) et les achemine automatiquement vers le projet Google Cloud du client.

Pour en savoir plus sur les entrées de journal Cloud Logging, consultez la documentation sur les entrées de journal de la plate-forme Cloud Logging.

Ressource surveillée

Dans Cloud Logging, les entrées de journal sont regroupées sous une ressource surveillée. Les entrées de journal de notification de webhook pour l'API Google Health sont associées au type de ressource d'instance d'abonné individuel :

  • Type de ressource : health.googleapis.com/Subscriber

Chaque entrée de journal est étiquetée pour identifier de manière unique l'instance d'abonné concernée à l'aide des libellés suivants :

  • resource_container : ID du projet Google Cloud (ou ID de l'organisation ou du dossier concerné) propriétaire de la ressource de l'abonné.
  • subscriber_id : ID d'abonné unique attribué par le client lors de la création de l'abonné.
  • location : défini sur global, car les définitions d'abonnés ne sont pas régionalisées.

Ces libellés vous permettent d'interroger et de filtrer les entrées de journal spécifiques à un seul abonné dans l'explorateur de journaux de la console Google Cloud.

Structure et détails des journaux

  • Nom du journal : projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Type de charge utile : contient une structure WebhookNotificationCloudLog qui encapsule les détails google.rpc.HttpResponse de la tentative de remise.
  • Libellés des journaux :
    • dataType : type de données associé à l'abonnement (par exemple, NUTRITION, SLEEP).

Filtrer les entrées de journal

Vous pouvez filtrer les entrées de journal des webhooks dans l'explorateur de journaux à l'aide de requêtes. Par exemple, pour trouver toutes les entrées de journal liées aux livraisons de webhook :

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

Pour affiner davantage votre recherche à un abonné ou un type de données spécifiques, vous pouvez ajouter des critères de filtrage :

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