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.
- De-identifikasi DICOM
- Ekspor DICOM
- Impor DICOM
- De-identifikasi set data
- De-identifikasi FHIR
- Ekspor FHIR
- Impor FHIR
- Ekspor HL7v2
- Impor HL7v2
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:
Di konsol Google Cloud, buka browser Cloud Healthcare API.
Pilih set data.
Klik tab Operations.
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:
Telusuri Cloud Logging untuk menemukan operasi yang menyebabkannya.
Dengan menggunakan detail log operasi, jalankan kembali perintah tertentu.
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
- Tinjau informasi konseptual tentang Cloud Healthcare API
- Tinjau informasi konseptual tentang Cloud Logging