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 registros 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, esta 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 las transacciones 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 sobre 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 se asocian 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 del suscriptor afectada con las siguientes etiquetas:

  • resource_container: Es el ID del proyecto de Google Cloud (o el ID de la organización o de la carpeta pertinente) que posee el recurso de suscriptor.
  • subscriber_id: Es el ID único del suscriptor que asigna el cliente cuando se crea el suscriptor.
  • location: 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.
  • Log Labels:
    • dataType: Es el tipo de datos asociado a la suscripción (p.ej., 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 restringir 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"