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 Logs を使用すると、Amazon CloudWatch コンソールで監査イベントログを保存、表示、検索したり、CloudWatch Logs インサイトを使用してログに対してクエリを実行したり、CloudWatch アラームまたは Lambda 関数をトリガーしたりできます。

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

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

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

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

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

  • 宛先 CloudWatch Logs ロググループは、Amazon FSx for Lustre ファイルシステムと同じ AWSパーティション、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. 「開始方法」セクションの 「ステップ 1: FSx for Lustre ファイルシステムの作成」で説明されている新しいファイルシステムを作成する手順に従います。

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

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

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

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

  1. 新しいファイルシステムを作成する場合は、LogConfiguration プロパティとの CreateFileSystem オペレーションを実行して、新しいファイルシステムのロギングを有効にします。

    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. [ファイルシステム] に移動し、ログを管理する Lustre ファイルシステムを選択します。

  3. [Data repository] (データリポジトリ) タブを選択します。

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

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

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

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

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

  • 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 がログの出力を開始した後、ログを表示できます。以下のようにログを表示できます。

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