Registro de plataformas

La API de Google Health se integra con Cloud Logging para proporcionar a los clientes externos estadísticas detalladas sobre el estado y los resultados de las entregas de notificaciones de webhook. Esta integración de Logging permite a los clientes supervisar, solucionar problemas y verificar la confiabilidad de la entrega de datos a sus extremos registrados.

Descripción general

Cuando se producen cambios relevantes en los datos del usuario en la plataforma de Google Health, la plataforma envía una notificación de webhook al extremo pre registrado del cliente externo como una solicitud HTTP. El registro de la plataforma captura los detalles de la transacción de estos intentos de entrega, incluidos los códigos de estado HTTP, los encabezados y las cargas útiles de respuesta, y los enruta automáticamente al proyecto de Google Cloud del cliente.

Para obtener más información sobre las entradas de registro de Cloud Logging, consulta la documentación de las entradas de registro de la plataforma de Cloud Logging.

Recurso supervisado

En Cloud Logging, las entradas de registro se agrupan en un recurso supervisado. Las entradas de registro de notificaciones de webhook para la API de Google Health están asociadas con el tipo de recurso de instancia de suscriptor individual:

  • Resource Type: health.googleapis.com/Subscriber

Cada entrada de registro está etiquetada para identificar de forma única la instancia de suscriptor afectada con las siguientes etiquetas:

  • resource_container: Es el ID del proyecto de Google Cloud (o el ID de organización o el ID de la carpeta correspondiente) que posee el recurso de suscriptor.
  • subscriber_id: Es el ID de suscriptor único que asigna el cliente cuando se crea el suscriptor.
  • ubicación: Se establece en global, ya que las definiciones de suscriptor no están regionalizadas.

Estas etiquetas te permiten consultar y filtrar entradas de registro específicas para un solo suscriptor en el Explorador de registros de la consola de Google Cloud.

Estructura y detalles del registro

  • Nombre del registro: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Tipo de carga útil: Contiene una estructura WebhookNotificationCloudLog que incluye los detalles de google.rpc.HttpResponse del intento de entrega.
  • Etiquetas de registro:
    • dataType: Es el tipo de datos asociado con la suscripción (por ejemplo, NUTRITION, SLEEP).

Filtra entradas de registro

Puedes filtrar las entradas de registro de webhook en el Explorador de registros con consultas. Por ejemplo, para encontrar todas las entradas de registro relacionadas con las entregas de webhook, haz lo siguiente:

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

Para acotar aún más la búsqueda a un suscriptor o tipo de datos específico, puedes agregar criterios de filtro adicionales:

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