Usar el registro estructurado con registros de compilación
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
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 BuildOptionsenableStructuredLogging.
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.
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.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (UTC)."],[[["\u003cp\u003eCloud Build logs can be configured for structured logging, allowing JSON-formatted build log fields to be stored in \u003ccode\u003eLogEntry\u003c/code\u003e fields.\u003c/p\u003e\n"],["\u003cp\u003eEnabling structured logging involves setting the \u003ccode\u003eenableStructuredLogging\u003c/code\u003e field to \u003ccode\u003eTRUE\u003c/code\u003e in your \u003ccode\u003eBuildOptions\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSpecific build log fields like \u003ccode\u003emessage\u003c/code\u003e and \u003ccode\u003eseverity\u003c/code\u003e can be mapped to corresponding \u003ccode\u003eLogEntry\u003c/code\u003e fields, such as \u003ccode\u003etextPayload\u003c/code\u003e or \u003ccode\u003ejsonPayload.message\u003c/code\u003e, and \u003ccode\u003eseverity\u003c/code\u003e respectively.\u003c/p\u003e\n"],["\u003cp\u003eCertain build log fields, including \u003ccode\u003ehttpRequest\u003c/code\u003e and various \u003ccode\u003elogging.googleapis.com/\u003c/code\u003e fields, are dropped from the log entry if present, while all other fields are included in the \u003ccode\u003ejsonPayload\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Use structured logging with build logs\n\nThis document describes how you can configure your Cloud Build\nlogs for use with [structured logging](/logging/docs/structured-logging)\nin Cloud Logging.\n\nStructured logging lets you store a JSON-formatted build log field as part of\nthe `jsonPayload` field, or as certain other fields,\nin a [`LogEntry`](/logging/docs/reference/v2/rest/v2/LogEntry).\nYou can set up your build config file so that specific build log fields\nare mapped this way when you send a build log to Logging.\n\nFor example, if your build log contains a `message`, then the message appears\nin either `textPayload` or `jsonPayload.message` in the resulting\nlog entry. If a build log field can't be mapped to a specific log entry field,\nthen the build log field is stored as part of the log entry `jsonPayload`.\n\nMap build log fields to log entry fields\n----------------------------------------\n\nTo enable field mapping on your build logs, set the\n[`BuildOptions`](/build/docs/api/reference/rest/v1/projects.builds#buildoptions)\nfield `enableStructuredLogging` to `TRUE`.\n\nThe following table shows build log fields that map to a log entry field:\n\nThe following build log fields can't be mapped and will be dropped from the\nlog entry if they appear in a build log:\n\n- `httpRequest`\n- `logging.googleapis.com/insertId`\n- `logging.googleapis.com/labels`\n- `logging.googleapis.com/operation`\n- `logging.googleapis.com/sourceLocation`\n- `logging.googleapis.com/spanId`\n- `logging.googleapis.com/trace`\n- `logging.googleapis.com/trace_sampled`\n- `time`\n- `timestamp`\n- `timestampSeconds`\n- `timestampNanos`\n\nAll other build log fields will appear as part of the log entry's `jsonPayload`."]]
