접두사, 객체 태그, 액세스 포인트로 필터링하는 지표 구성 만들기

Amazon S3용 Amazon CloudWatch 지표에는 스토리지 지표, 요청 지표, 복제 지표 세 종류가 있어요. 스토리지 지표는 하루에 한 번 보고되며 모든 고객에게 추가 비용 없이 제공돼요. 요청 지표는 약간의 처리 지연 후 1분 간격으로 확인할 수 있어요. 요청 지표는 표준 CloudWatch 요금으로 청구돼요. 요청 지표는 콘솔에서 구성하거나 Amazon S3 API를 사용해 명시적으로 선택해야 해요. S3 복제 지표는 복제 구성의 복제 규칙에 대한 상세 지표를 제공해요. 복제 지표를 사용하면 대기 중인 바이트, 대기 중인 작업, 복제 실패한 작업, 복제 지연 시간을 추적해 분 단위 진행 상황을 모니터링할 수 있어요.

출처: Creating a metrics configuration that filters by prefix, object tag, or access point

본문

Amazon S3용 CloudWatch 지표에 대한 자세한 내용은 Amazon CloudWatch로 지표 모니터링을 참고하세요.

CloudWatch 지표를 구성할 때 버킷 안의 모든 객체에 대한 필터를 만들거나, 단일 버킷 안의 관련 객체 그룹으로 구성을 필터링할 수 있어요. 다음 필터 유형 중 하나 이상을 기준으로 지표 구성에 포함할 버킷 객체를 필터링할 수 있어요.

객체 키 이름 접두사 – Amazon S3 데이터 모델은 평평한 구조지만 접두사를 사용해 계층 구조를 유추할 수 있어요. Amazon S3 콘솔은 폴더 개념으로 이러한 접두사를 지원해요. 접두사로 필터링하면 같은 접두사를 가진 객체가 지표 구성에 포함돼요. 접두사에 대한 자세한 내용은 접두사를 사용해 객체 구성하기를 참고하세요.
태그 – 객체에 키-값 이름 쌍인 태그를 추가할 수 있어요. 태그는 객체를 쉽게 찾고 구성하는 데 도움을 줘요. 태그를 지표 구성의 필터로도 사용할 수 있어요. 객체 태그에 대한 자세한 내용은 객체 태그 지정을 참고하세요.
액세스 포인트 – S3 액세스 포인트는 버킷에 연결된 이름 있는 네트워크 엔드포인트로, S3의 공유 데이터셋에 대한 대규모 데이터 액세스 관리를 단순화해요. 액세스 포인트 필터를 만들면 Amazon S3가 지정한 액세스 포인트에 대한 요청을 지표 구성에 포함해요. 자세한 내용은 액세스 포인트 모니터링 및 로깅을 참고하세요.

액세스 포인트로 필터링하는 지표 구성을 만들 때는 액세스 포인트 별칭(alias)이 아니라 액세스 포인트 Amazon 리소스 이름(ARN)을 사용해야 해요. 특정 객체의 ARN이 아니라 액세스 포인트 자체의 ARN을 사용하세요. 액세스 포인트 ARN에 대한 자세한 내용은 일반 목적 버킷용 Amazon S3 액세스 포인트 사용을 참고하세요.

필터를 지정하면 단일 객체에 대해 작동하는 요청만 필터와 일치해 보고된 지표에 포함될 수 있어요. DeleteObjects나 ListObjects 같은 요청은 필터가 있는 구성에 대해 어떤 지표도 반환하지 않아요.

더 복잡한 필터링을 원하면 두 개 이상의 요소를 선택하세요. 해당 요소를 모두 가진 객체만 지표 구성에 포함돼요. 필터를 설정하지 않으면 버킷 안의 모든 객체가 지표 구성에 포함돼요.

S3 콘솔로 구성하기

AWS Management Console에 로그인하고 Amazon S3 콘솔(https://console.aws.amazon.com/s3/)을 엽니다.
왼쪽 탐색 창에서 일반 목적 버킷(General purpose buckets) 을 선택합니다.
버킷 목록에서 요청 지표를 원하는 객체가 들어 있는 버킷 이름을 선택합니다.
지표(Metrics) 탭을 선택합니다.
버킷 지표(Bucket metrics) 아래에서 추가 차트 보기(View additional charts) 를 선택합니다.
요청 지표(Request metrics) 탭을 선택합니다.
필터 생성(Create filter) 을 선택합니다.
필터 이름(Filter name) 상자에 필터 이름을 입력합니다. 이름에는 문자, 숫자, 마침표, 대시, 밑줄만 포함할 수 있어요.
필터 범위(Filter scope) 아래에서 접두사, 객체 태그, S3 액세스 포인트 또는 셋 모두의 조합을 사용해 이 필터의 범위를 제한합니다를 선택합니다.
필터 유형(Filter type) 아래에서 접두사(Prefix), 객체 태그(Object tags), 액세스 포인트(Access Point) 중 하나 이상을 선택합니다.
- 접두사 필터를 정의해 필터 범위를 단일 경로로 제한하려면 접두사(Prefix) 상자에 접두사를 입력합니다.
- 객체 태그 필터를 정의하려면 객체 태그(Object tags) 아래에서 태그 추가(Add tag) 를 선택한 뒤 태그 키(Key) 와 값(Value) 을 입력합니다.
- 액세스 포인트 필터를 정의하려면 S3 액세스 포인트 필드에 액세스 포인트 ARN을 입력하거나, S3 찾아보기(Browse S3) 를 선택해 액세스 포인트로 이동합니다.
액세스 포인트 별칭은 입력할 수 없어요. 특정 객체의 ARN이 아니라 액세스 포인트 자체의 ARN을 입력해야 해요.
변경 사항 저장(Save changes) 을 선택합니다. Amazon S3가 지정한 접두사, 태그, 혹은 액세스 포인트를 사용하는 필터를 만들어요.
요청 지표(Request metrics) 탭의 필터(Filters) 아래에서 방금 만든 필터를 선택합니다.

이제 접두사, 객체 태그, 액세스 포인트로 요청 지표 범위를 제한하는 필터를 만든 거예요. CloudWatch가 이 요청 지표 추적을 시작한 지 약 15분 후부터 Amazon S3와 CloudWatch 콘솔 양쪽에서 지표 차트를 볼 수 있어요. 요청 지표는 표준 CloudWatch 요금으로 청구돼요. 자세한 내용은 Amazon CloudWatch 요금을 참고하세요.

버킷 수준에서도 요청 지표를 구성할 수 있어요. 자세한 내용은 버킷 안의 모든 객체에 대한 CloudWatch 지표 구성 만들기를 참고하세요.

AWS CLI로 구성하기

AWS CLI를 설치하고 설정합니다. 지침은 AWS Command Line Interface 사용 안내서의 AWS CLI 설치, 업데이트, 제거를 참고하세요.
터미널을 열고 다음 명령 중 하나를 실행해 지표 구성을 추가합니다.

예: 접두사로 필터링

aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration ' { "Id":" metrics-config-id ", "Filter": { "Prefix":" prefix1 "}} '

예: 태그로 필터링

aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration ' { "Id":" metrics-config-id ", "Filter": { "Tag": { "Key": " string ", "Value": " string "}} '

예: 액세스 포인트로 필터링

aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration ' { "Id":" metrics-config-id ", "Filter": { "AccessPointArn":"arn:aws:s3: Region : account-id :accesspoint/ access-point-name "}} '

예: 접두사, 태그, 액세스 포인트로 필터링

aws s3api put-bucket-metrics-configuration --endpoint https://s3. Region .amazonaws.com --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration ' { "Id": " metrics-config-id ",
    "Filter": { "And": { "Prefix": " string ",
            "Tags": [ { "Key": " string ",
                    "Value": " string "
                }
            ],
            "AccessPointArn": "arn:aws:s3: Region : account-id :accesspoint/ access-point-name "
        }
    }
}'

Amazon S3 REST API로 프로그래밍 방식으로도 지표 구성을 추가할 수 있어요. 지표 구성 추가·사용에 대한 자세한 내용은 Amazon Simple Storage Service API Reference의 PUT Bucket Metric Configuration, GET Bucket Metric Configuration, List Bucket Metric Configuration, DELETE Bucket Metric Configuration 주제를 참고하세요.

접두사, 객체 태그, 액세스 포인트로 필터링하는 지표 구성 만들기