View a markdown version of this page

Amazon CloudWatch による S3 Files のモニタリング - Amazon Simple Storage Service

Amazon CloudWatch による S3 Files のモニタリング

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

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

S3 Files CloudWatch メトリクス

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 ファイルシステムへのアクティブなクライアント接続の数。 単位: 個 合計

クライアント接続メトリクス

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 メトリクスへのアクセス

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

CloudWatch コンソールを使用してメトリクスを表示するには

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

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

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

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

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

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

AWS CLI を使ってメトリクスを表示するには

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