Como visualizar registros de erros no Cloud Logging

Nesta página, explicamos como visualizar registros no conjunto de operações do Google Cloud para erros acionados em solicitações de importação e exportação DICOM.

Logging

Os erros acionados em cada uma das solicitações a seguir são registrados no Cloud Logging.

Os erros também serão registrados se uma mensagem do Pub/Sub não puder ser publicada no Pub/Sub. Consulte Solução de problemas de notificações do Pub/Sub para mais informações.

A geração de registros é automática e não precisa ser ativada. Para desativar o Cloud Logging para um ou todos os recursos monitorados, consulte Exclusões de registros.

Ver registros

Para ver todos os registros, acesse o Visualizador de registros. Para ver registros de operações com um status de erro, clique no ícone de mais informações da operação na guia OPERAÇÃO no navegador de saúde e clique em Visualizar detalhes no Stackdriver.

Como filtrar registros

É possível filtrar registros por tipo de loja (armazenamento DICOM ou FHIR), região e conjunto de dados.

Por exemplo, para ver registros de lojas FHIR, clique em Loja FHIR do Healthcare na primeira lista em Filtrar por rótulo ou pesquisa de texto. Você também pode pesquisar por tipo de recurso. Por exemplo, pesquisar healthcare_dicom_store exibe todos os registros gerados para operações com resource.type definido como healthcare_dicom_store.

A codificação UTF-8 é aplicada aos campos de registro. Os caracteres que não são UTF-8 são substituídos por pontos de interrogação.

Para informações detalhadas sobre o Visualizador de registros, consulte Como visualizar registros.

Como usar o Cloud Logging para encontrar eventos de erro

Também é possível usar o Cloud Logging para encontrar o registro de auditoria de um evento que está causando um erro. Para encontrar um evento de erro nos registros de auditoria, faça o seguinte:

  1. Pesquise no Cloud Logging a operação que causou.

  2. Usando os detalhes do registro da operação, execute novamente o comando específico.

  3. Veja os registros de auditoria do evento correspondente. Para mais informações sobre registros de auditoria, consulte Como visualizar registros de auditoria do Cloud.

O que é registrado

As entradas de registro da API Cloud Healthcare contêm os seguintes tipos de informações para solicitações de depuração:

  • Informações gerais, como gravidade, ID do projeto, número do projeto e carimbo de data / hora.
  • jsonPayload contém o corpo real da entrada. Esse campo contém o código de erro, a mensagem de erro e o nome do arquivo de origem cuja importação acionou o erro.
  • operation contém o tipo e o código da operação que produziu o erro.
  • resource contém o local, o conjunto de dados e o armazenamento DICOM ou FHIR envolvidos no erro.

Se o número de erros exceder um limite, um número limitado de erros será exibido no Cloud Logging. O limite é calculado dinamicamente com base no tamanho da entrada.

Onde os registros são armazenados

O pacote de operações do Google Cloud não é um produto regionalizado. Os registros gravados no pacote de operações do Google Cloud podem ser armazenados em uma região diferente dos armazenamentos DICOM e FHIR.

Exemplo de entrada de registro de importação DICOM

A entrada de registro de amostra a seguir mostra um erro empty DICOM instance found que ocorreu ao tentar importar gs://DICOM_FILENAME.dcm para 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"

Exemplo de entrada de registro de importação FHIR

A entrada de registro de amostra a seguir mostra um erro cannot import resource que ocorreu ao tentar importar gs://FHIR_FILENAME.ndjson para 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"

Exemplo de entrada de registro de DICOM

A entrada de registro de amostra a seguir mostra um erro cannot de-identify dicom instance que ocorreu ao tentar desidentificar a instância DICOM INSTANCE_ID no conjunto de dados 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"

A seguir