Menggunakan log platform

Halaman ini menjelaskan cara melihat log platform yang dihasilkan oleh SaaS Runtime. Log platform di Google Cloud adalah log khusus layanan, yang dapat Anda gunakan untuk men-debug dan memecahkan masalah, serta lebih memahami layanan yang Anda gunakan. Google Cloud

Untuk mengetahui detail tentang log platform SaaS Runtime yang didukung, lihat Log platform.Google Cloud Untuk mengetahui informasi selengkapnya tentang cara memahami data dalam tabel log platform, lihat Struktur entri log.

Sebelum memulai

  1. Di konsol Google Cloud , pada halaman pemilih project, pilih atau buat project Google Cloud .
  2. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.
  3. Aktifkan SaaS Runtime API.
  4. Untuk mendapatkan izin yang diperlukan guna melihat log dan membuat pemberitahuan, minta administrator untuk memberi Anda peran Identity and Access Management (IAM) berikut di project Anda:
    • Logs Viewer (roles/logging.viewer)
    • Editor Pemantauan (roles/monitoring.editor)

Membuat pemberitahuan berbasis log

Untuk membuat pemberitahuan berbasis log, Anda membuat kueri di Logs Explorer yang menampilkan entri log yang ingin Anda pantau, lalu mengonfigurasi kebijakan pemberitahuan.

  1. Di konsol Google Cloud , buka halaman Logs Explorer.

    Buka Logs Explorer

  2. Di editor kueri, masukkan kueri untuk memfilter entri log yang dipilih. Lihat bagian berikut untuk mengetahui contoh kueri.

  3. Klik Buat pemberitahuan.

  4. Masukkan nama dan deskripsi untuk kebijakan pemberitahuan.

  5. Konfigurasi detail pemberitahuan, termasuk saluran notifikasi.

  6. Klik Simpan notifikasi.

Untuk mengetahui petunjuk mendetail, lihat Membuat pemberitahuan berbasis log.

Contoh kueri untuk log platform

Bagian ini memberikan contoh kueri untuk skenario pemberitahuan umum berdasarkan log platform SaaS Runtime.

Notifikasi operasi SaaS

Untuk membuat pemberitahuan saat operasi penyediaan unit gagal, gunakan kueri:

protoPayload.methodName="google.cloud.saasplatform.saasservicemgmt.v1beta1.SaasDeployments.CreateUnitOperation"
protoPayload.response.state="UNIT_OPERATION_STATE_FAILED"

Untuk membuat pemberitahuan saat operasi penyediaan unit mencapai status akhir (berhasil, gagal, atau dibatalkan), gunakan kueri:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.UnitOperationLog"
AND (jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_SUCCEEDED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_FAILED" OR jsonPayload.unit_operation_state="UNIT_OPERATION_STATE_CANCELLED")
AND jsonPayload.unit_operation_type="PROVISION"

Pemberitahuan peluncuran

Untuk membuat pemberitahuan jika peluncuran regional memasuki status PAUSED atau FAILED karena alasan selain tindakan pengguna, gunakan kueri:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.RolloutLog"
AND (jsonPayload.current_state="PAUSED" OR jsonPayload.current_state="FAILED")
AND jsonPayload.reason!="USER_PAUSE"
AND jsonPayload.root_rollout_id != resource.labels.rollout_id

Untuk membuat pemberitahuan jika peluncuran global memasuki status PAUSED atau FAILED, gunakan kueri:

jsonPayload.@type="type.googleapis.com/google.cloud.saasservicemgmt.logging.v1.RolloutLog"
AND (jsonPayload.current_state="PAUSED" OR jsonPayload.current_state="FAILED")
AND jsonPayload.root_rollout_id == resource.labels.rollout_id

Untuk membuat pemberitahuan log saat peluncuran memasuki status PAUSED (karena SaaS Runtime telah mengidentifikasi peluncuran sebagai tidak responsif), atau status FAILED, gunakan kueri:

logName:"rollout_events" 
(jsonPayload.currentState="PAUSED" jsonPayload.reason="SYSTEM_PAUSE")
OR 
jsonPayload.currentState="FAILED

Untuk membuat pemberitahuan log untuk metrik status peluncuran saat peluncuran memasuki status PAUSED (karena SaaS Runtime telah mengidentifikasi peluncuran sebagai tidak sehat), atau status FAILED, gunakan kueri:

saasservicemgmt_googleapis_com:rollout_state
{state_name="PAUSED", reason="SYSTEM_PAUSE"}
OR
saasservicemgmt_googleapis_com:rollout_state{state_name="FAILED"}

Langkah berikutnya