Melihat log error di Cloud Logging

Halaman ini menjelaskan cara melihat log di Kemampuan Observasi Google Cloud untuk jenis permintaan yang didukung.

Logging

Error yang dipicu dalam setiap permintaan berikut dicatat ke dalam log ke Cloud Logging.

Error juga dicatat ke dalam log jika pesan Pub/Sub tidak dapat dipublikasikan ke Pub/Sub. Lihat Memecahkan masalah notifikasi Pub/Sub untuk informasi selengkapnya.

Logging bersifat otomatis dan tidak perlu diaktifkan. Guna menonaktifkan Cloud Logging untuk satu atau semua resource yang dipantau, lihat Pengecualian log.

Melihat log

Untuk melihat semua log, buka Logs Explorer.

Untuk melihat log operasi dengan status error, ikuti langkah-langkah berikut:

  1. Di konsol Google Cloud, buka browser Cloud Healthcare API.

    Buka browser Cloud Healthcare API

  2. Pilih set data.

  3. Klik tab Operations.

  4. Di daftar operasi, pilih View details in Cloud Logging dari daftar Actions untuk melihat detail operasi yang salah.

Memfilter log

Anda dapat memfilter log menurut jenis penyimpanan data, region, dan set data.

Misalnya, untuk melihat log penyimpanan FHIR, klik Healthcare FHIR Store di daftar pertama di bagian Filter menurut label atau penelusuran teks. Anda juga dapat mencari berdasarkan jenis resource. Misalnya, penelusuran healthcare_dicom_store akan menampilkan semua log yang dihasilkan untuk operasi dengan resource.type yang ditetapkan ke healthcare_dicom_store.

Encoding UTF-8 diterapkan untuk kolom log. Karakter yang bukan karakter UTF-8 akan diganti dengan tanda tanya.

Untuk mengetahui informasi mendetail tentang Logs Explorer, lihat Menggunakan Logs Explorer.

Menggunakan Cloud Logging untuk menemukan peristiwa error

Anda juga dapat menggunakan Cloud Logging untuk menemukan log audit peristiwa yang menyebabkan error. Untuk menemukan peristiwa error di log audit, lakukan tindakan berikut:

  1. Telusuri Cloud Logging untuk menemukan operasi yang disebabkan.

  2. Dengan menggunakan detail log operasi, jalankan kembali perintah tertentu.

  3. Lihat log audit untuk peristiwa yang sesuai. Untuk informasi selengkapnya tentang log audit, lihat Melihat Log Audit Cloud.

Apa itu log?

Entri log Cloud Healthcare API berisi jenis informasi berikut untuk permintaan proses debug:

  • Informasi umum, seperti tingkat keparahan, project ID, nomor project, dan stempel waktu.
  • jsonPayload berisi isi entri yang sebenarnya. Kolom ini berisi kode error, pesan error, dan nama file sumber yang impornya memicu error.
  • operation berisi jenis dan ID operasi yang menghasilkan error.
  • resource berisi lokasi, set data, dan penyimpanan data yang terlibat dalam error.

Jika jumlah error melebihi batas, sejumlah kecil error akan muncul di Cloud Logging. Nilai minimum dihitung secara dinamis berdasarkan ukuran input.

Tempat log disimpan

Kemampuan observasi Google Cloud bukan produk regional. Log yang ditulis ke Kemampuan Observasi Google Cloud dapat disimpan di region yang berbeda dari penyimpanan data.

Contoh entri log impor DICOM

Contoh entri log berikut menunjukkan error empty DICOM instance found yang terjadi saat mencoba mengimpor gs://DICOM_FILENAME.dcm ke projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID.

 jsonPayload: {
  @type:  "type.googleapis.com/google.cloud.healthcare.logging.ImportDicomLogEntry"
  error: {
   code:  3
   message:  "empty DICOM instance found"
  }
  source:  "gs://DICOM_FILENAME.dcm"
 }
 logName:  "projects/PROJECT_ID/logs/healthcare.googleapis.com%2Foperations"
 operation: {
  id:  "PROJECT_ID"
  producer:  "import_dicom"
 }
 receiveTimestamp:  "TIMESTAMP"
 resource: {
  labels: {
   dataset_id:  "DATASET_ID"
   dicom_store_id:  "DICOM_STORE_ID"
   location:  "LOCATION"
   project_id:  "PROJECT_ID"
  }
  type:  "healthcare_dicom_store"
 }
 severity:  "ERROR"
 timestamp:  "TIMESTAMP"

Contoh entri log impor FHIR

Contoh entri log berikut menunjukkan error cannot import resource yang terjadi saat mencoba mengimpor gs://FHIR_FILENAME.ndjson ke projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStore/FHIR_STORE_ID.

 jsonPayload: {
  @type:  "type.googleapis.com/google.cloud.healthcare.logging.ImportFhirLogEntry"
  error: {
   code:  3
   message:  "cannot import resource Patient/PATIENT_ID, conflicting resource already exists"
  }
  source:  "gs://FHIR_FILENAME.ndjson"
 }
 logName:  "projects/PROJECT_ID/logs/healthcare.googleapis.com%2Foperations"
 operation: {
  id:  "PROJECT_ID"
  producer:  "import_fhir"
 }
 receiveTimestamp:  "TIMESTAMP"
 resource: {
  labels: {
   dataset_id:  "DATASET_ID"
   fhir_store_id:  "FHIR_STORE_ID"
   location:  "LOCATION"
   project_id:  "PROJECT_ID"
  }
  type:  "healthcare_fhir_store"
 }
 severity:  "ERROR"
 timestamp:  "TIMESTAMP"

Contoh entri log impor anotasi

Contoh entri log berikut menunjukkan error failed to parse Cloud Storage object yang terjadi saat mencoba mengimpor gs://ANNOTATION_FILE.json ke projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID.

jsonPayload: {
  @type:
  "type.googleapis.com/google.cloud.healthcare.logging.ImportAnnotationLogEntry"
  error: {
    code:  3
    message:  "failed to parse Cloud Storage object"
  }
  source:  "gs://ANNOTATION_FILE.json"
}
logName:
"projects/PROJECT_ID/logs/healthcare.googleapis.com%2Fimport_annotations"
operation: {
  id:
  "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
  producer:  "healthcare.googleapis.com/ImportAnnotations"
}
receiveTimestamp:  "TIMESTAMP"
resource: {
  labels: {
    annotation_store_id:  "ANNOTATION_STORE_ID"
    dataset_id:  "DATASET_ID"
    location:  "LOCATION"
    project_id:  "PROJECT_ID"
  }
  type:  "healthcare_annotation_store"
}
severity:  "ERROR"
timestamp:  "TIMESTAMP"

Contoh entri log de-identifikasi DICOM

Contoh entri log berikut menunjukkan error cannot de-identify dicom instance yang terjadi saat mencoba melakukan de-identifikasi instance DICOM INSTANCE_ID dalam set data projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID.

 jsonPayload: {
  @type:  "type.googleapis.com/google.cloud.healthcare.logging.DeidentifyLogEntry"
  error: {
   code:  2
   message:  "Failed to process instance INSTANCE_ID"
  }
  resourceName:  "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
 }
 logName:  "projects/PROJECT_ID/logs/healthcare.googleapis.com%2Fdeidentify_dataset"
 operation: {
  id:  "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
  producer:  "healthcare.googleapis.com/DeidentifyDataset"
 }
 receiveTimestamp:  "TIMESTAMP"
 resource: {
  labels: {
   dataset_id:  "DATASET_ID"
   location:  "LOCATION"
   project_id:  "PROJECT_ID"
  }
  type:  "healthcare_dataset"
 }
 severity:  "ERROR"
 timestamp:  "TIMESTAMP"

Langkah selanjutnya