本頁面說明如何在 Google Cloud Observability 中查看支援的要求類型的記錄。
記錄
在下列各項要求中觸發的錯誤會記錄到 Cloud Logging。
如果 Pub/Sub 訊息無法發布至 Pub/Sub,系統也會記錄錯誤。詳情請參閱排解 Pub/Sub 通知問題。
Logging 會自動執行,您不需要啟用它。如要為一或所有受監控的資源停用 Cloud Logging,請參閱「記錄排除項目」。
查看記錄
如要查看所有記錄,請前往記錄檔探索工具。
如要查看狀態為錯誤的作業記錄,請按照下列步驟操作:
前往 Google Cloud 控制台的 Cloud Healthcare API 瀏覽器。
選取資料集。
按一下「作業」分頁。
在作業清單中,從「動作」清單中選擇「在 Cloud Logging 中查看詳細資料」,即可查看錯誤作業的詳細資料。
篩選記錄
您可以依據資料儲存類型、區域和資料集篩選記錄。
舉例來說,如要查看 FHIR 儲存庫的記錄,請按一下「Filter by label or text search」下方第一個清單中的「Healthcare FHIR Store」。您也可以依資源類型進行搜尋。舉例來說,搜尋 healthcare_dicom_store
會顯示為作業產生的所有記錄,且 resource.type
會設為 healthcare_dicom_store
。
系統會對記錄檔欄位強制採用 UTF-8 編碼。非 UTF-8 字元的字元會替換為問號。
如要進一步瞭解記錄檔探索工具,請參閱「使用記錄檔探索工具」。
使用 Cloud Logging 找出錯誤事件
您也可以使用 Cloud Logging 找出導致錯誤的事件稽核記錄。如要在稽核記錄中找出錯誤事件,請按照下列步驟操作:
在 Cloud Logging 中搜尋造成問題的作業。
根據作業的記錄詳細資料,重新執行特定指令。
查看對應事件的稽核記錄。如要進一步瞭解稽核記錄,請參閱「查看 Cloud 稽核記錄」。
記錄內容
Cloud Healthcare API 記錄項目包含下列類型的資訊,可用於偵錯要求:
- 一般資訊,例如嚴重性、專案 ID、專案編號和時間戳記。
jsonPayload
包含項目的實際主體。這個欄位包含錯誤代碼、錯誤訊息,以及匯入時觸發錯誤的原始檔案名稱。operation
包含產生錯誤的作業類型和 ID。resource
包含與錯誤相關的地點、資料集和資料儲存庫。
如果錯誤數量超過閾值,Cloud Logging 只會顯示部分錯誤。系統會根據輸入內容的大小,動態計算閾值。
記錄檔的儲存位置
Google Cloud Observability 並非區域性產品。寫入 Google Cloud Observability 的記錄檔,可能會儲存在與資料儲存區不同的區域。
DICOM 匯入記錄項目範例
以下記錄項目範例顯示嘗試將 gs://DICOM_FILENAME.dcm
匯入 projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
時發生的 empty DICOM instance found
錯誤。
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"
FHIR 匯入記錄項目範例
以下記錄項目範例顯示嘗試將 gs://FHIR_FILENAME.ndjson
匯入 projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStore/FHIR_STORE_ID
時發生的 cannot import resource
錯誤。
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"
DICOM 去識別記錄項目範例
以下記錄項目範例顯示,在資料集 projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID
中嘗試去識別 DICOM 例項 INSTANCE_ID 時發生 cannot de-identify dicom instance
錯誤。
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"