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.
- Desidentificação do DICOM
- Exportação DICOM
- Importação DICOM
- Desidentificação do conjunto de dados
- Desidentificação de FHIR
- Exportação de FHIR
- Importação de FHIR
- Exportação de HL7v2
- Importação de HL7v2
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:
No console do Google Cloud, acesse o navegador da API Cloud Healthcare.
Selecione um conjunto de dados.
Clique na guia Operações.
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:
Pesquise no Cloud Logging a operação que causou.
Usando os detalhes do registro da operação, execute novamente o comando específico.
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
- Analise as informações conceituais sobre a API Cloud Healthcare
- Analise as informações conceituais sobre o Cloud Logging