Logging platform

Google Health API terintegrasi dengan Cloud Logging untuk memberikan insight mendetail kepada klien pihak ketiga tentang status dan hasil pengiriman notifikasi webhook. Integrasi logging ini memungkinkan klien memantau, memecahkan masalah, dan memverifikasi keandalan pengiriman data ke endpoint terdaftar mereka.

Ringkasan

Saat perubahan data pengguna yang relevan terjadi di platform Google Kesehatan, platform akan mengirimkan notifikasi webhook ke endpoint yang telah didaftarkan sebelumnya oleh klien pihak ketiga sebagai permintaan HTTP. Pencatatan aktivitas platform merekam detail transaksi upaya pengiriman ini—termasuk kode status HTTP, header, dan payload respons—serta secara otomatis merutekannya ke project Google Cloud klien.

Untuk mengetahui informasi selengkapnya tentang entri log Cloud Logging, lihat dokumentasi entri log platform Cloud Logging.

Resource yang Dimonitor

Di Cloud Logging, entri log dikelompokkan dalam Resource yang Dimonitor. Entri log notifikasi webhook untuk Google Health API dikaitkan dengan jenis resource instance pelanggan individual:

  • Jenis Resource: health.googleapis.com/Subscriber

Setiap entri log diberi label untuk mengidentifikasi secara unik instance pelanggan yang terpengaruh menggunakan label berikut:

  • resource_container: ID project Google Cloud (atau ID organisasi atau ID folder yang relevan) yang memiliki resource pelanggan.
  • subscriber_id: ID pelanggan unik yang ditetapkan oleh klien saat pembuatan pelanggan.
  • location: Tetapkan ke global, karena definisi pelanggan tidak diregionalkan.

Dengan label ini, Anda dapat membuat kueri dan memfilter entri log khusus untuk satu pelanggan di Logs Explorer Konsol Google Cloud.

Struktur dan Detail Log

  • Nama Log: projects/<PROJECT_ID>/logs/health.googleapis.com%2Fwebhook_notification
  • Jenis Payload: Berisi struktur WebhookNotificationCloudLog yang membungkus detail google.rpc.HttpResponse upaya pengiriman.
  • Label Log:
    • dataType: Jenis data yang terkait dengan langganan (misalnya, NUTRITION, SLEEP).

Memfilter entri log

Anda dapat memfilter entri log webhook di Log Explorer menggunakan kueri. Misalnya, untuk menemukan semua entri log yang terkait dengan pengiriman webhook:

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

Untuk lebih mempersempit penelusuran ke pelanggan atau jenis data tertentu, Anda dapat menambahkan kriteria filter tambahan:

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