# ディレクトリバケットのリクエストメトリクスの設定
<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. サインインし、Amazon S3 コンソール [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) を開きます。

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

1. バケットリストで、メトリクスをリクエストするオブジェクトが含まれるディレクトリバケットの名前を選択します。

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

1. **[バケットメトリクス]** で、**[その他のグラフを表示]** をクリックします。

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

1. **[フィルターの作成]** をクリックします。

1. **[フィルタ名]** ボックスに、フィルタ名を入力します。

   名前には、文字、数字、ピリオド、ダッシュ、アンダースコアのみを使用できます。すべてのオブジェクトに適用されるフィルタには、名前 `EntireBucket` を使用することをお勧めします。

1. **[フィルター範囲]** で、次のいずれかを選択します。
   + **このフィルターはバケット内のすべてのオブジェクトに適用されます** – フィルターを指定しません。
   + **ディレクトリまたはアクセスポイントを使用してこのフィルターの範囲を制限します** – フィルターを指定します。スコープを制限するには、ディレクトリまたはアクセスポイントでフィルタリングします。

   フィルタを定義することで、ディレクトリバケット内のオブジェクトのサブセットに関するメトリクスのみを収集してレポートすることもできます。

1. フィルターの範囲を制限する場合は、フィルターの詳細を指定します。
   + **[ディレクトリ]** でフィルタリングするには、ディレクトリ名を入力します。
   + **[アクセスポイント]** でフィルタリングするには、アクセスポイント ARN を入力します。

1. **[Save changes]** (変更の保存) をクリックします。

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 Bucket メトリクス](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [GET Bucket メトリクス](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [DELETE Bucket メトリクス](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketDELETEMetricConfiguration.html)
+ [LIST Bucket メトリクス](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketListMetricConfigurations.html)