S3 Storage Lens 내보내기 매니페스트란?

S3 Storage Lens 내보내기 매니페스트란?

범용 버킷의 S3 Storage Lens 일일 지표 내보내기는 집계된 데이터 양이 많아 여러 파일로 나뉠 수 있어요. 매니페스트 파일 manifest.json은 그날의 지표 내보내기 파일이 어디에 있는지 설명해요. 새 내보내기가 전달될 때마다 새 매니페스트가 함께 전달돼요. manifest.json 파일에 포함된 각 매니페스트는 내보내기에 대한 메타데이터와 기타 기본 정보를 제공해요.

출처: What is an S3 Storage Lens export manifest?

본문

매니페스트 정보에는 다음 속성이 포함돼요.

  • sourceAccountId – 구성 소유자의 계정 ID예요.
  • configId – 대시보드의 고유 식별자예요.
  • destinationBucket – 지표 내보내기가 배치되는 대상 버킷 Amazon 리소스 이름(ARN)이에요.
  • reportVersion – 내보내기의 버전이에요.
  • reportDate – 보고서의 날짜예요.
  • reportFormat – 보고서의 형식이에요.
  • reportSchema – 보고서의 스키마예요.
  • reportFiles – 대상 버킷에 있는 내보내기 보고서 파일의 실제 목록이에요.

매니페스트 대상 경로 예시:

user-defined-prefix/StorageLens/111122223333/example-dashboard-configuration-id/V_1/manifests/dt=2025-03-18/manifest.json

다음 예시는 CSV 형식의 Storage Lens 기본 지표 보고서용 manifest.json 파일을 보여줘요.

{  
   "sourceAccountId": "111122223333",  
   "configId": "example-dashboard-configuration-id",  
   "destinationBucket": "arn:aws:s3:::amzn-s3-demo-destination-bucket",  
   "reportVersion": "V_1",  
   "reportDate": "2025-07-15",  
   "reportFormat": "CSV",  
   "reportSchema": "version_number,configuration_id,report_date,aws_account_number,aws_region,storage_class,record_type,record_value,bucket_name,metric_name,metric_value",  
   "reportFiles": [  
        {  
            "key": "DestinationPrefix/StorageLens/111122223333/example-dashboard-configuration-id/V_1/reports/dt=2025-07-15/12345678-1234-1234-1234-123456789012.csv",  
            "size": 1603959,  
            "md5Checksum": "2177e775870def72b8d84febe1ad3574"  
        }  
   ]  
}

다음 예시는 CSV 형식의 Storage Lens 확장 프리픽스 지표 보고서용 manifest.json 파일을 보여줘요.

{  
   "sourceAccountId": "111122223333",  
   "configId": "example-dashboard-configuration-id",  
   "destinationBucket": "arn:aws:s3:::amzn-s3-demo-destination-bucket",   
   "reportVersion": "V_1",  
   "reportDate": "2025-11-03",  
   "reportFormat": "CSV",  
   "reportSchema": "version_number,configuration_id,report_date,aws_account_number,aws_region,storage_class,record_type,record_value,bucket_name,metric_name,metric_value",  
   "reportFiles": [  
        {  
            "key": "DestinationPrefix/StorageLensExpandedPrefixes/111122223333/example-dashboard-configuration-id/V_1/reports/dt=2025-11-03/EXAMPLE1234-56ab-78cd-90ef-EXAMPLE11111.csv",  
            "size": 1603959,  
            "md5Checksum": "2177e775870def72b8d84febe1ad3574"  
        }  
      ]  
}

다음 예시는 Parquet 형식의 Storage Lens 기본 지표 보고서용 manifest.json 파일을 보여줘요.

{  
   "sourceAccountId": "111122223333",  
   "configId": "example-dashboard-configuration-id",  
   "destinationBucket": "arn:aws:s3:::amzn-s3-demo-destination-bucket",  
   "reportVersion": "V_1",  
   "reportDate": "2025-11-03",  
   "reportFormat": "Parquet",  
   "reportSchema": "message s3.storage.lens { required string version_number; required string configuration_id; required string report_date; required string aws_account_number; required string aws_region; required string storage_class; required string record_type; required string record_value; required string bucket_name; required string metric_name; required long metric_value; }",  
   "reportFiles": [  
      {  
         "key": "DestinationPrefix/StorageLens/111122223333/example-dashboard-configuration-id/V_1/reports/dt=2025-11-03/bd23de7c-b46a-4cf4-bcc5-b21aac5be0f5.par",  
         "size": 14714,  
         "md5Checksum": "b5c741ee0251cd99b90b3e8eff50b944"  
      }  
   ]  
}

다음 예시는 Parquet 형식의 Storage Lens 확장 프리픽스 지표 보고서용 manifest.json 파일을 보여줘요.

{  
   "sourceAccountId": "111122223333",  
   "configId": "example-dashboard-configuration-id",  
   "destinationBucket": "arn:aws:s3:::amzn-s3-demo-destination-bucket",  
   "reportVersion": "V_1",  
   "reportDate": "2025-11-03",  
   "reportFormat": "Parquet",  
   "reportSchema": "message s3.storage.lens { required string version_number; required string configuration_id; required string report_date; required string aws_account_number; required string aws_region; required string storage_class; required string record_type; required string record_value; required string bucket_name; required string metric_name; required long metric_value; }",  
   "reportFiles": [  
      {  
         "key": "DestinationPrefix/StorageLensExpandedPrefixes/111122223333/example-dashboard-configuration-id/V_1/reports/dt=2025-11-03/bd23de7c-b46a-4cf4-bcc5-b21aac5be0f5.par",  
         "size": 14714,  
         "md5Checksum": "b5c741ee0251cd99b90b3e8eff50b944"  
      }  
   ]  
}

지표 내보내기를 대시보드 구성의 일부로 생성하도록 Amazon S3 콘솔이나 Amazon S3 REST API, AWS CLI, SDK로 구성할 수 있어요.

더 알아보기 (Learn more)