查看 Cloud Logging 中的錯誤記錄檔

本頁面說明如何在 Google Cloud Observability 中查看支援的要求類型的記錄。

記錄

在下列各項要求中觸發的錯誤會記錄到 Cloud Logging

如果 Pub/Sub 訊息無法發布至 Pub/Sub,系統也會記錄錯誤。詳情請參閱排解 Pub/Sub 通知問題

Logging 會自動執行,您不需要啟用它。如要為一或所有受監控的資源停用 Cloud Logging,請參閱「記錄排除項目」。

查看記錄

如要查看所有記錄,請前往記錄檔探索工具

如要查看狀態為錯誤的作業記錄,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的 Cloud Healthcare API 瀏覽器。

    前往 Cloud Healthcare API 瀏覽器

  2. 選取資料集。

  3. 按一下「作業」分頁。

  4. 在作業清單中,從「動作」清單中選擇「在 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 找出導致錯誤的事件稽核記錄。如要在稽核記錄中找出錯誤事件,請按照下列步驟操作:

  1. 在 Cloud Logging 中搜尋造成問題的作業。

  2. 根據作業的記錄詳細資料,重新執行特定指令。

  3. 查看對應事件的稽核記錄。如要進一步瞭解稽核記錄,請參閱「查看 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"

後續步驟