Amazon CloudWatch Logs でのログ記録 - FSx for Lustre
ロギングの概要ログの宛先ロギングを管理するログの表示

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon CloudWatch Logs でのログ記録

FSx for Lustre は、ファイルシステムに関連付けられたデータリポジトリのエラーイベントと警告イベントの Amazon CloudWatch Logs へのログ記録をサポートします。

注記

Amazon CloudWatch Logs を使用したログ記録は、2021 年 11 月 30 日の午後 3 時 PST 以降に作成された Amazon FSx for Lustre ファイルシステムでのみ使用できます。

ロギングの概要

FSx for Lustre ファイルシステムにリンクされたデータリポジトリがある場合は、Amazon CloudWatch Logs へのデータリポジトリイベントのログ記録を有効にできます。エラーイベントと警告イベントは、次のデータリポジトリオペレーションからログに記録できます。

  • 自動エクスポート

  • データリポジトリタスク

オペレーションおよびデータリポジトリへのリンクの詳細については、「Amazon FSx for Lustre でデータリポジトリの使用」を参照してください。

Amazon FSx がログに記録するログレベルを設定できます。つまり、Amazon FSx がエラーイベントのみ、警告イベントのみ、またはエラーイベントと警告イベントの両方を記録するかどうかを設定できます。イベントログをいつでもオフにすることもできます。

注記

関連したすべてのレベルの重要な機能を持つファイルシステムには、ログを有効にすることを強くお勧めします。

ログの宛先

ログ記録が有効になっている場合、FSx for Lustre は Amazon CloudWatch Logs の送信先で設定する必要があります。イベントログの送信先は Amazon CloudWatch Logs ロググループであり、Amazon FSx はこのロググループ内にファイルシステムのログストリームを作成します。 CloudWatch ログを使用すると、Amazon CloudWatch コンソールで監査イベントログを保存、表示、検索したり、Logs Insights CloudWatch を使用してログに対してクエリを実行したり、アラームまたは Lambda 関数をトリガー CloudWatchしたりできます。

FSx for Lustre ファイルシステムを作成するとき、または後で更新するときに、ログの宛先を選択します。詳細については、「ロギングを管理する」を参照してください。

デフォルトでは、Amazon FSx はアカウントでデフォルトの CloudWatch ロググループを作成し、イベントログの送信先として使用します。カスタム CloudWatch ロググループをイベントログの送信先として使用する場合は、イベントログの送信先の名前と場所の要件は次のとおりです。

  • CloudWatch Logs ロググループの名前は、 /aws/fsx/ プレフィックスで始まる必要があります。

  • コンソールでファイルシステムを作成または更新するときに既存の CloudWatch Logs ロググループがない場合、Amazon FSx for Lustre は Logs ログ/aws/fsx/lustreグループでデフォルトの CloudWatch ログストリームを作成して使用できます。ログストリーミングは、datarepo_file_system_id の形式で作成されます (例えば、datarepo_fs-0123456789abcdef0)。

  • デフォルトのロググループを使用しない場合は、コンソールでファイルシステムを作成または更新するときに、設定 UI で CloudWatch ログロググループを作成できます。

  • 送信先の CloudWatch Logs ロググループは、 AWS アカウント Amazon FSx for Lustre ファイルシステムと同じ AWS パーティション、 AWS リージョン、および にある必要があります。

イベントログの宛先はいつでも変更できます。そうすると、新しいイベントログは新しい宛先にのみ送信されます。

ロギングを管理する

新しい FSx for Lustre ファイルシステムを作成する際や、後で更新する際にログを有効にできます。Amazon FSx コンソールからファイルシステムを作成すると、デフォルトでロギングはオンになります。ただし、 AWS CLI または Amazon FSx API を使用してファイルシステムを作成すると、ログ記録はデフォルトでオフになります。

ロギングが有効になっている既存のファイルシステムでは、イベントを記録するログレベルやログの宛先など、ログイベントの設定を変更できます。これらのタスクは、Amazon FSx コンソール AWS CLI、または Amazon FSx API を使用して実行できます。

  1. https://console.aws.amazon.com/fsx/ で Amazon FSx コンソールを開きます。

  2. 「開始方法」セクションの 「FSx for Lustre ファイルシステムを作成する」で説明されている新しいファイルシステムを作成する手順に従います。

  3. [Logging - optional] (ログ-オプション) セクションを開きます。ロギングはデフォルトで有効になっています。

    ファイルシステムの作成ウィザードの [Logging - optional] (ログ - オプション) セクションでイベントログがデフォルトでオフになっていることを示しています。

  4. ファイルシステム作成ウィザードの次のセクションに進みます。

ファイルシステムが [Available] (使用可能) の場合、ログが有効になります。

  1. 新しいファイルシステムを作成するときは、CreateFileシステムオペレーションで LogConfigurationプロパティを使用して、新しいファイルシステムのログ記録を有効にします。

    create-file-system --file-system-type LUSTRE \
    --storage-capacity 1200 --subnet-id subnet-08b31917a72b548a9  \ 
    --lustre-configuration "LogConfiguration={Level=WARN_ERROR, \
        Destination="arn:aws:logs:us-east-1:234567890123:log-group:/aws/fsx/testEventLogging"}"

  2. ファイルシステムが [Available] (使用可能) になると、ログ機能が有効になります。

  1. https://console.aws.amazon.com/fsx/ で Amazon FSx コンソールを開きます。

  2. [File systems] (ファイルシステム) に移動し、ログを管理する Lustre ファイルシステムを選択します。

  3. モニタリングタブを選択します。

  4. ログのパネルで、[Update] (更新) を選択します。

  5. ログ設定の更新ダイアログで、目的の設定を変更します。

    1. [Log errors] (エラーのログ) を選択してエラーイベントのみをログに記録するか、[Log warnings] (警告のログ) を選択して警告イベントのみをログに記録するか、またはその両方を選択します。選択を行わないと、ログは無効になります。

    2. 既存の CloudWatch ログログの送信先を選択するか、新しいログの送信先を作成します。

  6. [保存] を選択します。

  • update-file-system CLI コマンドまたは同等の UpdateFileSystem API オペレーションを使用します。

    update-file-system --file-system-id fs-0123456789abcdef0 \
    --lustre-configuration "LogConfiguration={Level=WARN_ERROR, \
        Destination="arn:aws:logs:us-east-1:234567890123:log-group:/aws/fsx/testEventLogging"}"

ログの表示

Amazon FSx がログの出力を開始した後、ログを表示できます。以下のようにログを表示できます。

障害の原因の詳細については、「データリポジトリのイベントログ」を参照してください。