Ver registros de errores en Cloud Logging

En esta página se explica cómo ver los registros de Google Cloud Observability para los tipos de solicitudes admitidos.

Almacenamiento de registros

Los errores que se activen en cada una de las siguientes solicitudes se registrarán en Cloud Logging.

También se registran errores si no se puede publicar un mensaje de Pub/Sub en Pub/Sub. Para obtener más información, consulta Solucionar problemas con las notificaciones de Pub/Sub.

El registro es automático y no es necesario habilitarlo. Para inhabilitar Cloud Logging en uno o todos los recursos monitorizados, consulta Exclusiones de registros.

Ver registros

Para ver todos los registros, ve a Explorador de registros.

Para ver los registros de las operaciones con el estado de error, siga estos pasos:

  1. En la Google Cloud consola, ve al navegador de la API Cloud Healthcare.

    Ir al navegador de la API de Cloud Healthcare

  2. Selecciona un conjunto de datos.

  3. Haga clic en la pestaña Operaciones.

  4. En la lista de operaciones, elija Ver detalles en Cloud Logging en la lista Acciones para ver los detalles de una operación errónea.

Filtrar registros

Puede filtrar los registros por tipo de almacén de datos, región y conjunto de datos.

Por ejemplo, para ver los registros de los almacenes FHIR, haga clic en Almacén FHIR de Healthcare en la primera lista de Filtrar por etiqueta o buscar texto. También puedes buscar por tipo de recurso. Por ejemplo, si buscas healthcare_dicom_store, se mostrarán todos los registros generados para las operaciones en las que resource.type se haya definido como healthcare_dicom_store.

La codificación UTF-8 se aplica a los campos de registro. Los caracteres que no son UTF-8 se sustituyen por signos de interrogación.

Para obtener información detallada sobre el Explorador de registros, consulta el artículo Usar el Explorador de registros.

Usar Cloud Logging para buscar eventos de error

También puedes usar Cloud Logging para encontrar el registro de auditoría de un evento que provoque un error. Para encontrar un evento de error en los registros de auditoría, sigue estos pasos:

  1. Busca en Cloud Logging la operación que ha provocado el error.

  2. Con los detalles del registro de la operación, vuelve a ejecutar el comando específico.

  3. Consulta los registros de auditoría del evento correspondiente. Para obtener más información sobre los registros de auditoría, consulta el artículo Ver registros de auditoría de Cloud.

Qué se registra

Las entradas de registro de la API Cloud Healthcare contienen los siguientes tipos de información para depurar solicitudes:

  • Información general, como la gravedad, el ID del proyecto, el número del proyecto y la marca de tiempo.
  • jsonPayload contiene el cuerpo de la entrada. Este campo contiene el código de error, el mensaje de error y el nombre del archivo de origen cuya importación ha provocado el error.
  • operation contiene el tipo y el ID de la operación que ha producido el error.
  • resource contiene la ubicación, el conjunto de datos y el almacén de datos implicados en el error.

Si el número de errores supera un umbral, aparecerá un número limitado de errores en Cloud Logging. El umbral se calcula de forma dinámica en función del tamaño de la entrada.

Dónde se almacenan los registros

Google Cloud Observability no es un producto regionalizado. Los registros escritos en Google Cloud Observability se pueden almacenar en una región diferente a la de los almacenes de datos.

Entrada de registro de importación de DICOM de ejemplo

La siguiente entrada de registro de ejemplo muestra un error empty DICOM instance found que se ha producido al intentar importar gs://DICOM_FILENAME.dcm a 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"

Entrada de registro de importación de FHIR de ejemplo

La siguiente entrada de registro de ejemplo muestra un error cannot import resource que se ha producido al intentar importar gs://FHIR_FILENAME.ndjson a 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"

Entrada de registro de desidentificación de DICOM de ejemplo

La siguiente entrada de registro de ejemplo muestra un error cannot de-identify dicom instance que se ha producido al intentar desidentificar la instancia DICOM INSTANCE_ID en el conjunto de datos 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"

Siguientes pasos