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.