# Amazon CloudWatch による S3 Files のモニタリング
<a name="s3-files-monitoring-cloudwatch"></a>

[Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) を使用して S3 Files ファイルシステムをモニタリングすることで、Amazon S3 Files から raw データを収集し、読み取り可能なメトリクスに加工することができます。これらのメトリクスは 15 か月間保持されるため、履歴情報にアクセスして、ファイルシステムのパフォーマンスをより正確に把握できます。

S3 Files のメトリクスデータは CloudWatch に自動的に送信されます。ほとんどのメトリクスは 1 分間隔で送信され、ストレージメトリクスは 15 分ごとに送信されます。[CloudWatch アラーム](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)を作成すると、メトリクスが設定したしきい値を超えたときに通知が送信されます。CloudWatch ダッシュボードも利用できます。これは CloudWatch コンソールのカスタマイズ可能なホームページで、単一のビューでリソースをモニタリングするために使用できます。詳細については、「[カスタマイズされた CloudWatch ダッシュボードの作成](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html)」を参照してください。

## S3 Files CloudWatch メトリクス
<a name="s3-files-monitoring-cloudwatch-metrics"></a>

S3 Files メトリクスは `AWS/S3/Files` 名前空間を使用します。すべてのメトリクスは、単一ディメンション `FileSystemId` に対してレポートされます。`AWS/S3/Files` 名前空間には、次のメトリクスが含まれます。


| メトリクス | 説明 | 単位と有効な統計 | 
| --- | --- | --- | 
| StorageBytes | ファイルシステムの合計サイズをバイト単位で示します。これにはデータとメタデータが含まれます。このメトリクスは 15 分ごとに CloudWatch に発行されます。 | 単位: バイト。最小、最大、平均 | 
| Inodes | S3 Files ファイルシステム内の inode (ファイル、ディレクトリ、シンボリックリンクなど) の合計数。このメトリクスは 15 分ごとに CloudWatch に発行されます。 | 単位: 個 合計 | 
| PendingExports | S3 バケットへのエクスポートを保留中のファイルとディレクトリの合計数。 | 単位: 個 合計 | 
| ImportFailures | 再試行後にファイルシステムにインポートできなかったオブジェクトの合計数 (IAM アクセス許可の誤りなど)。 | 単位: 個 合計 | 
| ExportFailures | エクスポートに失敗し、再試行されないファイルとディレクトリの合計数。このメトリクスは、ターミナルのエクスポートエラーを特定し、トラブルシューティングとアクションの実行 (IAM アクセス許可の更新など) を行うのに役立ちます。 | 単位: 個 合計 | 
| DataReadBytes | ファイルシステムから読み取られたバイト数。SampleCount はデータ読み取りオペレーションの回数を示します。単位時間ごとにこのメトリクスを表示することで、データ読み取りスループットを計算できます。 | 単位: バイト (最小、最大、平均、合計)、個 (SampleCount) | 
| DataWriteBytes | ファイルシステムに書き込まれたバイト数。SampleCount はデータ書き込みオペレーションの回数を示します。単位時間ごとにこのメトリクスを表示することで、データ書き込みスループットを計算できます。 | 単位: バイト (最小、最大、平均、合計)、個 (SampleCount) | 
| MetadataReadBytes | ファイルシステムから読み取られたメタデータのバイト数。SampleCount はメタデータ読み取りオペレーションの回数を示します。 | 単位: バイト (最小、最大、平均、合計)、個 (SampleCount) | 
| MetadataWriteBytes | ファイルシステムに書き込まれたメタデータのバイト数。SampleCount はメタデータ書き込みオペレーションの回数を示します。 | 単位: バイト (最小、最大、平均、合計)、個 (SampleCount) | 
| LostAndFoundFiles | lost and found ディレクトリ内のファイルの合計数。lost and found ディレクトリは、ファイルシステムのルートディレクトリに .s3files-lost\+found-{{file-system-id}} という名前で存在します。lost and found ディレクトリ内のファイルは、S3 バケットにコピーされません。ファイルシステムと S3 バケットの両方で同じデータへの同時変更が原因で競合が発生した場合、S3 Files は S3 バケットを信頼できるソースとして扱い、競合するファイルを lost and found ディレクトリに移動します。 | 単位: 個 合計 | 
| ClientConnections | ファイルシステムへのアクティブなクライアント接続の数。 | 単位: 個 合計 | 

## クライアント接続メトリクス
<a name="s3-files-monitoring-cloudwatch-client-metrics"></a>

S3 Files は、クライアントがリンクされた S3 バケットから直接ファイルデータを読み取れるようにすることで、読み取りパフォーマンスを最適化できます。これをサポートするために、S3 Files クライアントは、クライアントが必要な接続を確立できるかどうかをモニタリングする接続メトリクスを出力します。

これらのメトリクスは S3 Files クライアント (amazon-efs-utils) によって発行され、`efs-utils/S3Files` CloudWatch 名前空間に公開されます。メトリクスの放出は、S3 Files エクスペリエンスの一部としてデフォルトで有効になっています。


| メトリクス | 説明 | 単位と有効な統計 | 
| --- | --- | --- | 
| NFSConnectionAccessible | クライアントが NFS マウントを介してファイルシステムに接続できるかどうかを示します。値が 1 の場合は、接続にアクセスできることを意味します。値が 0 の場合は、接続にアクセスできないことを意味します。 | 単位: なし 最小、最大、平均 | 
| S3BucketAccessible | クライアントがリンクされた S3 バケットからデータを読み取るために必要なアクセス許可を持っているかどうかを示します。値が 1 の場合は、クライアントに必要なアクセス許可があることを意味します。値が 0 の場合は、クライアントに必要なアクセス許可がないことを意味します。 | 単位: なし 最小、最大、平均 | 
| S3BucketReachable | リンクされた S3 バケットとプレフィックスが存在し、クライアントから到達可能かどうかを示します。値が 1 の場合は、バケットとプレフィックスに到達可能であることを意味します。値が 0 の場合は、バケットまたはプレフィックスに到達できないことを意味します。 | 単位: なし 最小、最大、平均 | 

## CloudWatch メトリクスへのアクセス
<a name="s3-files-monitoring-cloudwatch-access"></a>

S3 Files のメトリクスは、CloudWatch コンソール、AWS CLI、または CloudWatch API を使用して表示できます。

### CloudWatch コンソールを使用してメトリクスを表示するには
<a name="s3-files-monitoring-cloudwatch-access-console"></a>

1. CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。

1. ナビゲーションペインで、**[メトリクス]** 、**[すべてのメトリクス]** の順に選択します。

1. **[S3Files]** 名前空間を選択します。

1. **[ファイルシステムメトリクス]** を選択します。

1. 表示するメトリクスを選択します。

1. **[グラフ化したメトリクス]** タブを選択して、グラフ表示を設定します。

### AWS CLI を使ってメトリクスを表示するには
<a name="s3-files-monitoring-cloudwatch-access-cli"></a>

`get-metric-statistics` コマンドを使用します。例えば、`DataReadBytes` を表示するには、次のようにします。

```
aws cloudwatch get-metric-statistics \
  --namespace AWS/S3/Files \
  --metric-name DataReadBytes \
  --dimensions Name=FileSystemId,Value={{file-system-id}} \
  --start-time 2025-01-20T00:00:00Z \
  --end-time 2025-01-20T23:59:59Z \
  --period 3600 \
  --statistics Sum
```