Usa el registro estructurado con registros de compilación

En este documento, se describe cómo puedes configurar tus 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 como otros campos en un LogEntry. Puedes configurar tu archivo de configuración de compilación para que los campos específicos del registro de compilación se asignen de esta manera cuando envíes un registro de compilación a Logging.

Por ejemplo, si el 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, el campo de registro de compilación se almacena como parte de la entrada de registro jsonPayload.

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

Para habilitar la asignación de campos en tus registros de compilación, establece el campo enableStructuredLogging de BuildOptions en TRUE.

En la siguiente tabla, se muestran los campos del 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 establecer 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 de pasos aparecerá al comienzo del mensaje.
severity severity Te permite establecer 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 quitará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

Todos los demás campos del registro de compilación aparecerán como parte del jsonPayload de la entrada de registro.