Ведение журнала платформы

API Google Health интегрируется с Cloud Logging , предоставляя сторонним клиентам подробную информацию о статусе и результатах доставки уведомлений через веб-перехватчики. Эта интеграция с системой логирования позволяет клиентам отслеживать, устранять неполадки и проверять надежность доставки данных на зарегистрированные конечные точки.

Обзор

Когда в платформе Google Health происходят соответствующие изменения пользовательских данных, платформа отправляет уведомление через веб-перехватчик на предварительно зарегистрированную конечную точку стороннего клиента в виде HTTP-запроса. Журналирование платформы фиксирует детали транзакций этих попыток доставки — включая коды состояния HTTP, заголовки и полезную нагрузку ответа — и автоматически направляет их в проект Google Cloud клиента.

Для получения дополнительной информации о записях журналов Cloud Logging см. документацию по записям журналов платформы Cloud Logging .

Контролируемый ресурс

В Cloud Logging записи журналов группируются в рамках отслеживаемого ресурса . Записи журналов уведомлений Webhook для Google Health API связаны с типом ресурса отдельного экземпляра подписчика:

  • Тип ресурса : health.googleapis.com/Subscriber

Каждая запись в журнале помечена для уникальной идентификации затронутого экземпляра абонента с использованием следующих меток:

  • resource_container : Идентификатор проекта Google Cloud (или соответствующий идентификатор организации или папки), которому принадлежит ресурс подписчика.
  • subscriber_id : Уникальный идентификатор подписчика, присваиваемый клиентом при создании подписчика.
  • Местоположение : Установите значение global , поскольку определения абонентов не регионализируются.

Эти метки позволяют запрашивать и фильтровать записи журналов, относящиеся к конкретному подписчику, в обозревателе журналов консоли Google Cloud.

Структура и подробности журнала

  • Имя журнала : projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Тип полезной нагрузки : Содержит структуру WebhookNotificationCloudLog , содержащую сведения о попытке доставки google.rpc.HttpResponse .
  • Метки журнала :
    • dataType : Тип данных, связанный с подпиской (например, NUTRITION , SLEEP ).

Фильтрация записей журнала

В обозревателе журналов можно фильтровать записи веб-перехватчиков с помощью запросов. Например, чтобы найти все записи журналов, связанные с доставкой веб-перехватчиков:

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

Чтобы еще больше сузить область поиска до конкретного подписчика или типа данных, вы можете добавить дополнительные критерии фильтрации:

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