Logging della piattaforma

L'API Google Health si integra con Cloud Logging per fornire ai client di terze parti informazioni dettagliate sullo stato e sui risultati delle consegne delle notifiche webhook. Questa integrazione di logging consente ai client di monitorare, risolvere i problemi e verificare l'affidabilità della consegna dei dati agli endpoint registrati.

Panoramica

Quando si verificano modifiche ai dati utente pertinenti nella piattaforma Google Health, la piattaforma invia una notifica webhook all'endpoint preregistrato del client di terze parti come richiesta HTTP. Il logging della piattaforma acquisisce i dettagli della transazione di questi tentativi di consegna, inclusi codici di stato HTTP, intestazioni e payload di risposta, e li invia automaticamente al progetto Google Cloud del client.

Per saperne di più sulle voci di log di Cloud Logging, consulta la documentazione relativa alle voci di log della piattaforma Cloud Logging.

Risorsa monitorata

In Cloud Logging, le voci di log sono raggruppate in una risorsa monitorata. Le voci di log delle notifiche webhook per l'API Google Health sono associate al tipo di risorsa dell'istanza di abbonato individuale:

  • Tipo di risorsa: health.googleapis.com/Subscriber

Ogni voce di log è etichettata per identificare in modo univoco l'istanza di abbonato interessata utilizzando le seguenti etichette:

  • resource_container: l'ID progetto Google Cloud (o l' ID organizzazione o l'ID cartella pertinente) proprietario della risorsa abbonato.
  • subscriber_id: l'ID abbonato univoco assegnato dal client al momento della creazione dell'abbonato.
  • posizione: impostato su global, poiché le definizioni degli abbonati non sono regionalizzate.

Queste etichette ti consentono di eseguire query e filtrare le voci di log specifiche di un singolo abbonato in Esplora log della console Google Cloud.

Struttura e dettagli dei log

  • Nome log: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Tipo di payload: contiene una struttura WebhookNotificationCloudLog che racchiude i dettagli google.rpc.HttpResponse del tentativo di consegna.
  • Etichette log:
    • dataType: il tipo di dati associato all'abbonamento (ad es. NUTRITION, SLEEP).

Filtra le voci di log

Puoi filtrare le voci di log webhook in Esplora log utilizzando le query. Ad esempio, per trovare tutte le voci di log relative alle consegne webhook:

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

Per restringere ulteriormente la ricerca a un abbonato o a un tipo di dati specifico, puoi aggiungere altri criteri di filtro:

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