Use o registo estruturado com registos de compilação

Este documento descreve como pode configurar os registos do Cloud Build para utilização com o registo estruturado no Cloud Logging.

O registo estruturado permite-lhe armazenar um campo de registo de compilação formatado em JSON como parte do campo jsonPayload ou como determinados outros campos num LogEntry. Pode configurar o ficheiro de configuração de compilação para que campos de registo de compilação específicos sejam mapeados desta forma quando envia um registo de compilação para o Logging.

Por exemplo, se o registo de compilação contiver um message, a mensagem aparece em textPayload ou jsonPayload.message na entrada de registo resultante. Se não for possível mapear um campo de registo de compilação para um campo de entrada de registo específico, o campo de registo de compilação é armazenado como parte da entrada de registo jsonPayload.

Mapeie campos do registo de compilação para campos de entrada do registo

Para ativar o mapeamento de campos nos registos de compilação, defina o campo BuildOptions enableStructuredLogging como TRUE.

A tabela seguinte mostra os campos do registo de compilação que são mapeados para um campo de entrada do registo:

Campo BuildLog (JSON) Campo LogEntry Descrição Notas
message textPayload ou jsonPayload.message Permite-lhe definir a mensagem de registo

Tem de ser uma string.

Se o registo de compilação contiver apenas campos mapeáveis, a mensagem é apresentada em textPayload. Caso contrário, a mensagem é apresentada em jsonPayload.message.

Se o registo de compilação contiver vários passos, o identificador do passo aparece no início da mensagem.
severity severity Permite definir a gravidade do registo. Tem de ser uma enumeração de LogSeverity.

Os seguintes campos do registo de compilação não podem ser mapeados e são removidos da entrada do registo se aparecerem num registo de compilação:

  • 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 os outros campos do registo de compilação aparecem como parte do jsonPayload da entrada do registo.