S3 복제 지표 사용하기

S3 복제 지표는 복제 구성의 복제 규칙에 대한 상세 지표를 제공해요. 복제 지표를 사용하면 보류 중인 바이트, 보류 중인 작업, 복제에 실패한 작업, 복제 지연 시간을 추적해서 분 단위 진행 상황을 모니터링할 수 있어요.

참고: S3 복제 지표는 Amazon CloudWatch 사용자 지정 지표와 같은 요율로 청구돼요. 자세한 내용은 Amazon CloudWatch 요금을 참고하세요. S3 Replication Time Control을 사용한다면 해당 복제 규칙에서 S3 RTC를 활성화한 지 15분 후에 Amazon CloudWatch가 복제 지표 보고를 시작합니다.

S3 Replication Time Control(S3 RTC)을 활성화하면 S3 복제 지표도 자동으로 켜져요. 규칙을 만들거나 편집할 때 S3 RTC와 별개로 S3 복제 지표를 활성화할 수도 있어요. S3 RTC에는 서비스 수준 계약(SLA)과 임계값 미달 알림 같은 다른 기능도 포함됩니다. 자세한 내용은 S3 Replication Time Control로 규정 준수 요구 사항 충족 문서를 참고하세요.

S3 복제 지표가 활성화되면 Amazon S3는 다음 지표를 Amazon CloudWatch에 게시해요. CloudWatch 지표는 최선 노력(best-effort) 기준으로 전달됩니다.

지표 이름	지표 설명	이 지표가 적용되는 객체	이 지표가 게시되는 리전	대상 버킷이 삭제돼도 지표가 계속 게시되나요?	복제가 발생하지 않아도 지표가 계속 게시되나요?
Bytes Pending Replication	특정 복제 규칙에 대해 복제가 보류 중인 객체의 총 바이트 수	S3 Cross-Region Replication(S3 CRR) 또는 S3 Same-Region Replication(S3 SRR)으로 복제되는 새 객체에만 적용	대상 버킷의 리전에 게시	아니요	예
Replication Latency	특정 복제 규칙에 대해 복제 대상 버킷이 소스 버킷보다 밀려 있는 최대 초 수	S3 CRR 또는 S3 SRR로 복제되는 새 객체에만 적용	대상 버킷의 리전에 게시	아니요	예
Operations Pending Replication	특정 복제 규칙에 대해 복제가 보류 중인 작업 수. 객체, 삭제 마커, 태그, ACL, S3 Object Lock과 관련된 작업을 추적	S3 CRR 또는 S3 SRR로 복제되는 새 객체에만 적용	대상 버킷의 리전에 게시	아니요	예
Operations Failed Replication	특정 복제 규칙에 대해 복제에 실패한 작업 수. 객체, 삭제 마커, 태그, ACL, Object Lock과 관련된 작업을 추적	S3 CRR 또는 S3 SRR로 복제되는 새 객체와 S3 Batch Replication으로 복제되는 기존 객체 모두에 적용	소스 버킷의 리전에 게시	예	아니요

Operations Failed Replication은 분 단위 간격으로 집계된 S3 Replication 실패를 추적해요. 복제에 실패한 특정 객체와 실패 이유를 식별하려면 Amazon S3 Event Notifications에서 OperationFailedReplication 이벤트를 구독하세요. 자세한 내용은 Amazon S3 Event Notifications로 복제 실패 이벤트 받기 문서를 참고하세요.

참고: S3 Batch Replication 작업이 아예 실행되지 않으면 지표가 Amazon CloudWatch로 전송되지 않아요. 예를 들어 S3 Batch Replication 작업을 실행할 필요한 권한이 없거나 복제 구성의 태그나 접두사가 일치하지 않으면 작업이 실행되지 않습니다.

CloudWatch에서 이 지표를 사용하는 방법에 대한 자세한 내용은 CloudWatch의 S3 복제 지표 문서를 참고하세요.

출처: 문서

S3 복제 지표 활성화

S3 복제 지표는 새 복제 규칙이나 기존 복제 규칙에서 시작할 수 있어요. 복제 규칙을 만드는 전체 지침은 같은 계정의 버킷 복제 구성하기 문서를 참고하세요. 복제 규칙을 S3 버킷 전체에 적용하거나 특정 접두사·태그를 가진 Amazon S3 객체에 적용할 수 있어요.

이 문서에는 소스·대상 버킷이 같거나 다른 AWS 계정에 속할 때 복제 구성에서 S3 복제 지표를 활성화하는 지침이 있어요.

AWS Command Line Interface(AWS CLI)로 복제 지표를 활성화하려면 Metrics가 활성화된 상태로 소스 버킷에 복제 구성을 추가해야 해요. 다음 예시 구성에서는 Tax 접두사 아래에 있는 객체가 amzn-s3-demo-bucket 대상 버킷으로 복제되고 그 객체들에 대한 지표가 생성됩니다.

{
   "Rules": [
      {
         "Status": "Enabled",
         "Filter":{
            "Prefix": "Tax"
         },
         "Destination":{
            "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
            "Metrics":{
               "Status": "Enabled"
            }
         },
         "Priority": 1
      }
   ],
   "Role": "IAM-Role-ARN"
}

복제 지표 보기

S3 복제 지표는 Amazon S3 콘솔의 소스 일반 목적 버킷 지표(Metrics) 탭에서 볼 수 있어요. 이 Amazon CloudWatch 지표는 Amazon CloudWatch 콘솔에서도 사용할 수 있어요. S3 복제 지표를 활성화하면 Amazon CloudWatch가 복제 규칙 수준에서 보류 중인 바이트, 보류 중인 작업, 복제 지연 시간을 추적하는 데 쓸 수 있는 지표를 내보냅니다.

Amazon S3 콘솔이나 Amazon S3 REST API로 S3 Replication Time Control(S3 RTC)과 함께 복제를 활성화하면 S3 복제 지표도 자동으로 켜져요. 규칙을 만들거나 편집할 때 S3 RTC와 별개로 S3 복제 지표를 활성화할 수도 있어요.

S3 Replication Time Control을 사용한다면 해당 복제 규칙에서 S3 RTC를 활성화한 지 15분 후에 Amazon CloudWatch가 복제 지표 보고를 시작합니다. 자세한 내용은 S3 복제 지표 사용 문서를 참고하세요.

복제 지표는 복제 구성의 규칙 ID를 추적해요. 복제 규칙 ID는 접두사, 태그, 또는 둘의 조합에 특정할 수 있어요.

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

사전 요구 사항

S3 복제 지표가 활성화된 복제 규칙을 만들어요. 자세한 내용은 S3 복제 지표 활성화 문서를 참고하세요.

소스 버킷의 지표 탭으로 S3 복제 지표 보기

AWS Management Console에 로그인하고 Amazon S3 콘솔을 엽니다. (https://console.aws.amazon.com/s3/)
왼쪽 탐색 창에서 **일반 목적 버킷(General purpose buckets)**을 선택해요.
버킷 목록에서 복제 지표를 원하는 객체가 들어 있는 소스 버킷 이름을 선택해요.
지표(Metrics) 탭을 선택해요.
복제 지표(Replication metrics) 아래에서 지표를 보려는 복제 규칙을 선택해요.
**차트 표시(Display charts)**를 선택해요. Amazon S3는 선택한 규칙에 대해 복제 지연 시간(Replication latency), 복제 보류 바이트(Bytes pending replication), 복제 보류 작업(Operations pending replication), 복제 실패 작업(Operations failed replication) 차트를 표시해요.

S3 복제 지표 사용하기