Platform günlük kaydı

Google Health API, üçüncü taraf istemcilere webhook bildirimi teslimatlarının durumu ve sonuçları hakkında ayrıntılı bilgiler sağlamak için Cloud Logging ile entegre olur. Bu günlük entegrasyonu, müşterilerin kayıtlı uç noktalarına veri tesliminin güvenilirliğini izlemesine, sorunlarını gidermesine ve doğrulamasına olanak tanır.

Genel Bakış

Google Health platformunda alakalı kullanıcı verilerinde değişiklikler olduğunda platform, üçüncü taraf istemcisinin önceden kaydedilmiş uç noktasına HTTP isteği olarak bir webhook bildirimi gönderir. Platform günlüğü, bu teslimat denemelerinin işlem ayrıntılarını (HTTP durum kodları, üstbilgiler ve yanıt yükleri dahil) yakalar ve bunları otomatik olarak istemcinin Google Cloud projesine yönlendirir.

Cloud Logging günlük girişleri hakkında daha fazla bilgi için Cloud Logging platform günlük girişleri belgelerine bakın.

İzlenen Kaynak

Cloud Logging'de günlük girişleri bir İzlenen Kaynak altında gruplandırılır. Google Health API'nin webhook bildirimi günlük girişleri, bireysel abone örneği kaynak türüyle ilişkilendirilir:

  • Kaynak Türü: health.googleapis.com/Subscriber

Her günlük girişi, aşağıdaki etiketler kullanılarak etkilenen abone örneğini benzersiz şekilde tanımlamak için etiketlenir:

  • resource_container: Abone kaynağının sahibi olan Google Cloud proje kimliği (veya ilgili kuruluş kimliği ya da klasör kimliği).
  • subscriber_id: Abone oluşturulduğunda istemci tarafından atanan benzersiz abone kimliği.
  • location: Abone tanımları bölgeselleştirilmediğinden global olarak ayarlayın.

Bu etiketler, Google Cloud Console'daki Günlük Gezgini'nde tek bir aboneye özel günlük girişlerini sorgulamanıza ve filtrelemenize olanak tanır.

Günlük Yapısı ve Ayrıntıları

  • Günlük Adı: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Yük Türü: Teslimat denemesiyle ilgili google.rpc.HttpResponse ayrıntılarını içeren bir WebhookNotificationCloudLog yapısı içerir.
  • Günlük Etiketleri:
    • dataType: Abonelikle ilişkili veri türü (ör. NUTRITION, SLEEP).

Günlük girişlerini filtreleme

Sorguları kullanarak günlük gezginindeki webhook günlük girişlerini filtreleyebilirsiniz. Örneğin, webhook teslimatlarıyla ilgili tüm günlük girişlerini bulmak için:

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

Aramanızı belirli bir abone veya veri türüyle daha da daraltmak için ek filtre ölçütleri ekleyebilirsiniz:

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