Geração de registros da plataforma

A API Google Health se integra ao Cloud Logging para fornecer aos clientes terceirizados insights detalhados sobre o status e os resultados das entregas de notificações de webhook. Essa integração de geração de registros permite que os clientes monitorem, resolvam problemas e verifiquem a confiabilidade da entrega de dados aos endpoints registrados.

Visão geral

Quando ocorrem mudanças relevantes nos dados do usuário na plataforma Google Health, ela envia uma notificação de webhook ao endpoint pré-registrado do cliente terceirizado como uma solicitação HTTP. A geração de registros da plataforma captura os detalhes da transação dessas tentativas de entrega, incluindo códigos de status HTTP, cabeçalhos e payloads de resposta, e os encaminha automaticamente para o projeto na nuvem do Google Cloud do cliente.

Para mais informações sobre entradas de registro do Cloud Logging, consulte a documentação de entradas de registro da plataforma do Cloud Logging.

Recurso monitorado

No Cloud Logging, as entradas de registro são agrupadas em um recurso monitorado. As entradas de registro de notificação de webhook da API Google Health estão associadas ao tipo de recurso de instância de assinante individual:

  • Tipo de recurso: health.googleapis.com/Subscriber

Cada entrada de registro é rotulada para identificar exclusivamente a instância do assinante afetado usando os seguintes rótulos:

  • resource_container: o ID do projeto na nuvem do Google Cloud (ou o ID da organização ou da pasta relevante) que é proprietário do recurso de assinante.
  • subscriber_id: o ID exclusivo do assinante atribuído pelo cliente na criação do assinante.
  • location: definido como global, já que as definições de assinante não são regionalizadas.

Com esses rótulos, é possível consultar e filtrar entradas de registro específicas de um único assinante no Explorador de registros do console do Google Cloud.

Estrutura e detalhes do registro

  • Nome do registro: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Tipo de payload: contém uma estrutura WebhookNotificationCloudLog que envolve os detalhes google.rpc.HttpResponse da tentativa de entrega.
  • Rótulos de registro:
    • dataType: o tipo de dados associado à assinatura (por exemplo, NUTRITION, SLEEP).

Filtrar entradas de registro

É possível filtrar entradas de registro de webhook na Análise de registros usando consultas. Por exemplo, para encontrar todas as entradas de registro relacionadas a entregas de webhook:

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

Para restringir ainda mais sua pesquisa a um assinante ou tipo de dados específico, adicione outros critérios de filtro:

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