# S3 복제 지표 사용
<a name="repl-metrics"></a>

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

**참고**  
S3 복제 지표는 Amazon CloudWatch 사용자 지정 지표와 동일한 요금으로 청구됩니다. 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing/)을 참조하세요.
S3 Replication Time Control을 사용하는 경우 Amazon CloudWatch는 각 복제 규칙에서 S3 RTC를 활성화한 후 15분이 지나면 복제 지표 보고를 시작합니다.

S3 Replication Time Control(S3 RTC)을 활성화하면 S3 복제 지표가 자동으로 설정됩니다. [규칙을 만들거나 편집](replication-walkthrough1.md)하는 동안 S3 RTC와 독립적으로 S3 복제 지표를 활성화할 수도 있습니다. S3 RTC에는 SLA(서비스 수준 계약) 및 누락된 임계값에 대한 알림 같은 기타 기능이 포함되어 있습니다. 자세한 내용은 [S3 Replication Time Control을 사용하여 규정 준수 요구 사항 충족](replication-time-control.md) 섹션을 참조하세요.

S3 복제 지표가 활성화되면 Amazon S3는 다음 지표를 Amazon CloudWatch에 게시합니다. CloudWatch 지표를 전송하고자 최선을 다할 것입니다.


| 지표 이름 | 지표 설명 | 이 지표는 어떤 객체에 적용되나요? | 이 지표는 어느 리전에 게시되나요? | 대상 버킷이 삭제된 경우에도 지표가 계속 게시되나요? | 복제가 이루어지지 않는 경우에도 지표가 계속 게시되나요? | 
| --- | --- | --- | --- | --- | --- | 
| **복제 보류 중인 바이트** | 지정된 복제 규칙에 대해 복제 보류 중인 객체의 총 바이트 수입니다. | 이 지표는 S3 Cross-Region Replication(S3 CRR) 또는 S3 Same-Region Replication(S3 SRR)으로 복제되는 새 객체에만 적용됩니다. | 이 지표는 대상 버킷의 리전에 게시됩니다. | 아니요 | 예 | 
| **복제 지연 시간** | 지정된 복제 규칙에 대해 복제 대상 버킷이 소스 버킷보다 늦어지는 최대 시간(초)입니다. | 이 지표는 S3 CRR 또는 S3 SRR로 복제된 새 객체에만 적용됩니다. | 이 지표는 대상 버킷의 리전에 게시됩니다. | 아니요 | 예 | 
| **복제 보류 중인 작업** | 지정된 복제 규칙에 대해 복제 보류 중인 작업 수입니다. 이 지표는 객체, 삭제 마커, 태그, 액세스 제어 목록(ACL), S3 객체 잠금과 관련된 작업을 추적합니다. | 이 지표는 S3 CRR 또는 S3 SRR로 복제된 새 객체에만 적용됩니다. | 이 지표는 대상 버킷의 리전에 게시됩니다. | 아니요 | 예 | 
| **복제 실패 작업** | 지정된 복제 규칙에 대해 복제에 실패한 작업 수입니다. 이 지표는 객체, 삭제 마커, 태그, 액세스 제어 목록(ACL), Object Lock과 관련된 작업을 추적합니다.<br />**복제 실패 작업**은 분 간격으로 집계된 S3 복제 실패를 추적합니다. 복제에 실패한 특정 객체와 실패 이유를 파악하려면 Amazon S3 이벤트 알림에서 `OperationFailedReplication` 이벤트를 구독하세요. 자세한 내용은 [Amazon S3 이벤트 알림을 사용하여 복제 실패 이벤트 수신](replication-metrics-events.md) 섹션을 참조하세요. | 이 지표는 S3 CRR 또는 S3 SRR로 복제된 새 객체와 S3 배치 복제를 통해 복제된 기존 객체를 모두 추적합니다. S3 배치 복제 작업이 전혀 실행되지 않으면 지표가 Amazon CloudWatch로 전송되지 않습니다. 예를 들어, S3 배치 복제 작업을 실행하는 데 필요한 권한이 없거나 복제 구성의 태그 또는 접두사가 일치하지 않는 경우 작업이 실행되지 않습니다.  | 이 지표는 소스 버킷의 리전에 게시됩니다. | 예 | 아니요 | 

CloudWatch에서 이러한 지표를 사용하는 방법에 대한 자세한 내용은 [CloudWatch의 S3 복제 지표](metrics-dimensions.md#s3-cloudwatch-replication-metrics) 섹션을 참조하세요.

## S3 복제 지표 활성화
<a name="enabling-replication-metrics"></a>

새 복제 규칙이나 기존 복제 규칙과 함께 S3 복제 지표를 사용할 수 있습니다. 복제 규칙 생성에 대한 전체 지침은 [동일한 계정에서 버킷 복제 구성](replication-walkthrough1.md) 섹션을 참조하세요. 복제 규칙을 전체 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}}"
}
```

## 복제 지표 보기
<a name="viewing-replication-metrics"></a>

Amazon S3 콘솔에 있는 소스 범용 버킷의 **지표** 탭에서 S3 복제 지표를 볼 수 있습니다. 이러한 Amazon CloudWatch 지표는 Amazon CloudWatch 콘솔에서도 사용할 수 있습니다. S3 복제 지표를 활성화하면 Amazon CloudWatch는 복제 규칙 수준에서 보류 중인 바이트, 보류 중인 작업, 복제 지연 시간을 추적하는 데 사용할 수 있는 지표를 내보냅니다.

S3 복제 지표는 Amazon S3 콘솔 또는 Amazon S3 REST API를 사용하여 S3 Replication Time Control(S3 RTC)을 통해 복제를 활성화하면 자동으로 설정됩니다. [규칙을 만들거나 편집](replication-walkthrough1.md)하는 동안 S3 RTC와 독립적으로 S3 복제 지표를 활성화할 수도 있습니다.

S3 Replication Time Control을 사용하는 경우 Amazon CloudWatch는 각 복제 규칙에서 S3 RTC를 활성화한 후 15분이 지나면 복제 지표 보고를 시작합니다. 자세한 내용은 [S3 복제 지표 사용](#repl-metrics) 섹션을 참조하세요.

복제 지표는 복제 구성의 규칙 ID를 추적합니다. 복제 규칙 ID는 접두사, 태그 또는 둘의 조합에 대해 고유할 수 있습니다.

 Amazon S3용 CloudWatch 지표에 대한 자세한 내용은 [Amazon CloudWatch를 사용한 지표 모니터링](cloudwatch-monitoring.md) 섹션을 참조하십시오.

**사전 조건**  
S3 복제 지표가 활성화된 복제 규칙을 만듭니다. 자세한 내용은 [S3 복제 지표 활성화](#enabling-replication-metrics) 섹션을 참조하세요.

**소스 버킷의 **지표** 탭을 통해 S3 복제 지표를 보려면**

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

1. 왼쪽 탐색 창에서 **범용 버킷**을 선택합니다.

1. 버킷 목록에서 요청 지표를 구성하려는 객체가 있는 소스 버킷의 이름을 선택합니다.

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

1. **복제 지표**에서 지표를 보려는 복제 규칙을 선택합니다.

1. **차트 표시**를 선택합니다.

   Amazon S3는 선택한 규칙에 대한 **복제 지연 시간**, **복제 보류 중인 바이트**, **복제 보류 중인 작업**, **복제 실패 작업** 차트를 표시합니다.