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 dans la plate-forme Google Health, celle-ci envoie une notification de webhook au point de terminaison préenregistré du client tiers sous forme de requête HTTP. La journalisation de la plate-forme capture les détails de la transaction de ces tentatives de diffusion, 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 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 libellé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 d'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 Google Cloud Console.

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 encapsulant les détails google.rpc.HttpResponse de la tentative de diffusion.
  • Libellés de journal:
    • 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 de webhook dans l'explorateur de journaux à l'aide de requêtes. Par exemple, pour trouver toutes les entrées de journal liées aux diffusions de webhook :

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

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

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