# S3 レプリケーションメトリクスの使用
<a name="repl-metrics"></a>

S3 レプリケーションメトリクス は、レプリケーション設定のレプリケーションルールの詳細なメトリクスを提供します。レプリケーションメトリクスを使って、保留中のバイト数、保留中のオペレーション、レプリケーションに失敗したオペレーション、レプリケーションのレイテンシーを追跡すると、レプリケーションの進行状況を 1 分単位でモニタリングできます。

**注記**  
S3 レプリケーションメトリクスは、Amazon CloudWatch カスタムメトリクスと同じ料金レートで請求されます。詳細については、「[Amazon CloudWatch の料金](https://aws.amazon.com/cloudwatch/pricing/)」を参照してください。
S3 レプリケーション時間コントロールを使用している場合、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 (S3 RTC)を使用してコンプライアンス要件を満たす](replication-time-control.md)」を参照してください。

S3 レプリケーションメトリクスが有効になっている場合、Amazon S3 は次のメトリクスを Amazon CloudWatch に発行します。CloudWatch メトリクスは、ベストエフォートで配信されます。


| メトリクス名 | メトリクスの説明 | このメトリクスはどのオブジェクトに適用されますか。 | このメトリクスはどのリージョンで発行されていますか。 | レプリケート先バケットが削除された場合でも、このメトリクスは発行されますか。 | レプリケーションが行われない場合、このメトリクスは引き続き発行されますか。 | 
| --- | --- | --- | --- | --- | --- | 
| **レプリケーション保留中のバイト数** |  特定のレプリケーションルールについて、レプリケーションが保留中のオブジェクトの合計バイト数。  | このメトリクスは、S3 クロスリージョンレプリケーション (S3 CRR) または S3 同一リージョンレプリケーション (S3 SRR) でレプリケートされた新しいオブジェクトにのみ適用されます。 | このメトリクスは、レプリケート先バケットのリージョンで発行されます。 | いいえ | あり | 
| **レプリケーションレイテンシー** |  特定のレプリケーションルールについて、レプリケート先バケットがレプリケート元バケットより遅れる最大秒数。  | このメトリクスは、S3 CRR または S3 SRR でレプリケートされた新しいオブジェクトにのみ適用されます。 | このメトリクスは、レプリケート先バケットのリージョンで発行されます。 | いいえ | あり | 
| **レプリケーション保留中のオペレーション** |  特定のレプリケーションルールについて、レプリケーションが保留中のオペレーションの数。このメトリクスは、オブジェクト、削除マーカー、タグ、アクセスコントロールリスト (ACL)、S3 オブジェクトロックに関連するオペレーションを追跡します。  | このメトリクスは、S3 CRR または S3 SRR でレプリケートされた新しいオブジェクトにのみ適用されます。 | このメトリクスは、レプリケート先バケットのリージョンで発行されます。 | いいえ | あり | 
| **オペレーション失敗レプリケーション** |  特定のレプリケーションルールについて、レプリケーションに失敗したオペレーションの数。このメトリクスは、オブジェクト、削除マーカー、タグ、アクセスコントロールリスト (ACL)、Object Lockに関連するオペレーションを追跡します。 **[レプリケーションに失敗したオペレーション]** は、S3 レプリケーションの失敗を 1 分間隔で集計して追跡します。レプリケーションに失敗した特定のオブジェクトとその失敗理由を特定するには、Amazon S3 イベント通知で `OperationFailedReplication` イベントをサブスクライブしてください。詳細については、「[Amazon S3 イベント通知によるレプリケーション失敗イベントの受信](replication-metrics-events.md)」を参照してください。  |  このメトリクスは S3 CRR または S3 SRR でレプリケートされる新しいオブジェクトと、S3 バッチレプリケーションでレプリケートされる既存のオブジェクトの両方に適用されます。  S3 バッチレプリケーションジョブがまったく実行されなかった場合、メトリクスは Amazon CloudWatch に送信されません。例えば、S3 Batch レプリケーションジョブを実行するために必要なアクセス許可がない場合、またはレプリケーション設定のタグまたはプレフィックスが一致しない場合、ジョブは実行されません。   | このメトリクスは、ソースバケットのリージョンで公開されます。 | はい | いいえ | 

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>

S3 レプリケーションメトリクスは、Amazon S3 コンソールのソース汎用バケットの **[メトリクス]** タブで表示できます。これらの Amazon CloudWatch メトリクスは、Amazon CloudWatch コンソールでも使用できます。S3 レプリケーションメトリクスを有効にすると、Amazon CloudWatch は、保留中のバイト数、保留中のオペレーション、レプリケーションレイテンシーをレプリケーションルールレベルで追跡するために使用できるメトリクスを出力します。

Amazon S3 コンソールまたは Amazon S3 REST API を使用して S3 Replication Time Control (S3 RTC) でレプリケーションを有効にすると、S3 レプリケーションメトリクスが自動的にオンになります。[ルールを作成または編集するときに](replication-walkthrough1.md)、S3 RTC とは独立して S3 レプリケーションメトリクスを有効にすることもできます。

S3 レプリケーション時間コントロールを使用している場合、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 マネジメントコンソール にサインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

1. 左のナビゲーションペインで、**[汎用バケット]** を選択します。

1. バケットリストで、レプリケーションメトリクスを取得するオブジェクトが含まれているソースバケットの名前を選択します。

1. **[メトリクス]** タブをクリックします。

1. **[レプリケーションメトリクス]** で、メトリクスを表示するレプリケーションルールを選択します。

1. **[グラフを表示]** を選択します。

   Amazon S3 には、選択したルールの **[レプリケーションレイテンシー]**、**[レプリケーション保留中のバイト数]**、**[レプリケーションを保留中のオペをレーション]**、および **[レプリケーションに失敗したオペレーション]** のグラフが表示されます。