

# Amazon S3 Storage Lens 대시보드 업데이트
<a name="storage_lens_editing"></a>

 Amazon S3 Storage Lens 기본 대시보드는 `default-account-dashboard`입니다. 이 대시보드는 Amazon S3에서 사전 구성되어, 사용자가 콘솔에서 전체 계정의 집계된 무료 및 고급 지표에 대해 요약된 인사이트와 추세를 시각화하도록 도와줍니다. 기본 대시보드의 구성 범위는 수정할 수 없지만, 무료 지표에서 유료 고급 지표 및 권장 사항으로 지표 선택을 업그레이드하거나 선택적 지표 내보내기를 구성하거나 심지어는 기본 대시보드를 비활성화할 수는 있습니다. 기본 대시보드는 삭제할 수 없으며 비활성화할 수만 있습니다. 자세한 내용은 [S3 콘솔 사용](storage_lens_console_deleting.md) 섹션을 참조하세요.

## S3 콘솔 사용
<a name="storage_lens_console_editing"></a>

Amazon S3 콘솔에서 Amazon S3 스토리지 렌즈 대시보드를 업데이트하려면 다음 단계를 따르십시오.

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

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)에서 S3 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **스토리지 렌즈, Dashboards**(스토리지 렌즈, 대시보드)를 선택합니다.

1. 편집하려는 대시보드를 선택합니다.

1. **대시보드 구성 보기**를 선택합니다.

1. **편집**을 선택합니다. 이제 대시보드 구성을 단계별로 검토할 수 있습니다. 단계를 변경하려면 왼쪽 탐색을 사용하여 단계를 직접 클릭하면 됩니다. 이러한 단계를 업데이트하는 방법에 대한 지침은 다음을 참조하세요.
**참고**  
다음 항목은 변경할 수 없습니다.  
대시보드 이름
홈 리전

1. **대시보드** 페이지의 **일반** 섹션에서 다음을 변경합니다.
   + **활성화됨** 또는 **비활성화됨**을 선택하여 대시보드에서 일일 지표를 수신하는지 여부를 업데이트합니다.
   + (선택 사항) 대시보드에 **태그**를 추가하도록 선택할 수 있습니다. 태그를 사용하여 대시보드에 대한 권한을 관리하고 S3 스토리지 렌즈에 대한 비용을 추적할 수 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [태그를 사용한 AWS 리소스 액세스 제어](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) 및 *AWS Billing 사용 설명서*의 [AWS에서 생성된 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html)을 참조하세요.
**참고**  
대시보드 구성에 최대 50개의 태그를 추가할 수 있습니다.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

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

1. **대시보드 범위** 섹션에서 S3 Storage Lens가 대시보드에 포함하거나 제외할 리전과 버킷을 업데이트합니다.
**참고**  
리전과 버킷을 포함하거나 제외할 수 있습니다. 이 옵션은 조직의 구성원 계정에서 조직 수준의 대시보드를 생성할 때만 리전으로 제한됩니다.
포함하거나 제외할 버킷을 최대 50개까지 선택할 수 있습니다.

1. S3 스토리지 렌즈에 포함하거나 제외하도록 사용자가 선택한 리전에서 버킷을 선택합니다. 버킷을 포함하거나 제외할 수 있지만, 둘 다 할 수는 없습니다. 조직 수준의 대시보드를 생성할 때는 이 옵션을 사용할 수 없습니다.
**참고**  
리전과 버킷을 포함하거나 제외할 수 있습니다. 이 옵션은 조직의 구성원 계정에서 조직 수준의 대시보드를 생성할 때만 리전으로 제한됩니다.
포함하거나 제외할 버킷을 최대 50개까지 선택할 수 있습니다.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

**3단계: Storage Lens 티어 업데이트 지표 선택 구성**

1. **Storage Lens 티어** **지표 선택** 섹션에서 이 대시보드에 대해 집계할 지표 티어를 업데이트합니다.
**참고**  
**프리 티어**에서 **고급 티어**로 업데이트하는 경우 **지표 집계** 설정을 업데이트해야 합니다. **지표 집계 설정**을 업데이트하려면 **4단계: 지표 집계 업데이트**를 참조하세요.
Storage Lens 티어를 **고급 티어**에서 **프리 티어**로 업데이트하는 경우 **지표 집계** 설정을 업데이트할 필요가 없습니다. **지표 집계** 기능은 **고급 계층** 지표 범주에만 적용됩니다.

1. 버킷 수준에서 집계되고 14일 동안 쿼리에 사용할 수 있는 무료 지표를 포함하려면 **무료 티어**를 선택합니다.

1. 고급 지표를 활성화하려면 **고급 티어**를 선택합니다. 이러한 옵션에는 접두사 집계, Amazon CloudWatch 게시 및 상황별 권장 사항이 포함됩니다. 데이터는 15개월 동안 쿼리에 사용할 수 있습니다. 고급 지표 및 권장 사항에는 추가 비용이 부과됩니다. 자세한 내용은 [Amazon S3 요금](https://aws.amazon.com/s3/pricing/)을 참조하십시오.

   고급 지표 및 무료 지표에 대한 자세한 내용은 [지표 선택](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection) 섹션을 참조하십시오.

1. **고급 지표 범주**에서 활성화하려는 지표 범주를 선택합니다.
   + **활동 지표**
   + **세부 상태 코드 지표**
   + **비용 최적화 지표**
   + **데이터 보호 지표**
   + **성능 지표**

   각 범주에 포함되는 지표를 미리 보려면 지표 범주 확인란 목록 아래의 드롭다운 화살표 버튼을 사용합니다. 비용 범주에 관한 자세한 내용은 [지표 범주](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types) 섹션을 참조하십시오. 전체 지표 목록은 [Amazon S3 스토리지 렌즈 지표 용어집](storage_lens_metrics_glossary.md) 섹션을 참조하세요.

1. **접두사 구분 기호**를 선택하거나 지정하여 각 접두사 내의 수준을 구분합니다. 이 값은 각 접두사 수준을 식별하는 데 사용되는 값입니다. Amazon S3의 기본값은 ‘`/`‘ 문자이지만, 사용자 스토리지 구조에서 다른 구분 기호를 사용할 수 있습니다.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

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

1. **추가 지표 집계**에서 다음 중 하나를 선택하여 집계하려는 지표를 업데이트합니다.
   + 접두사 집계(Prefix aggregation)
   + Storage Lens 그룹 집계

1. **접두사 집계**를 활성화한 경우 대시보드의 최소 **접두사 임계값**과 **접두사 깊이**를 지정합니다. 그런 뒤에 **다음**을 선택하여 저장하고 계속합니다.

1. **Storage Lens 그룹 집계**를 활성화한 경우 다음 중 하나를 선택합니다.
   + **Storage Lens 그룹 포함**
   + **Storage Lens 그룹 제외**

1. 집계에 Storage Lens 그룹을 포함하는 경우 **홈 리전에 모든 Storage Lens 그룹을 포함**하거나 포함할 Storage Lens 그룹을 지정할 수 있습니다.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

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

1. CloudWatch 대시보드에서 Storage Lens지표에 액세스하려면 **지표 게시**에서 **CloudWatch 게시**를 선택합니다.
**참고**  
CloudWatch에서는 접두사 수준 지표를 사용할 수 없습니다.

1. **지표 내보내기**에서 매일 내보낼 Storage Lens 대시보드 데이터를 선택합니다.
   + **기본 지표 보고서**
   + **확장된 접두사 지표 보고서**

1. (선택 사항) **기본 지표 보고서**를 선택한 경우 **기본 지표 보고서** 설정에서 버킷 유형을 선택합니다. 보고서를 범용 S3 버킷 또는 읽기 전용 S3 테이블 버킷으로 내보낼 수 있습니다. 선택한 버킷 유형에 따라 **범용 버킷 대상 설정** 또는 **테이블 버킷 대상 설정** 옵션을 업데이트합니다.
**참고**  
**기본 지표 보고서**에는 접두사 집계 설정에서 설정된 임계값 및 깊이 내에 있는 접두사만 포함됩니다. 접두사 집계가 아직 구성되지 않은 경우 임계값에는 최대 100개의 가장 큰 접두사가 크기별로 포함됩니다.
암호화 키 지정을 선택한 경우, AWS KMS 키(SSE-KMS) 또는 Amazon S3 관리형 키(SSE-S3) 중 하나를 선택해야 합니다. 대상 버킷 정책에 암호화가 필요한 경우 지표 내보내기를 위한 암호화 키를 제공해야 합니다. 암호화 키가 없으면 S3로 내보내기가 실패합니다. 자세한 내용은 [AWS KMS key를 사용하여 지표 내보내기 암호화](storage_lens_encrypt_permissions.md) 섹션을 참조하세요.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

1. (선택 사항) **확장된 접두사 지표 보고서**를 선택한 경우 **확장된 접두사 지표 보고서** 설정에서 버킷 유형을 선택합니다. 보고서를 범용 S3 버킷 또는 읽기 전용 S3 테이블 버킷으로 내보낼 수 있습니다. 선택한 버킷 유형에 따라 **범용 버킷 대상 설정** 또는 **테이블 버킷 대상 설정**을 업데이트합니다.
**참고**  
**확장된 접두사 지표 보고서**에는 대시보드 범위에 지정된 모든 버킷의 접두사가 포함됩니다.
암호화 키 지정을 선택한 경우, AWS KMS 키(SSE-KMS) 또는 Amazon S3 관리형 키(SSE-S3) 중 하나를 선택해야 합니다. 대상 버킷 정책에 암호화가 필요한 경우 지표 내보내기를 위한 암호화 키를 제공해야 합니다. 암호화 키가 없으면 S3로 내보내기가 실패합니다. 자세한 내용은 [AWS KMS key를 사용하여 지표 내보내기 암호화](storage_lens_encrypt_permissions.md) 섹션을 참조하세요.

1. **다음**을 선택하여 변경 사항을 저장하고 계속합니다.

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

1. **일반** 섹션에서 설정을 검토합니다. 변경하려면 **편집**을 선택합니다.

1. **대시보드 범위** 섹션에서 설정을 검토합니다. 변경하려면 **편집**을 선택합니다.

1. **Storage Lens 티어** 섹션에서 설정을 검토합니다. 변경하려면 **편집**을 선택합니다.

1. **지표 집계** 섹션에서 설정을 검토합니다. 변경하려면 **편집**을 선택합니다.

1. **지표 내보내기** 섹션에서 설정을 검토합니다. 변경하려면 **편집**을 선택합니다.

1. 모든 대시보드 구성 설정을 검토하고 확인한 후 **제출**을 선택하여 대시보드를 업데이트합니다.

새 Storage Lens 대시보드를 성공적으로 업데이트한 후에는 Storage Lens **대시보드** 페이지에 나열된 업데이트된 대시보드 구성을 볼 수 있습니다.

## AWS CLI 사용
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
다음 예제 명령에서는 Amazon S3 Storage Lens 대시보드 구성을 업데이트합니다. 이러한 예제를 사용하려면 `user input placeholders`를 실제 정보로 대체하세요.  

```
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
```

## Java용 AWS SDK 사용
<a name="S3UpdateStorageLensConfigurationAdvancedJava"></a>

**Example – 고급 지표 및 권장 사항으로 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 그룹 또는 확장된 접두사에 액세스하려면 고급 티어를 사용하도록 대시보드를 업그레이드해야 합니다. 추가 요금이 발생합니다. 무료 및 고급 티어에 대한 자세한 정보는 [지표 선택](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection) 섹션을 참조하세요. S3 스토리지 렌즈 사용에 대한 자세한 내용은 [S3 Storage Lens 그룹을 사용하여 지표 필터링 및 집계](storage-lens-groups-overview.md) 섹션을 참조하십시오.