Como visualizar registros de erros no Cloud Logging

Nesta página, explicamos como acessar registros na observabilidade do Google Cloud para tipos de solicitação.

Geração de registros

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.

Como ver registros

Para conferir todos os registros, acesse a Análise de registros.

Para ver registros de operações com status de erro, siga estas etapas:

  1. No console do Google Cloud, acesse o navegador da API Cloud Healthcare.

    Acessar o navegador da API Cloud Healthcare

  2. Selecione um conjunto de dados.

  3. Clique na guia Operações.

  4. Na lista de operações, selecione Ver detalhes no Cloud Logging na lista Ações para conferir os detalhes de uma operação incorreta.

Como filtrar registros

É possível filtrar os registros por tipo de repositório de dados, 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 a Análise de registros, consulte Como usar a Análise de 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 de dados 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

A observabilidade do Google Cloud não é um produto regionalizado. Os registros gravados na Observabilidade do Google Cloud podem ser armazenados em uma região diferente dos repositórios de dados.

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"

Amostra de entrada de registro de importação de anotação

A entrada de registro de amostra a seguir mostra um erro failed to parse Cloud Storage object que ocorreu ao tentar importar gs://ANNOTATION_FILE.json para 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"

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