Usar el registro estructurado con registros de compilación

En este documento se describe cómo puede configurar los registros de Cloud Build para usarlos con el registro estructurado en Cloud Logging.

El registro estructurado te permite almacenar un campo de registro de compilación con formato JSON como parte del campo jsonPayload o de otros campos concretos en un LogEntry. Puedes configurar tu archivo de configuración de compilación para que determinados campos de registro de compilación se asignen de esta forma cuando envíes un registro de compilación a Logging.

Por ejemplo, si tu registro de compilación contiene un message, el mensaje aparecerá en textPayload o jsonPayload.message en la entrada de registro resultante. Si un campo de registro de compilación no se puede asignar a un campo de entrada de registro específico, se almacenará como parte de la entrada de registro jsonPayload.

Asignar campos de registro de compilación a campos de entrada de registro

Para habilitar la asignación de campos en los registros de compilación, asigna el valor TRUE al campo BuildOptions enableStructuredLogging.

En la siguiente tabla se muestran los campos de registro de compilación que se asignan a un campo de entrada de registro:

Campo BuildLog (JSON) Campo LogEntry Descripción Notas
message textPayload o jsonPayload.message Te permite definir el mensaje de registro.

Debe ser una cadena.

Si el registro de compilación solo contiene campos asignables, el mensaje aparecerá en textPayload. De lo contrario, el mensaje aparecerá en jsonPayload.message.

Si el registro de compilación contiene varios pasos, el identificador del paso aparece al principio del mensaje.
severity severity Permite definir la gravedad del registro. Debe ser una enumeración de LogSeverity.

Los siguientes campos de registro de compilación no se pueden asignar y se eliminarán de la entrada de registro si aparecen en un registro de compilación:

  • httpRequest
  • logging.googleapis.com/insertId
  • logging.googleapis.com/labels
  • logging.googleapis.com/operation
  • logging.googleapis.com/sourceLocation
  • logging.googleapis.com/spanId
  • logging.googleapis.com/trace
  • logging.googleapis.com/trace_sampled
  • time
  • timestamp
  • timestampSeconds
  • timestampNanos

El resto de los campos del registro de compilación se mostrarán en el jsonPayload de la entrada de registro.