# Amazon CloudWatch によるメトリクスのモニタリング
<a name="s3-tables-cloudwatch-metrics"></a>

Amazon CloudWatch メトリクスを使用して、パフォーマンスの追跡、異常の検出、テーブルの運用状態のモニタリングを行うことができます。S3 Tables で使用できる CloudWatch メトリクスのセットがいくつかあります。

**テーブルとテーブルバケットの日次ストレージメトリクス**  
バイト単位の合計サイズやファイル数など、テーブルとテーブルバケットに保存されているデータ量をモニタリングします。これらのメトリクスは、テーブルバケット、テーブル、および名前空間レベルで、アクセス階層あたりの合計ストレージバイト数とファイル数を追跡します。S3 Tables のストレージメトリクスは、1 日に 1 回レポートされ、すべてのお客様に追加料金なしで提供されます。

**テーブルメンテナンスメトリクス**  
圧縮など、Amazon S3 によってテーブルに対して実行される自動メンテナンスオペレーションをモニタリングします。これらのメトリクスは、メンテナンスアクティビティ中に処理されたバイト数とファイル数を追跡します。S3 Tables のメンテナンスメトリクスは 1 日に 1 回報告され、すべてのお客様に追加料金なしで提供されます。

**リクエストメトリクス**  
S3 Tables リクエストをモニタリングし、オペレーションの問題をすばやく特定して対応します。これらの CloudWatch メトリクスは、個々のテーブルバケットに対してオプションで有効にできます。S3 Tables のリクエストメトリクスは 1 分ごとにレポートされ、CloudWatch カスタムメトリクスと同じ料金レートで請求されます。リクエストメトリクスには以下が含まれます。  
+ データプレーンオペレーションの数 (GET、PUT、HEAD、POST)
+ 転送バイト数
+ レイテンシー測定値
+ エラーレート

**注記**  
**ベストエフォート型の CloudWatch メトリクス配信**  
CloudWatch メトリクスは、ベストエフォートで配信されます。リクエストメトリクスを持つ Amazon S3 オブジェクトのほとんどのリクエストにより、データポイントが CloudWatch に送信されます。  
メトリクスの完全性や適時性は保証されません。特定のリクエストのデータポイントが、リクエストが実際に処理されたよりも後のタイムスタンプで返される場合があります。1 分のデータポイントは CloudWatch を通じて利用可能になるまで遅延する場合や、まったく提供されない場合があります。CloudWatch リクエストメトリクスは、バケットに対するトラフィックの特性をほぼリアルタイムで示します。すべてのリクエストを完全に報告するためのものではありません。この機能はベストエフォート型であるため、請求情報とコスト管理ダッシュボードで利用できるレポートには、バケットメトリクスに表示されない 1 つ以上のアクセスリクエストが含まれることがあります。

# メトリクスとディメンション
<a name="s3-tables-metrics-dimensions"></a>

S3 Tables が Amazon CloudWatch に送信するストレージメトリクスとディメンションを次の表に一覧表示します。

**注記**  
**ベストエフォート型の CloudWatch メトリクス配信**  
CloudWatch メトリクスは、ベストエフォートで配信されます。リクエストメトリクスを持つ Amazon S3 オブジェクトのほとんどのリクエストにより、データポイントが CloudWatch に送信されます。  
メトリクスの完全性や適時性は保証されません。特定のリクエストのデータポイントが、リクエストが実際に処理されたよりも後のタイムスタンプで返される場合があります。1 分のデータポイントは CloudWatch を通じて利用可能になるまで遅延する場合や、まったく提供されない場合があります。CloudWatch リクエストメトリクスは、バケットに対するトラフィックの特性をほぼリアルタイムで示します。すべてのリクエストを完全に報告するためのものではありません。この機能はベストエフォート型であるため、請求情報とコスト管理ダッシュボードで利用できるレポートには、バケットメトリクスに表示されない 1 つ以上のアクセスリクエストが含まれることがあります。

## CloudWatch のバケットの日次ストレージメトリクス。
<a name="daily-storage-metrics"></a>

`AWS/S3/Tables` 名前空間には、以下の日次ストレージメトリクスが含まれており、追加料金なしで利用できます。これらのメトリクスは、テーブルバケット、テーブル、または名前空間名でフィルタリングできます。


**日次ストレージメトリクス**  

| メトリクス名 | 説明 | 単位 | 統計 | 詳細度 | 
| --- | --- | --- | --- | --- | 
| バケットストレージの合計 | テーブルバケット内のすべてのテーブルで使用されるストレージのバイト数 | バイト | 合計 | 1 日 1 回 | 
| ファイルの総数 | テーブルバケットに保存されているすべてのファイルの合計数 | Count (カウント) | 合計 | 1 日 1 回 | 

## テーブルメンテナンスメトリクス
<a name="table-maintenance-metrics"></a>

`AWS/S3/Tables` 名前空間には、以下のテーブルメンテナンスメトリクスが含まれており、追加料金なしで利用できます。これらのメトリクスは、テーブルバケット、テーブル、または名前空間名でフィルタリングできます。


**テーブルメンテナンスメトリクス**  

| メトリクス名 | 説明 | 単位 | 統計 | 詳細度 | 
| --- | --- | --- | --- | --- | 
| CompactionBytesProcessed | テーブル圧縮オペレーション中に処理されたバイト数 | バイト | 合計 | 1 日 1 回 | 
| CompactionObjectsCount | テーブル圧縮オペレーション中に処理されたオブジェクトの数 | Count (カウント) | 合計 | 1 日 1 回 | 

## CloudWatch でテーブルとテーブルバケットのメトリクスをリクエストする
<a name="request-metrics"></a>

`AWS/S3/Tables` 名前空間には、CloudWatch カスタムメトリクスと同じレートで請求される次のリクエストメトリクスが含まれます。これらのメトリクスは、テーブルバケット、テーブル、または名前空間名でフィルタリングできます。


**リクエストメトリクス**  

| メトリクス名 | 説明 | 単位 | 統計 | 詳細度 | 
| --- | --- | --- | --- | --- | 
| すべてのリクエスト数 | テーブルバケットに対して行われた HTTP リクエストの総数。 | Count (カウント) | 合計 | 1 分 | 
| Get リクエスト数 | テーブルからオブジェクトを取得するために行われた HTTP GET リクエストの数 | Count (カウント) | 合計 | 1 分 | 
| Put リクエスト数 | テーブルにオブジェクトを追加するために行われた HTTP PUT リクエストの数 | Count (カウント) | 合計 | 1 分 | 
| Head リクエスト数 | テーブルからメタデータを取得するために行われた HTTP HEAD リクエストの数 | Count (カウント) | 合計 | 1 分 | 
| Post リクエスト数 | テーブルに対して行われた HTTP POST リクエストの総数 | Count (カウント) | 合計 | 1 分 | 
| UpdateTableMetadataLocation リクエスト数 | テーブルメタデータの場所を更新するために行われたリクエストの数 | Count (カウント) | 合計 | 1 分 | 
| GetTableMetadataLocation リクエスト数 | テーブルメタデータの場所を取得するために行われたリクエストの数 | Count (カウント) | 合計 | 1 分 | 
| BytesDownloaded | テーブルリクエストにダウンロードされたバイト数 | バイト | 合計 | 1 分 | 
| BytesUploaded | テーブルリクエストにアップロードされたバイト数 | バイト | 合計 | 1 分 | 
| 4xxErrors | 返された HTTP 4xx クライアントエラーステータスコードの数 | Count (カウント) | 合計 | 1 分 | 
| 5xxErrors | 返された HTTP 5xx サーバーエラーステータスコードの数 | Count (カウント) | 合計 | 1 分 | 
| FirstByteLatency | リクエスト全体が受信されてからレスポンスの送信が開始されるまでのリクエストあたりの時間。 | ミリ秒 | 合計 | 1 分 | 
| TotalRequestLatency | 最初のバイトが受信されてから最後のバイトが送信されるまでのリクエストあたりの経過時間。 | ミリ秒 | 合計 | 1 分 | 

## CloudWatch の S3 Tables ディメンション
<a name="s3-tables-dimensions"></a>

以下のディメンションは、S3 Tables メトリクスをフィルタリングするために使用されます。


**S3 Tables ディメンション**  

| ディメンション名 | 説明 | 値の例 | 
| --- | --- | --- | 
| TableBucketName | Amazon S3 テーブルバケットの名前です。 | my-table-bucket | 
| Namespace | 1 つ以上のテーブルを含むテーブルバケット内の名前空間 | my-department | 
| TableName | 名前空間内の特定のテーブルの名前 | transactions | 

# CloudWatch メトリクスへのアクセス
<a name="s3-tables-accessing-cloudwatch-metrics"></a>

S3 Tables メトリクスは、CloudWatch コンソール、AWS CLI、または CloudWatch API を使用して調査できます。このセクションでは、これらのさまざまな方法を使用してメトリクスにアクセスする方法について説明します。

## S3 コンソールの使用
<a name="tables-metrics-using-console"></a>

1. AWS マネジメントコンソールにサインインして Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。

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

1. バケットリストで、メトリクスを確認するテーブルが含まれるバケットの名前を選択します。

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

1. メトリクスペインで **[CloudWatch で表示]** を選択して CloudWatch コンソールに移動し、`AWS/S3/Tables` 名前空間で使用可能なメトリクスを確認します。

## の使用AWS CLI
<a name="tables-metrics-using-cli"></a>

AWS CLI を使用して S3 Tables のメトリクスを一覧表示するには、`--namespace` パラメータを「`AWS/S3/Tables`」に設定して `list-metrics` コマンドを使用します。

```
aws cloudwatch list-metrics --namespace AWS/S3/Tables
```

特定の S3 Tables メトリクスの統計を取得するには、`get-metric-statistics` コマンドを使用します。例えば、次のようになります。

```
aws cloudwatch get-metric-statistics \
--namespace AWS/S3/Tables \
--metric-name TotalBucketStorage \
--dimensions Name=TableBucketName,Value=MyTableBucket \
--start-time 2025-03-01T00:00:00 \
--end-time 2025-03-02T00:00:00 \
--period 86400 \
--statistics Average
```

## ベストプラクティス
<a name="best-practices"></a>
+ メトリクスを取得するときは、メトリクスの詳細度に基づいて期間値を設定します。日次メトリクス (ストレージメトリクスなど) には、86400 秒 (24 時間) を使用します。分レベルのメトリクス (リクエストメトリクスなど) には、60 秒を使用します。
+ ディメンションを適切に使用して、メトリクスを目的のスコープ (テーブルバケット、名前空間、または個々のテーブルレベル) にフィルタリングします。
+ Metric Math を使用して、モニタリングニーズにより適した派生メトリクスを作成することを検討してください。

## 関連リソース
<a name="related-resources"></a>
+ [の Amazon CloudWatch コンセプト](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)
+ [Amazon CloudWatch ダッシュボードの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)

# CloudWatch メトリクスの管理
<a name="s3-tables-managing-cloudwatch-metrics"></a>

ストレージメトリクスは、すべての Amazon S3 テーブルとテーブルバケットでデフォルトで有効になっています。コンソール、AWS Command Line Interface (AWS CLI)、または AWS SDK を使用して、追加のリクエストメトリクスを有効または無効にできます。

## 前提条件
<a name="prerequisites"></a>
+ `s3table:PutTableBucketMetricsConfiguration` IAM アクセス許可が必要

**注記**  
S3 Tables リクエストメトリクスは、CloudWatch カスタムメトリクスと同じ料金レートで請求されます。

## AWS マネジメントコンソールの使用
<a name="using-console-managing"></a>

追加のメトリクスを有効または無効にするには

1. AWS マネジメントコンソールにサインインして Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。

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

1. バケットリストで、メトリクスをリクエストするテーブルが含まれるテーブルバケットの名前を選択します。

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

1. リクエストメトリクスパネルから、**[編集]** を選択します。

1. **[有効]** または **[無効]** を選択し、**[変更の保存]** を選択します。

## の使用AWS CLI
<a name="using-cli-managing"></a>

これらの例は、AWS CLI を使用してテーブルバケットのリクエストメトリクスを有効または無効にする方法を示しています。これらのコマンドを使用するには、*ユーザー入力用プレースホルダー*を独自の情報に置き換えます。

**Example : テーブルバケットのリクエストメトリクスを有効にするには。**  

```
aws s3tables put-table-bucket-metrics-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket
```

**Example : テーブルバケットのリクエストメトリクスを無効にするには。**  

```
aws s3tables delete-table-bucket-metrics-configuration \
--table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket
```