Storage Insights 데이터 세트 테이블 및 스키마

이 문서에서는 스토리지 통계 데이터 세트에 포함된 테이블과 스키마를 설명합니다. 이를 사용하여 운영 패턴을 분석하고, 리소스 사용량을 모니터링하고, 스토리지 환경 전반의 활동을 파악할 수 있습니다.

메타데이터의 데이터 세트 스키마

다음 섹션에서는 데이터 세트에 포함된 메타데이터 필드를 설명합니다. BigQuery 열 모드에 관한 자세한 내용은 모드를 참조하세요. 열 모드는 BigQuery가 데이터를 저장하고 쿼리하는 방식을 결정합니다.

버킷 메타데이터

버킷 메타데이터 스키마에는 bucket_attributes_view 및 bucket_attributes_latest_snapshot_view 테이블이 포함됩니다. 버킷 메타데이터 테이블에는 다음 필드가 있습니다.

메타데이터 필드 모드 유형 설명
snapshotTime NULLABLE TIMESTAMP snapshotTime 필드는 버킷 메타데이터 스냅샷 새로고침 시간을 RFC 3339 형식으로 저장합니다.
name NULLABLE STRING 버킷의 이름입니다.
location NULLABLE STRING 버킷의 위치입니다. 버킷에 있는 객체의 객체 데이터는 이 위치의 물리적 스토리지에 있습니다.
project NULLABLE INTEGER 버킷이 속한 프로젝트의 프로젝트 번호입니다.
storageClass NULLABLE STRING 버킷의 기본 스토리지 클래스입니다.
public NULLABLE RECORD 지원 중단되었습니다. 이 필드는 버킷에 공개적으로 액세스할 수 있는지 여부를 나타냅니다. 대신 iamConfiguration를 사용하세요.
public.bucketPolicyOnly NULLABLE BOOLEAN 지원 중단되었습니다. 이 필드(public 레코드의 일부)는 객체 수준 ACL을 통한 액세스를 방지하는 균일한 버킷 수준 액세스가 사용 설정되었는지 여부를 나타냅니다.
public.publicAccessPrevention NULLABLE STRING 지원 중단되었습니다. 이 필드(public 레코드의 일부)는 버킷에 대한 공개 액세스가 차단되었는지 여부를 나타냅니다.
autoclass NULLABLE RECORD 버킷의 자동 클래스 구성: 사용 설정된 경우 객체의 액세스 방식과 시점을 기반으로 객체의 스토리지 클래스를 제어합니다.
autoclass.enabled NULLABLE BOOLEAN 자동 클래스 사용 설정 여부입니다.
autoclass.toggleTime NULLABLE TIMESTAMP 이 버킷에 대해 자동 클래스가 마지막으로 사용 설정 또는 중지된 시간입니다(RFC 3339 형식).
versioning NULLABLE BOOLEAN 버킷에 버전 관리가 사용 설정되어 있는지 여부입니다. 자세한 내용은 객체 버전 관리를 참조하세요.
lifecycle NULLABLE BOOLEAN 버킷에 수명 주기 구성이 있는지 여부입니다. 자세한 내용은 수명 주기 관리를 참조하세요.
metageneration NULLABLE INTEGER 이 버킷의 메타데이터 생성입니다.
timeCreated NULLABLE TIMESTAMP 버킷 생성 시간입니다(RFC 3339 형식).
tags NULLABLE RECORD 지원 중단되었습니다. 이 필드에는 버킷과 연결된 사용자 정의 키-값 쌍이 포함됩니다. 대신 resourceTags를 사용하세요.
tags.lastUpdatedTime NULLABLE TIMESTAMP 지원 중단되었습니다. 이 필드는 tags가 마지막으로 업데이트된 시간을 나타냅니다.
tags.tagMap REPEATED RECORD 지원 중단되었습니다. 이 필드(tags 레코드의 일부)에는 태그 키와 값의 맵이 포함됩니다.
tags.tagMap.key NULLABLE STRING 지원 중단되었습니다. 이 필드(tags.tagMap 레코드의 일부)는 태그의 키를 나타냅니다.
tags.tagMap.value NULLABLE STRING 지원 중단되었습니다. 이 필드(tags.tagMap 레코드의 일부)는 태그의 값을 나타냅니다.
labels REPEATED RECORD 사용자가 제공한 버킷 라벨(키-값 쌍)입니다.
labels.key NULLABLE STRING 개별 라벨 항목입니다.
labels.value NULLABLE STRING 라벨의 값입니다.
softDeletePolicy NULLABLE RECORD 버킷의 소프트 삭제 정책: 삭제 후 버킷의 객체가 소프트 삭제된 상태로 유지되는 기간을 정의합니다. 소프트 삭제 상태의 객체는 영구 삭제할 수 없으며 hardDeleteTime까지 복원할 수 있습니다.
softDeletePolicy.effectiveTime NULLABLE DATETIME

소프트 삭제 정책이 적용되는 날짜/시간입니다(RFC 3339 형식).

softDeletePolicy.retentionDurationSeconds가 증가할 때마다 softDeletePolicy.effectiveTime이 업데이트됩니다.
softDeletePolicy.retentionDurationSeconds NULLABLE LONG 소프트 삭제된 객체가 보관되어 영구 삭제할 수 없는 기간(초)입니다. 값은 604800(7일) 이상, 7776000(90일) 미만이어야 합니다. 값을 0으로 설정하여 소프트 삭제 정책을 중지할 수도 있습니다.
iamConfiguration NULLABLE RECORD 버킷의 IAM 구성입니다.
iamConfiguration.uniformBucketLevelAccess NULLABLE RECORD 버킷의 균일한 버킷 수준 액세스 구성입니다.
iamConfiguration.uniformBucketLevelAccess.enabled NULLABLE BOOLEAN 버킷이 균일한 버킷 수준 액세스를 사용하는지 여부입니다.
iamConfiguration.publicAccessPrevention NULLABLE STRING 버킷의 공개 액세스 방지 상태입니다("inherited" 또는 "enforced").
resourceTags REPEATED RECORD 버킷의 태그입니다. 자세한 내용은 Cloud Resource Manager API를 참조하세요.
resourceTags.key NULLABLE STRING resourceTags 키
resourceTags.value NULLABLE STRING resourceTags 값입니다.

객체 메타데이터

객체 메타데이터 스키마에는 object_attributes_view 및 object_attributes_latest_snapshot_view 테이블이 포함됩니다. 객체 메타데이터 테이블에는 다음 필드가 있습니다.

메타데이터 필드 모드 유형 설명
snapshotTime NULLABLE TIMESTAMP snapshotTime 필드는 객체 메타데이터 스냅샷 새로고침 시간을 RFC 3339 형식으로 저장합니다.
bucket NULLABLE STRING 이 객체가 포함된 버킷의 이름입니다.
location NULLABLE STRING 버킷의 위치입니다. 버킷에 있는 객체의 객체 데이터는 이 위치의 물리적 스토리지에 있습니다.
componentCount NULLABLE INTEGER 복합 객체에만 대해서만 반환됩니다. 복합 객체에 있는 비복합 객체의 수입니다. componentCount에는 현재 객체를 구성하는 데 사용된 복합 객체의 일부였던 비복합 객체가 포함됩니다.
contentDisposition NULLABLE STRING 객체 데이터의 Content-Disposition입니다.
contentEncoding NULLABLE STRING 객체 데이터의 Content-Encoding입니다.
contentLanguage NULLABLE STRING 객체 데이터의 Content-Language입니다.
contentType NULLABLE STRING 객체 데이터의 Content-Type입니다.
crc32c NULLABLE INTEGER RFC 4960 부록 B의 설명대로 CRC32c 체크섬은 big-endian 바이트 순서로 base64를 사용하여 인코딩됩니다.
customTime NULLABLE TIMESTAMP 객체에 대해 사용자가 지정한 타임스탬프입니다(RFC 3339 형식).
etag NULLABLE STRING 객체의 HTTP 1.1 항목 태그입니다.
eventBasedHold NULLABLE BOOLEAN 객체에 이벤트 기반 보존 조치가 적용되는지 여부입니다.
generation NULLABLE INTEGER 이 객체의 콘텐츠 세대입니다.
md5Hash NULLABLE STRING base64를 사용하여 인코딩된 데이터의 MD5 해시입니다. 복합 객체에는 이 필드가 없습니다.
metadata REPEATED RECORD 키-값 쌍으로 된 사용자 제공 메타데이터입니다.
metadata.key NULLABLE STRING 개별 메타데이터 항목입니다.
metadata.value NULLABLE STRING 메타데이터 값입니다.
metageneration NULLABLE INTEGER 이 세대의 이 객체에 대한 메타데이터 버전입니다.
name NULLABLE STRING 객체 이름입니다.
size NULLABLE INTEGER 데이터 Content-Length입니다(바이트).
storageClass NULLABLE STRING 객체의 스토리지 클래스입니다.
temporaryHold NULLABLE BOOLEAN 객체에 임시 보존이 적용되는지 여부입니다.
timeCreated NULLABLE TIMESTAMP RFC 3339 형식의 객체 생성 시간입니다.
timeDeleted NULLABLE TIMESTAMP RFC 3339 형식의 객체 삭제 시간입니다.
updated NULLABLE TIMESTAMP 객체 메타데이터의 수정 시간입니다(RFC 3339 형식).
timeStorageClassUpdated NULLABLE TIMESTAMP 객체의 스토리지 클래스가 마지막으로 변경된 시간입니다.
retentionExpirationTime NULLABLE TIMESTAMP 객체를 삭제할 수 있는 가장 이른 시간이며 객체에 설정된 보관 구성 및 객체가 포함된 버킷에 설정된 보관 정책에 따라 달라집니다. retentionExpirationTime 값은 RFC 3339 형식으로 제공됩니다.
softDeleteTime NULLABLE DATETIME 객체가 소프트 삭제된 시간입니다. 소프트 삭제 정책이 있는 버킷의 객체에만 사용할 수 있습니다.
hardDeleteTime NULLABLE DATETIME 소프트 삭제된 객체가 영구적으로 삭제된 시간으로, 더 이상 복원할 수 없습니다. 값은 버킷의 softDeleteTime 값과 softDeletePolicy.retentionDurationSeconds 값의 합계입니다. 소프트 삭제 정책이 있는 버킷의 객체에만 사용할 수 있습니다.
project NULLABLE INTEGER 버킷이 속한 프로젝트의 프로젝트 번호입니다.

최신 버킷 및 객체 메타데이터 스냅샷

연결된 데이터 세트는 다음 전용 뷰를 통해 버킷 및 객체 메타데이터의 최신 스냅샷을 노출합니다.

  • bucket_attributes_latest_snapshot_view 표는 Cloud Storage 버킷의 최신 메타데이터를 제공합니다. 구조가 버킷 메타데이터 스키마와 일치합니다.

  • object_attributes_latest_snapshot_view 테이블은 Cloud Storage 객체의 최신 메타데이터를 제공합니다. 구조가 객체 메타데이터 스키마와 일치합니다.

프로젝트 메타데이터

연결된 데이터 세트는 프로젝트 메타데이터를 project_attributes_view라는 뷰로 노출합니다.

메타데이터 필드 모드 유형 설명
snapshotTime NULLABLE TIMESTAMP snapshotTime 필드는 프로젝트 메타데이터 스냅샷 새로고침 시간을 RFC 3339 형식으로 저장합니다.
name NULLABLE STRING 프로젝트 이름입니다.
id NULLABLE STRING 프로젝트의 고유 식별자입니다.
number NULLABLE INTEGER 프로젝트에 연결된 숫자 값입니다.

활동 데이터 테이블의 데이터 세트 스키마

스토리지 통계 데이터 세트는 다양한 분석 요구사항을 지원하기 위해 맞춤설정 가능한 범위가 포함된 운영 측정항목, 오류 로그, 집계된 뷰를 비롯한 활동 데이터를 제공합니다. 다음 섹션에서는 활동 데이터 스키마와 스키마에서 사용할 수 있는 데이터를 설명합니다.

객체 활동 데이터

스토리지 인사이트 데이터 세트의 object_events_view 테이블은 객체 작업, 메타데이터, 이러한 작업 중에 발생한 오류에 관한 세부정보를 생성, 업데이트, 삭제하는 쿼리 가능한 레코드를 제공합니다. 이 데이터를 사용하여 object_events_view 뷰를 쿼리하여 스토리지 애셋의 변경사항을 추적하고 문제를 해결할 수 있습니다. object_events_view 뷰의 데이터는 Storage Intelligence 구독으로 범위가 지정되며, 이 구독 내에서 활성 상태로 사용 설정된 모든 객체가 나열됩니다.

object_events_view 테이블에는 다음 필드가 포함됩니다.

필드 모드 유형 설명
requestCompletionTimestamp NULLABLE TIMESTAMP 요청이 완료된 타임스탬프입니다(RFC 3339 형식).
project NULLABLE INTEGER 버킷 리소스를 소유한 프로젝트 번호입니다.
bucketName NULLABLE STRING 요청에 지정된 버킷의 이름입니다.
objectName NULLABLE STRING 요청에 지정된 객체의 이름입니다. 이 필드는 null일 수 있습니다.
requestOperation NULLABLE STRING 실행된 Cloud Storage 작업입니다. 이 필드는 쓰기, 업데이트, 삭제 작업으로 제한되며 null일 수 있습니다.
requestBytes NULLABLE INTEGER 요청에서 전송한 바이트 수입니다.
responseBytes NULLABLE INTEGER 응답에서 전송한 바이트 수입니다.
requestProcessingTimeMicros NULLABLE INTEGER 서버가 요청을 처리하는 데 걸린 시간(마이크로초)입니다. 이 시간은 첫 번째 바이트가 수신된 시점부터 응답이 전송될 때까지 측정됩니다. 재개 가능한 업로드의 경우 최종 업로드 요청에 대한 응답이 엔드포인트를 결정합니다.
requestId NULLABLE STRING 요청의 식별자입니다.
requestHost NULLABLE STRING 원래 요청에 지정된 호스트입니다.
requestHttpMethod NULLABLE STRING 이 요청에 사용된 HTTP 메서드입니다.
responseStatus NULLABLE INTEGER 서버의 응답에서 전송된 HTTP 상태 코드입니다.
requestReferrer NULLABLE STRING 요청의 HTTP 리퍼러입니다.
size NULLABLE INTEGER 객체 크기(바이트).
generation NULLABLE INTEGER 객체 버전 관리에 사용되는 객체의 콘텐츠 생성입니다.
timeCreated NULLABLE TIMESTAMP 객체의 생성 시간입니다(RFC 3339 형식).
storageClass NULLABLE STRING 객체의 스토리지 클래스입니다.
errorReason NULLABLE STRING 오류의 이유입니다 (429 오류로 제한됨).
location NULLABLE STRING 객체의 위치입니다.

프로젝트 활동 보기

project_activity_view 표는 프로젝트 전반의 집계된 운영 인사이트를 제공합니다. 표에는 작업 유형, 전송된 바이트, 응답 코드 및 오류를 집계하여 총 활동이 요약되어 있습니다. 프로젝트 활동 통계를 사용하여 모니터링, 추적, 내부 비용 기여 분석을 할 수 있습니다. 보기의 데이터는 Storage Intelligence 구독 범위에 따라 결정됩니다. 이 뷰에는 구독에서 활성 상태로 사용 설정된 버킷 및 객체에 대한 집계 데이터만 표시됩니다. 예를 들어 특정 버킷 10개에 대해서만 Storage Intelligence를 사용 설정하면 뷰에 해당 버킷 10개의 데이터만 표시됩니다. 반대로 상위 수준 (조직, 폴더 또는 프로젝트)에서 스토리지 인텔리전스를 사용 설정하면 해당 범위 내의 모든 버킷과 객체가 자동으로 포함되며 뷰에 집계된 데이터가 표시됩니다.

project_activity_view 테이블에는 다음 필드가 포함됩니다.

필드 모드 유형 설명
snapshotStartTime NULLABLE TIMESTAMP 스냅샷의 시작 시간입니다(RFC 3339 형식).
snapshotEndTime NULLABLE TIMESTAMP 스냅샷의 종료 시간입니다(RFC 3339 형식).
project NULLABLE INTEGER 프로젝트 번호입니다.
totalRequests NULLABLE INTEGER 프로젝트 전체에서 이루어진 총 요청 수입니다.
totalReads NULLABLE INTEGER 총 읽기 작업 수입니다.
totalWrites NULLABLE INTEGER 총 쓰기 작업 수입니다.
totalUpdates NULLABLE INTEGER 총 업데이트 작업 수입니다.
totalDeletes NULLABLE INTEGER 총 삭제 작업 수입니다.
totalLists NULLABLE INTEGER 총 목록 작업 수입니다.
totalRequestBytes NULLABLE INTEGER 전송된 요청 바이트의 총수입니다.
totalResponseBytes NULLABLE INTEGER 전송된 총 응답 바이트 수입니다.
count4xx NULLABLE INTEGER 총 4xx 오류 수입니다.
count5xx NULLABLE INTEGER 총 5xx 오류 수입니다.
count2xx NULLABLE INTEGER 2xx 성공 응답의 총수입니다.
count400 NULLABLE INTEGER 잘못된 요청에 대한 총 400 오류 수입니다.
count401 NULLABLE INTEGER 승인되지 않은 요청의 총 401 오류 수입니다.
count403 NULLABLE INTEGER 금지된 요청에 대한 403 오류의 총수입니다.
count429 NULLABLE INTEGER 사용량 한도 초과 요청에 대한 429 오류의 총수입니다.

버킷 활동 보기

bucket_activity_view 표는 버킷 전반의 집계된 운영 통계를 제공합니다. 표에는 작업 유형, 전송된 바이트, 응답 코드, 오류를 집계한 총 활동이 요약되어 있으며 상위 접두사에 관한 세부정보가 포함되어 있습니다. 버킷 활동 통계를 사용하여 버킷 수준 모니터링, 문제 해결, 측정, 가장 활성 상태인 버킷과 가장 비활성 상태인 버킷을 분석할 수 있습니다. bucket_activity_view 표의 데이터는 스토리지 인텔리전스 구독으로 범위가 지정되며 활성 상태로 사용 설정된 모든 버킷의 레코드를 포함합니다.

bucket_activity_view 테이블에는 다음 필드가 포함됩니다.

필드 모드 유형 설명
snapshotStartTime NULLABLE TIMESTAMP 스냅샷의 시작 시간입니다(RFC 3339 형식).
snapshotEndTime NULLABLE TIMESTAMP 스냅샷의 종료 시간입니다(RFC 3339 형식).
name NULLABLE STRING 버킷의 이름입니다.
generation NULLABLE INTEGER 버킷의 세대 번호입니다.
project NULLABLE INTEGER 프로젝트 번호입니다.
location NULLABLE STRING 버킷의 위치입니다.
totalRequests NULLABLE INTEGER 버킷에 대한 총 요청 수입니다.
totalReads NULLABLE INTEGER 총 읽기 작업 수입니다.
totalWrites NULLABLE INTEGER 총 쓰기 작업 수입니다.
totalUpdates NULLABLE INTEGER 총 업데이트 작업 수입니다.
totalDeletes NULLABLE INTEGER 총 삭제 작업 수입니다.
totalLists NULLABLE INTEGER 총 목록 작업 수입니다.
totalRequestBytes NULLABLE INTEGER 전송된 요청 바이트의 총수입니다.
totalResponseBytes NULLABLE INTEGER 전송된 총 응답 바이트 수입니다.
count4xx NULLABLE INTEGER 총 4xx 오류 수입니다.
count5xx NULLABLE INTEGER 총 5xx 오류 수입니다.
count2xx NULLABLE INTEGER 2xx 성공 응답의 총수입니다.
count400 NULLABLE INTEGER 잘못된 요청에 대한 총 400 오류 수입니다.
count401 NULLABLE INTEGER 승인되지 않은 요청의 총 401 오류 수입니다.
count403 NULLABLE INTEGER 금지된 요청에 대한 403 오류의 총수입니다.
count429 NULLABLE INTEGER 사용량 한도 초과 요청에 대한 429 오류의 총수입니다.
topPrefixes429Errors REPEATED RECORD 429 오류가 가장 많은 상위 5개 버킷 접두사입니다. 접두사를 STRING로, 오류 수를 INTEGER로 포함하는 RECORD로 반환됩니다.
topPrefixesRequestBytes REPEATED RECORD 요청된 바이트 수가 가장 많은 상위 5개 버킷 접두사입니다. 접두사는 STRING로, 개수는 INTEGER로 포함된 RECORD로 반환됩니다.
topPrefixesResponseBytes REPEATED RECORD 응답 바이트 수가 가장 많은 상위 5개 버킷 접두사입니다. 접두사를 STRING로, 개수를 INTEGER로 포함하는 RECORD로 반환됩니다.
topPrefixesHighestOperations REPEATED RECORD 작업 수가 가장 많은 상위 5개 버킷 접두사입니다. 접두사를 STRING로, 개수를 INTEGER로 포함하는 RECORD로 반환됩니다.

버킷 리전 활동 보기

bucket_region_activity_view 표에는 버킷에 대해 전송되고 수신된 총 바이트가 대상 리전별로 집계되어 요약되어 있습니다. 버킷 활동 지역 데이터를 사용하여 가장 활성 상태인 지역을 파악하면 최적의 버킷 위치를 결정하고, 지역 이그레스를 분석하고, 필요에 따라 버킷 재배치를 고려하여 성능, 비용 또는 복원력을 최적화할 수 있습니다. bucket_region_activity_view 표의 데이터는 스토리지 인텔리전스 구독으로 범위가 지정되며 활성 상태로 사용 설정된 모든 버킷의 레코드를 포함합니다.

필드 모드 유형 설명
snapshotStartTime NULLABLE TIMESTAMP 스냅샷의 시작 시간입니다(RFC 3339 형식).
snapshotEndTime NULLABLE TIMESTAMP 스냅샷의 종료 시간입니다(RFC 3339 형식).
project NULLABLE INTEGER 버킷의 프로젝트 번호입니다.
name NULLABLE STRING 버킷의 이름입니다.
generation NULLABLE INTEGER 버킷의 세대 번호입니다.
requestLocation NULLABLE STRING 요청이 시작된 Google Cloud 위치입니다.
bucketLocation NULLABLE STRING 버킷의 위치입니다.
requestBytes NULLABLE INTEGER 지정된 버킷과 위치 간 요청에 대해 전송된 총 바이트 수입니다.
responseBytes NULLABLE INTEGER 지정된 버킷과 위치 간에 전송된 응답의 총 바이트 수입니다.

이벤트 및 오류의 데이터 세트 스키마

연결된 데이터 세트에서는 events_view 및 error_attributes_view 뷰를 통해 스냅샷 처리 이벤트 및 오류를 확인할 수 있습니다. 스냅샷 처리 오류를 해결하려면 데이터 세트 오류 문제 해결을 참고하세요.

이벤트 로그

연결된 데이터 세트의 events_view 뷰에서 이벤트 로그를 확인할 수 있습니다.

메타데이터 필드 모드 유형 설명
manifest.snapshotTime NULLABLE TIMESTAMP 이벤트 스냅샷이 새로고침되는 시간입니다(RFC 3339 형식).
manifest.viewName NULLABLE STRING 새로고침되는 뷰의 이름입니다.
manifest.location NULLABLE STRING 새로고침되는 데이터의 소스 위치입니다.
globalManifest.snapshotTime NULLABLE TIMESTAMP 모든 소스 위치의 버킷 및 객체 속성 테이블에 대한 수집 완료 시간입니다(RFC 3339 형식).
eventTime NULLABLE TIMESTAMP 이벤트가 발생한 시간입니다.
eventCode NULLABLE STRING 해당 항목과 연결된 이벤트 코드입니다. eventCode 값은 다음과 같습니다.
  • eventCode 1은 스냅샷 (manifest.snapshotTime) 내 소스 위치 (manifest.location)의 모든 항목으로 새로고침되는 manifest.viewName 뷰를 나타냅니다.
  • eventCode 2는 모든 소스 위치의 버킷 및 객체 항목으로 데이터 세트가 새로고침됨을 나타냅니다. 새로고침은 스냅샷 (globalManifest.snapshotTime) 내에서 발생합니다.
  • eventCode 3은 로그 창 내 소스 위치 (manifest.location)의 모든 항목으로 새로고침되는 활동 데이터 뷰를 나타냅니다.

오류 코드

연결된 데이터 세트의 error_attributes_view 표에서 오류 코드를 확인할 수 있습니다.

메타데이터 필드 모드 유형 설명
errorCode NULLABLE INTEGER 이 항목과 연결된 오류 코드입니다. 유효한 값 목록과 이러한 오류를 해결하는 방법은 데이터 세트 오류 문제 해결을 참고하세요.
errorSource NULLABLE STRING 오류의 소스입니다. 유효한 값: CONFIGURATION_PREPROCESSING
errorTime NULLABLE TIMESTAMP 오류가 발생한 시간입니다.
sourceGcsLocation NULLABLE STRING 오류의 소스 Cloud Storage 위치입니다. 프로젝트의 경우 프로젝트는 위치와 연결되어 있지 않으므로 이 필드는 null입니다.
bucketErrorRecord.bucketName NULLABLE STRING 오류와 관련된 버킷의 이름입니다. 이 정보를 사용하여 버킷 오류를 디버그할 수 있습니다.
bucketErrorRecord.serviceAccount NULLABLE STRING 버킷에서 객체를 수집할 권한이 필요한 서비스 계정입니다. 이 정보를 사용하여 버킷 오류를 디버그할 수 있습니다.
projectErrorRecord.projectNumber NULLABLE INTEGER 오류가 발생한 프로젝트 번호입니다. 이 정보를 사용하여 프로젝트 오류를 디버그할 수 있습니다.
projectErrorRecord.organizationName NULLABLE STRING 프로젝트가 처리되기 위해 속해 있어야 하는 조직의 이름입니다. 0 값은 프로젝트가 조직에 없음을 나타냅니다. 이 정보를 사용하여 프로젝트 오류를 디버그할 수 있습니다.

데이터 세트 오류 문제 해결

연결된 데이터 세트의 error_attributes_view 뷰에 로깅되는 스냅샷 처리 오류를 해결하려면 다음 표를 참고하세요.

오류 코드 오류 사례 오류 메시지 문제 해결
1 소스 프로젝트가 조직에 속하지 않습니다. 소스 프로젝트 projectErrorRecord.projectNumber가 조직 projectErrorRecord.organizationName에 속하지 않습니다. 소스 프로젝트 projectErrorRecord.projectNumber를 조직 projectErrorRecord.organizationName에 추가합니다. 조직 간에 프로젝트를 마이그레이션하는 방법에 관한 안내는 조직 간에 프로젝트 마이그레이션을 참고하세요.
2 버킷 승인 오류 bucketErrorRecord.bucketName 버킷의 객체 수집 권한이 거부되었습니다. 서비스 계정 bucketErrorRecord.serviceAccount에 bucketErrorRecord.bucketName 버킷의 객체 수집을 허용하는 Identity and Access Management(IAM) 권한을 부여합니다. 자세한 내용은 서비스 에이전트에 필요한 권한 부여를 참조하세요.
3 대상 프로젝트가 조직에 속하지 않습니다. 대상 프로젝트 projectErrorRecord.projectNumber가 조직 projectErrorRecord.organizationName에 없습니다. 대상 프로젝트 projectErrorRecord.projectNumber를 조직 projectErrorRecord.organizationName에 추가합니다. 조직 간에 프로젝트를 마이그레이션하는 방법에 관한 안내는 조직 간에 프로젝트 마이그레이션을 참고하세요.
4 소스 프로젝트에 Storage Intelligence가 구성되어 있지 않습니다. 소스 프로젝트 projectErrorRecord.projectNumber에 Storage Intelligence가 구성되어 있지 않습니다. 소스 프로젝트 projectErrorRecord.projectNumber에 Storage Intelligence를 구성합니다. 자세한 내용은 Storage Intelligence 구성 및 관리를 참조하세요.
5 버킷에 Storage Intelligence가 구성되어 있지 않습니다. 버킷 bucketErrorRecord.bucketName에 Storage Intelligence가 구성되어 있지 않습니다. bucketErrorRecord.bucketName 버킷에 Storage Intelligence를 구성합니다. 자세한 내용은 Storage Intelligence 구성 및 관리를 참조하세요.
6 버킷 액세스 인증 오류 버킷 bucketErrorRecord.bucketName의 ACTIVITY_BUCKET_ACCESS_AUTHORIZATION_ERROR 서비스 계정 bucketErrorRecord.serviceAccount에 bucketErrorRecord.bucketName 버킷의 활동 수집을 허용하는 Identity and Access Management (IAM) 권한을 부여합니다. 자세한 내용은 서비스 에이전트에 필요한 권한 부여를 참조하세요.

다음 단계