# 디렉터리 버킷의 요청 지표 구성 방법
<a name="metrics-configurations-directory-buckets"></a>

디렉터리 버킷에 대한 요청 지표를 구성하여 S3 Express One Zone 스토리지의 운영 성능을 모니터링할 수 있습니다. 요청 지표는 1분 간격으로 제공되며, 이를 통해 운영상의 문제를 신속하게 파악하고 해결할 수 있습니다.

Amazon S3 콘솔, AWS Command Line Interface(AWS CLI) 또는 Amazon S3 REST API를 사용하여 디렉터리 버킷에 대한 요청 지표를 구성할 수 있습니다.

## S3 콘솔 사용
<a name="metrics-configuration-console-directory-buckets"></a>

Amazon S3 콘솔을 사용하여 디렉터리 버킷에 대한 요청 지표를 구성할 수 있습니다.

**디렉터리 버킷의 요청 지표 구성 방법**

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

1. 왼쪽 탐색 창에서 **디렉터리 버킷**을 선택합니다.

1. 버킷 목록에서 요청 지표가 필요한 객체가 있는 버킷 이름을 선택합니다.

1. **지표** 탭을 선택합니다.

1. **버킷 지표(Bucket metrics)**에서 **추가 차트 보기(Bucket metrics)**를 선택합니다.

1. **요청 지표** 탭을 선택합니다.

1. **필터 생성**을 선택합니다.

1. **필터 이름** 상자에 필터 이름을 입력합니다.

   이름은 문자, 숫자, 마침표, 대시 및 밑줄만 포함할 수 있습니다. 모든 객체에 적용되는 필터의 이름은 `EntireBucket`을 사용하는 것이 좋습니다.

1. **필터링 범위**에서 다음 중 하나를 선택합니다.
   + **이 필터는 버킷의 모든 객체에 적용됨** – 필터를 지정하지 않습니다.
   + **디렉터리 또는 액세스 포인트를 사용하여이 필터의 범위 제한** - 필터를 지정합니다. 범위를 제한하기 위해 디렉터리 또는 액세스 포인트별로 필터링할 수 있습니다.

   지표가 디렉터리 버킷의 객체 하위 세트에 대해서만 수집 및 보고되도록 필터를 정의할 수도 있습니다.

1. 필터 범위를 제한하도록 선택한 경우 필터 세부 정보를 지정합니다.
   + **디렉터리**를 기준으로 필터링하려면 디렉터리 이름을 입력합니다.
   + **액세스 포인트**별로 필터링하려면 액세스 포인트 ARN을 입력합니다.

1. **변경 사항 저장**을 선택합니다.

1. **요청 지표** 탭의 **필터**에서 방금 생성한 필터를 선택합니다.

   약 15분 후 CloudWatch에서 이러한 요청 지표를 추적하기 시작합니다. **요청 지표** 탭에서 지표를 확인할 수 있습니다. 지표에 대한 그래프는 Amazon S3 또는 CloudWatch 콘솔에서 볼 수 있습니다. 요청 지표는 표준 CloudWatch 요금으로 청구됩니다. 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing/)을 참조하십시오.

## AWS CLI 사용
<a name="metrics-configuration-cli-directory-buckets"></a>

AWS CLI를 사용하여 디렉터리 버킷에 대한 요청 지표를 구성할 수 있습니다.

1. AWS CLI를 설치 및 설정합니다. 자세한 내용은 *AWS Command Line Interface 사용 설명서*에서 [AWS CLI 설치, 업데이트 및 제거](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)를 참조하십시오.

1. 터미널을 엽니다.

1. 다음 명령을 실행하여 지표 구성을 추가합니다.

   ```
   aws s3api put-bucket-metrics-configuration --endpoint https://s3express-control.{{region-code}}.amazonaws.com --bucket {{directory-bucket-name}} --id {{metrics-config-id}} --metrics-configuration '{"Id":"{{metrics-config-id}}"}'
   ```

## REST API 사용
<a name="metrics-configuration-rest-directory-buckets"></a>

Amazon S3 REST API를 사용하여 디렉터리 버킷에 대한 요청 지표를 구성할 수 있습니다. 디렉터리 버킷과 함께 REST API를 사용하는 경우 S3 Express One Zone 엔드포인트를 `https://s3express-control.{{region-code}}.amazonaws.com` 형식의 리전별 제어 엔드포인트와 함께 사용해야 합니다.

REST API 작업에 대한 자세한 내용은 *Amazon S3 API 참조*의 다음 주제를 참조하세요.
+ [PUT 버킷 지표](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [GET 버킷 지표](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [DELETE 버킷 지표](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketDELETEMetricConfiguration.html)
+ [LIST 버킷 지표](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketListMetricConfigurations.html)