Logowanie platformy

Interfejs Google Health API integruje się z Cloud Logging, aby udostępniać klientom zewnętrznym szczegółowe informacje o stanie i wynikach dostarczania powiadomień webhook. Ta integracja logowania umożliwia klientom monitorowanie, rozwiązywanie problemów i weryfikowanie niezawodności dostarczania danych do zarejestrowanych punktów końcowych.

Przegląd

Gdy w platformie Google Health nastąpią zmiany istotnych danych użytkownika, platforma wyśle powiadomienie webhook do wstępnie zarejestrowanego punktu końcowego klienta zewnętrznego jako żądanie HTTP. Logowanie platformy rejestruje szczegóły transakcji tych prób dostarczenia, w tym kody stanu HTTP, nagłówki i ładunki odpowiedzi, i automatycznie przekierowuje je do projektu w chmurze Google klienta.

Więcej informacji o wpisach w logach Cloud Logging znajdziesz w dokumentacji wpisów w logach platformy Cloud Logging.

Monitorowany zasób

W Cloud Logging wpisy w logach są grupowane w sekcji Monitorowany zasób. Wpisy w logach powiadomień webhook interfejsu Google Health API są powiązane z typem zasobu poszczególnych instancji subskrybenta:

  • Typ zasobu: health.googleapis.com/Subscriber

Każdy wpis w logu jest oznaczony etykietą, która jednoznacznie identyfikuje daną instancję subskrybenta. Używane są te etykiety:

  • resource_container: identyfikator projektu Google Cloud (lub odpowiedni identyfikator organizacji albo identyfikator folderu), który jest właścicielem zasobu subskrybenta.
  • subscriber_id: unikalny identyfikator subskrybenta przypisany przez klienta podczas tworzenia subskrybenta.
  • location: ustawiony na global, ponieważ definicje subskrybentów nie są regionalizowane.

Te etykiety umożliwiają wysyłanie zapytań i filtrowanie wpisów w logach dotyczących konkretnego subskrybenta w Eksploratorze logów w Google Cloud Console.

Struktura i szczegóły logu

  • Nazwa logu: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Typ ładunku: zawiera strukturę WebhookNotificationCloudLog otaczającą szczegóły google.rpc.HttpResponse próby dostarczenia.
  • Etykiety logu:
    • dataType: typ danych powiązany z subskrypcją (np. NUTRITION, SLEEP).

Filtrowanie wpisów w logach

Wpisy w logach webhook możesz filtrować w Eksploratorze logów za pomocą zapytań. Aby na przykład znaleźć wszystkie wpisy w logach związane z dostarczaniem webhook:

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

Aby dodatkowo zawęzić wyszukiwanie do konkretnego subskrybenta lub typu danych, możesz dodać dodatkowe kryteria filtrowania:

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