빌드 로그와 함께 구조화된 로깅 사용

이 문서에서는 Cloud Logging의 구조화된 로깅과 함께 사용할 수 있도록 Cloud Build 로그를 구성하는 방법을 설명합니다.

구조화된 로깅을 사용하면 JSON 형식의 빌드 로그 필드를 jsonPayload 필드의 일부로 저장하거나 LogEntry의 다른 특정 필드로 저장할 수 있습니다. 빌드 로그를 Logging으로 전송할 때 특정 빌드 로그 필드가 이런 방식으로 매핑되도록 빌드 구성 파일을 설정할 수 있습니다.

예를 들어 빌드 로그에 message가 포함된 경우 결과 로그 항목의 textPayload 또는 jsonPayload.message에 메시지가 표시됩니다. 빌드 로그 필드를 특정 로그 항목 필드에 매핑할 수 없는 경우 빌드 로그 필드는 로그 항목 jsonPayload의 일부로 저장됩니다.

빌드 로그 필드를 로그 항목 필드에 매핑

빌드 로그에서 필드 매핑을 사용 설정하려면 BuildOptions 필드 enableStructuredLogging를 TRUE로 설정합니다.

다음 표에는 로그 항목 필드에 매핑되는 빌드 로그 필드가 나와 있습니다.

BuildLog 필드 (JSON) LogEntry 필드 설명 참고
message textPayload 또는 jsonPayload.message 로그 메시지를 설정할 수 있습니다.

문자열이어야 합니다.

빌드 로그에 매핑 가능한 필드만 포함된 경우 메시지가 textPayload에 표시됩니다. 그렇지 않으면 jsonPayload.message에 메시지가 표시됩니다.

빌드 로그에 여러 단계가 포함된 경우 단계 식별자가 메시지 시작 부분에 표시됩니다.
severity severity 로그 심각도를 설정할 수 있습니다. LogSeverity의 enum이어야 합니다.

다음 빌드 로그 필드는 매핑할 수 없으며 빌드 로그에 표시되는 경우 로그 항목에서 삭제됩니다.

  • 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

다른 모든 빌드 로그 필드는 로그 항목의 jsonPayload에 포함되어 표시됩니다.