Melihat log error di Cloud Logging

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

Logging

Error yang dipicu di setiap permintaan berikut akan dicatat ke dalam log di 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 mengetahui informasi selengkapnya.

Logging bersifat otomatis dan tidak perlu diaktifkan. Untuk menonaktifkan Cloud Logging untuk satu atau semua resource yang dimonitor, 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. Dalam daftar operasi, pilih Lihat detail di Cloud Logging dari daftar Tindakan 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 by label or text search. Anda juga dapat menelusuri menurut jenis resource. Misalnya, menelusuri healthcare_dicom_store akan menampilkan semua log yang dihasilkan untuk operasi dengan resource.type disetel ke healthcare_dicom_store.

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

Untuk 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 dalam log audit, lakukan hal berikut:

  1. Telusuri Cloud Logging untuk menemukan operasi yang menyebabkannya.

  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 Cloud Audit Logs.

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 nilai minimum, sejumlah error terbatas akan muncul di Cloud Logging. Batas dihitung secara dinamis berdasarkan ukuran input.

Tempat log disimpan

Kemampuan Observasi Google Cloud bukan produk regional. Log yang ditulis ke Google Cloud Observability 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