翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon CloudWatch Logs でのロギング
FSx for Lustre では、ファイルシステムに関連付けられたデータリポジトリのエラーイベントと警告イベントの Amazon CloudWatch Logs へのロギングをサポートします。
**注記**
Amazon CloudWatch Logs を使用したロギングは、2021 年 11 月 30 日の午後 3 時 PST 以降に作成された Amazon FSx for Lustre ファイルシステムでのみ使用できます。
**Topics**
+ [ロギングの概要](#event-log-overview)
+ [ログの宛先](#event-log-destinations)
+ [ロギングを管理する](#manage-logging)
+ [ログの表示](#view-logs)
## ロギングの概要
FSx for Lustre ファイルシステムにデータリポジトリがリンクされている場合は、Amazon CloudWatch Logs へのデータリポジトリイベントのロギングが有効にできます。エラーイベントと警告イベントは、インポート、エクスポート、復元イベントについてログに記録できます。オペレーションおよびデータリポジトリへのリンクの詳細については、「[Amazon FSx for Lustre でデータリポジトリの使用](fsx-data-repositories.md)」を参照してください。
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 ファイルシステムを作成するとき、または後で更新するときに、ログの宛先を選択します。詳細については、「[ロギングを管理する](#manage-logging)」を参照してください。
デフォルトでは、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 ロググループは、 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/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. 「開始方法」セクションの 「[ステップ 1: FSx for Lustre ファイルシステムの作成](getting-started.md#getting-started-step1)」で説明されている新しいファイルシステムを作成する手順に従います。
1. **[Logging - optional]** (ログ-オプション) セクションを開きます。ロギングはデフォルトで有効になっています。
![\[\]](http://docs.aws.amazon.com/ja_jp/fsx/latest/LustreGuide/images/create-fs-logging.png)
1. ファイルシステム作成ウィザードの次のセクションに進みます。
ファイルシステムが **[Available]** (使用可能) の場合、ログが有効になります。
### ファイルシステム (CLI) の作成時にログを有効にするには
1. 新しいファイルシステムを作成する場合は、`LogConfiguration` プロパティとの [CreateFileSystem](https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystem.html) オペレーションを実行して、新しいファイルシステムのロギングを有効にします。
```
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"}"
```
1. ファイルシステムが **[Available]** (使用可能) になると、ログ機能が有効になります。
### ログ設定を変更するには (コンソール)
1. [https://console.aws.amazon.com/fsx/](https://console.aws.amazon.com/fsx/) で Amazon FSx コンソールを開きます。
1. **[ファイルシステム]** に移動し、ログを管理する Lustre ファイルシステムを選択します。
1. **[Data repository]** (データリポジトリ) タブを選択します。
1. **ログ**のパネルで、**[Update]** (更新) を選択します。
1. **ログ設定の更新**ダイアログで、目的の設定を変更します。
1. **[Log errors]** (エラーのログ) を選択してエラーイベントのみをログに記録するか、**[Log warnings]** (警告のログ) を選択して警告イベントのみをログに記録するか、またはその両方を選択します。選択を行わないと、ログは無効になります。
1. 既存の CloudWatch Logs のログ宛先を選択するか、新しいログ宛先を作成します。
1. **[Save]** (保存) を選択します。
### ログ設定を変更するには (CLI)
+ [https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html](https://docs.aws.amazon.com/cli/latest/reference/fsx/update-file-system.html) CLI コマンドまたは同等の [https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateFileSystem.html](https://docs.aws.amazon.com/fsx/latest/APIReference/API_UpdateFileSystem.html) 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 がログの出力を開始した後、ログを表示できます。以下のようにログを表示できます。
+ ログを表示するには、Amazon CloudWatch コンソールに移動し、イベントログの宛先となるロググループとログストリーミングを選択します。詳細については、「*Amazon CloudWatch Logs ユーザーガイド*」の「[Cloud Watch Logs に送信されたログデータの表示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)」を参照してください。
+ CloudWatch Logs Insights を使用してログデータをインタラクティブに検索および分析できます。詳細については、「*Amazon CloudWatch Logs ユーザーガイド*」の「[ CloudWatch Logs Insights によるログデータの分析](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)」を参照してください。
+ ログを Simple Storage Service (Amazon S3) にエクスポートすることもできます。詳細については、「*Amazon CloudWatch Logs ユーザーガイド*」の「[ Simple Storage Service (Amazon S3) へのログデータのエクスポート](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3Export.html)」を参照してください。
障害の原因の詳細については、「[データリポジトリのイベントログ](data-repo-event-logs.md)」を参照してください。