Amazon S3 Storage Lens 대시보드 업데이트

Amazon S3 Storage Lens 기본 대시보드는 default-account-dashboard예요. 이 대시보드는 콘솔에서 전체 계정의 집계된 무료 및 고급 지표에 대한 요약 인사이트와 추세를 시각화할 수 있도록 Amazon S3가 미리 구성한 것이에요. 기본 대시보드의 구성 범위는 수정할 수 없지만, 지표 선택을 무료 지표에서 유료 고급 지표 및 권장사항으로 업그레이드하고, 선택적인 지표 내보내기를 구성하거나, 기본 대시보드를 비활성화할 수 있어요. 기본 대시보드는 삭제할 수 없고 비활성화만 할 수 있어요. 자세한 내용은 S3 콘솔 사용을 참고하세요.

출처: Update an Amazon S3 Storage Lens dashboard

본문

다음 단계를 사용해 Amazon S3 콘솔에서 Amazon S3 Storage Lens 대시보드를 업데이트해요.

1단계: 대시보드 업데이트 및 일반 설정 구성

AWS Management Console에 로그인하고 Amazon S3 콘솔(https://console.aws.amazon.com/s3/)을 엽니다.
왼쪽 탐색 창에서 Storage Lens, 대시보드(Dashboards) 를 선택합니다.
편집할 대시보드를 선택합니다.
대시보드 구성 보기(View dashboard configuration) 를 선택합니다.
편집(Edit) 을 선택합니다. 이제 대시보드 구성을 단계별로 검토할 수 있어요. 단계를 변경하려면 왼쪽 탐색을 사용해 해당 단계를 직접 선택할 수 있어요. 그 단계를 업데이트하는 방법은 해당 단계의 지침을 참고하세요.

다음은 변경할 수 없어요.

대시보드 이름

홈 리전

대시보드(Dashboard) 페이지의 일반(General) 섹션에서 다음을 변경할 수 있습니다.
- 활성화됨(Enabled) 또는 비활성화됨(Disabled) 을 선택해 대시보드에서 일일 지표를 받고 있는지 여부를 업데이트합니다.
- (선택) 대시보드에 태그(Tags) 를 추가할 수 있습니다. 태그를 사용해 대시보드에 대한 권한을 관리하고 S3 Storage Lens 비용을 추적할 수 있어요. 자세한 내용은 IAM 사용 안내서의 태그를 사용한 AWS 리소스 액세스 제어와 AWS Billing 사용 안내서의 AWS 생성 태그 사용을 참고하세요.
대시보드 구성에 최대 50개의 태그를 추가할 수 있어요.
- 다음(Next) 을 선택해 변경 사항을 저장하고 진행합니다.

2단계: 대시보드 범위 업데이트

대시보드 범위(Dashboard scope) 섹션에서 대시보드에 S3 Storage Lens가 포함하거나 제외할 리전과 버킷을 업데이트합니다. 선택한 리전에서 S3 Storage Lens가 포함하거나 제외할 버킷을 선택합니다. 버킷을 포함하거나 제외할 수 있지만 둘 다는 할 수 없어요. 이 옵션은 조직 수준 대시보드를 만들 때는 사용할 수 없어요.

리전과 버킷을 포함하거나 제외할 수 있어요. 조직의 멤버 계정을 가로질러 조직 수준 대시보드를 만들 때 이 옵션은 리전에만 국한돼요.

포함하거나 제외할 버킷을 최대 50개 선택할 수 있어요. 다음(Next) 을 선택해 변경 사항을 저장하고 진행합니다.

3단계: Storage Lens 티어 업데이트

Storage Lens 티어(Storage Lens tier) > 지표 선택(Metrics selection) 섹션에서 이 대시보드에 대해 집계할 지표 티어를 업데이트합니다.

무료 티어(Free tier) 에서 고급 티어(Advanced tier) 로 업데이트한다면 지표 집계(Metrics aggregation) 설정을 업데이트해야 해요. 지표 집계 설정을 업데이트하려면 4단계: 지표 집계 업데이트를 참고하세요. Storage Lens 티어를 고급 티어 에서 무료 티어 로 업데이트한다면 지표 집계 설정을 업데이트할 필요가 없어요. 지표 집계 기능은 고급 티어 지표 카테고리에만 적용돼요.

버킷 수준에서 집계되고 14일 동안 쿼리할 수 있는 무료 지표를 포함하려면 무료 티어(Free tier) 를 선택합니다.
고급 지표를 활성화하려면 고급 티어(Advanced tier) 를 선택합니다. 이 옵션에는 접두사 집계, Amazon CloudWatch 게시, 상황별 권장사항이 포함돼요. 데이터는 15개월 동안 쿼리할 수 있어요. 고급 지표와 권장사항은 추가 비용이 들어요. 자세한 내용은 Amazon S3 요금을 참고하세요. 고급 지표와 무료 지표에 대한 자세한 내용은 지표 선택을 참고하세요.

고급 지표 카테고리(Advanced metric categories) 아래에서 활성화할 지표 카테고리를 선택합니다.

활동 지표(Activity metrics)
상세 상태 코드 지표(Detailed status code metrics)
비용 최적화 지표(Cost optimization metrics)
데이터 보호 지표(Data protection metrics)
성능 지표(Performance metrics)

각 카테고리에 포함된 지표를 미리 보려면 지표 카테고리 체크박스 목록 아래의 드롭다운 화살표 버튼을 사용하세요. 지표 카테고리에 대한 자세한 내용은 지표 카테고리를 참고하세요. 전체 지표 목록은 Amazon S3 Storage Lens 지표 용어집을 참고하세요.

각 접두사 내의 수준을 구분할 접두사 구분자(Prefix delimiter) 를 선택하거나 지정합니다. 이 값은 각 접두사 수준을 식별하는 데 사용돼요. Amazon S3의 기본값은 "/" 문자이지만, 스토리지 구조가 다른 구분자 문자를 사용할 수도 있어요. 다음(Next) 을 선택해 변경 사항을 저장하고 진행합니다.

4단계: (선택) 지표 집계 업데이트

추가 지표 집계(Additional metrics aggregation) 아래에서 다음 중 하나를 선택해 집계할 지표를 업데이트합니다.

접두사 집계(Prefix aggregation)
Storage Lens 그룹 집계(Storage Lens group aggregation)

접두사 집계(Prefix aggregation) 를 활성화했다면 대시보드의 최소 접두사 임계값(Prefix threshold) 과 접두사 깊이(Prefix depth) 를 지정합니다. 그런 다음 다음(Next) 을 선택해 저장하고 진행합니다.

Storage Lens 그룹 집계(Storage Lens group aggregation) 를 활성화했다면 다음 중 하나를 선택합니다.

Storage Lens 그룹 포함(Include Storage Lens groups)
Storage Lens 그룹 제외(Exclude Storage Lens groups)

집계에 Storage Lens 그룹을 포함할 때는 홈 리전의 모든 Storage Lens 그룹 포함(Include all Storage Lens groups in your home Region) 을 선택하거나 포함할 Storage Lens 그룹을 지정할 수 있어요. 다음(Next) 을 선택해 변경 사항을 저장하고 진행합니다.

5단계: (선택) 지표 내보내기 및 게시 설정 업데이트

지표 게시(Metrics publishing) 아래에서 CloudWatch 대시보드에서 Storage Lens 지표에 액세스하려면 CloudWatch 게시(CloudWatch publishing) 를 선택합니다.

접두사 수준 지표는 CloudWatch에서 사용할 수 없어요.

지표 내보내기(Metrics export) 아래에서 매일 내보낼 Storage Lens 대시보드 데이터를 선택합니다.

기본 지표 보고서(Default metrics report)
확장 접두사 지표 보고서(Expanded prefixes metrics report)

기본 지표 보고서(Default metrics report) 를 선택했다면 기본 지표 보고서 설정에서 버킷 유형을 선택합니다. 보고서를 일반 목적 S3 버킷이나 읽기 전용 S3 테이블 버킷으로 내보낼 수 있어요. 선택한 버킷 유형에 따라 일반 목적 버킷 대상(General purpose bucket destination) 설정이나 테이블 버킷 대상(Table bucket destination) 설정 옵션을 업데이트합니다.

기본 지표 보고서는 접두사 집계 설정에서 설정된 임계값과 깊이 안의 접두사만 포함해요. 접두사 집계가 아직 구성되지 않았다면, 임계값은 크기 기준 상위 100개 접두사까지 포함해요.

암호화 키를 지정하기로 선택하면 AWS KMS 키(SSE-KMS)나 Amazon S3 관리형 키(SSE-S3)를 선택해야 해요. 대상 버킷 정책이 암호화를 요구하면 지표 내보내기에 암호화 키를 제공해야 해요. 암호화 키가 없으면 S3로의 내보내기가 실패해요. 자세한 내용은 AWS KMS 키를 사용한 지표 내보내기 암호화를 참고하세요. 다음(Next) 을 선택해 변경 사항을 저장하고 진행합니다.

확장 접두사 지표 보고서(Expanded prefixes metrics report) 를 선택했다면 확장 접두사 지표 보고서 설정에서 버킷 유형을 선택합니다. 보고서를 일반 목적 S3 버킷이나 읽기 전용 S3 테이블 버킷으로 내보낼 수 있어요. 선택한 버킷 유형에 따라 일반 목적 버킷 대상(General purpose bucket destination) 설정이나 테이블 버킷 대상(Table bucket destination) 설정을 업데이트합니다.

확장 접두사 지표 보고서는 대시보드 범위에 지정된 모든 버킷의 접두사를 포함해요.

6단계: 대시보드 구성 검토 및 업데이트

일반(General) 섹션에서 설정을 검토합니다. 변경하려면 편집(Edit) 을 선택합니다.
대시보드 범위(Dashboard scope) 섹션에서 설정을 검토합니다. 변경하려면 편집(Edit) 을 선택합니다.
Storage Lens 티어(Storage Lens tier) 섹션에서 설정을 검토합니다. 변경하려면 편집(Edit) 을 선택합니다.
지표 집계(Metrics aggregation) 섹션에서 설정을 검토합니다. 변경하려면 편집(Edit) 을 선택합니다.
지표 내보내기(Metrics export) 섹션에서 설정을 검토합니다. 변경하려면 편집(Edit) 을 선택합니다.

모든 대시보드 구성 설정을 검토하고 확인한 뒤 제출(Submit) 을 선택해 대시보드를 업데이트합니다. 업데이트된 Storage Lens 대시보드를 성공적으로 업데이트했다면 Storage Lens 대시보드(Dashboard) 페이지 목록에서 업데이트된 대시보드 구성을 볼 수 있어요.

예제

다음 예제 명령은 Amazon S3 Storage Lens 대시보드 구성을 업데이트해요. 이 예제를 사용하려면 사용자 입력 자리 표시자를 자신의 정보로 교체하세요.

aws s3control put-storage-lens-configuration --account-id= 111122223333 --config-id= example-dashboard-configuration-id --region= us-east-1 --storage-lens-configuration= file://./config.json --tags= file://./tags.json

예제: 고급 지표와 권장사항으로 Amazon S3 Storage Lens 구성 업데이트 – 다음 예제는 SDK for Java에서 기본 S3 Storage Lens 구성을 고급 지표와 권장사항으로 업데이트하는 방법을 보여줘요.

package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.ActivityMetrics;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.Format;
import com.amazonaws.services.s3control.model.Include;
import com.amazonaws.services.s3control.model.OutputSchemaVersion;
import com.amazonaws.services.s3control.model.PrefixLevel;
import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.S3BucketDestination;
import com.amazonaws.services.s3control.model.SSES3;
import com.amazonaws.services.s3control.model.SelectionCriteria;
import com.amazonaws.services.s3control.model.StorageLensAwsOrg;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensDataExport;
import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions. US_WEST_2 ;

public class UpdateDefaultConfigWithPaidFeatures {
    public static void main(String[] args) {
        String configurationId = "default-account-dashboard"; // This configuration ID cannot be modified.
        String sourceAccountId = " 111122223333 ";

        try {
            SelectionCriteria selectionCriteria = new SelectionCriteria()
                    .withDelimiter(" / ")
                    .withMaxDepth( 5 )
                    .withMinStorageBytesPercentage( 10.0 );
            PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics()
                    .withIsEnabled( true )
                    .withSelectionCriteria(selectionCriteria);
            BucketLevel bucketLevel = new BucketLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled( true ))
                    .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
            AccountLevel accountLevel = new AccountLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled( true ))
                    .withBucketLevel(bucketLevel);

            StorageLensConfiguration configuration = new StorageLensConfiguration()
                    .withId(configurationId)
                    .withAccountLevel(accountLevel)
                    .withIsEnabled( true );

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion( US_WEST_2 )
                    .build();

            s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withStorageLensConfiguration(configuration)
            );

        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}

S3 Storage Lens 그룹이나 확장 접두사에 액세스하려면 대시보드를 고급 티어를 사용하도록 업그레이드해야 해요. 추가 요금이 적용돼요. 무료 티어와 고급 티어에 대한 자세한 내용은 지표 선택을 참고하세요. S3 Storage Lens 그룹에 대한 자세한 내용은 S3 Storage Lens 그룹으로 필터링하고 지표 집계를 참고하세요.

Amazon S3 Storage Lens 대시보드 업데이트