翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # FSx for ONTAP EMS イベントのモニタリング FSx for ONTAP ファイルシステムのイベントは、NetApp ONTAP のネイティブの Events Management System (EMS) を使用することでモニタリングできます。これらのイベントは、NetApp ONTAP CLI を使用して閲覧できます。 **Topics** + [EMS イベントの概要](#ems-events-overview) + [EMS イベントを表示する](#view-ems-events) + [Syslog サーバーへの EMS イベント転送](#ems-log-forwarding) ## EMS イベントの概要 EMS イベントとは、事前に定義した条件が FSx for ONTAP ファイルシステム発生したときに警告する、自動生成される通知のことです。これらの通知は、絶えず情報を提供することで、より大きな問題 (ストレージ仮想マシン (SVM) の認証問題やフルボリュームなど) につながる可能性のある問題の、予防または修正を可能にします。 デフォルトでは、イベントはイベント管理システムのログに記録されます。EMS を使用すれば、ユーザーパスワードが変更された、FlexGroup 内の構成要素が最大容量に達しつつある、論理ユニット番号 (LUN) が手動でオンラインまたはオフラインにされた、ボリュームが自動的にサイズ変更された、などのイベントをモニタリングできます。 ONTAP EMS イベントの詳細については、NetApp ONTAP ドキュメントセンターの「[ONTAP EMS Reference](https://docs.netapp.com/us-en/ontap-ems-9121/index.html)」を参照してください。イベントカテゴリを表示するには、ドキュメントの左側にあるナビゲーションペインを使用します。 **注記** ONTAP EMS メッセージの中には、FSx for ONTAP ファイルシステムで使用できないものがあります。使用可能な ONTAP EMS メッセージのリストを表示するには、NetApp ONTAP CLI [イベントカタログ表示](https://docs.netapp.com/us-en/ontap-cli-9131/event-catalog-show.html)コマンドを使用します。 EMS イベントの説明には、イベント名、重大度、考えられる原因、ログメッセージ、そして、対応の仕方を決める際に役立つ是正措置が記されています。例えば、ボリュームの自動サイズ調整が失敗すると、[wafl.vol.autoSize.fail](https://docs.netapp.com/us-en/ontap-ems-9121/wafl-vol-events.html#wafl-vol-autosize-fail) イベントが発生します。このイベントの説明には、是正措置は、自動サイズ調整中にボリュームの最大サイズを増やすことと記されています。 ## EMS イベントを表示する イベントログの内容を表示するときは、NetApp ONTAP CLI [イベントログ表示](https://docs.netapp.com/us-en/ontap-cli-9131/event-log-show.html) コマンドを使用します。このコマンドは、お使いのファイルシステムに `fsxadmin` ロールがある場合に使用できます。コマンドの構文は以下のとおりです。 ``` event log show [{{event_options}}] ``` 最新のイベントが一番上に表示されます。デフォルトでは、このコマンドにより、重大度のレベルが `EMERGENCY`、`ALERT`、`ERROR` であるイベントが以下の情報と共に表示されます。 + **[時刻]** — イベントの発生時刻です。 + **[ノード]** — イベントの発生場所であるノードです。 + **[重大度]** - イベントの重大性のレベルです。重大度が `NOTICE`、`INFORMATIONAL`、`DEBUG` であるイベントを表示するときは、`-severity` オプションを使用します。 + **[イベント]** — イベントの名前とメッセージです。 イベントに関する詳細情報を表示するには、以下の表にあるイベントオプションを 1 つまたは複数使用します。 | イベントオプション | 説明 | | --- | --- | | `-detail` | 追加のイベント情報を表示します。 | | `-detailtime` | 詳細なイベント情報を新しい順に表示します。 | | `-instance` | すべてのフィールドに関する詳細情報を表示します。 | | `-node {{nodename}}\|local` | 指定したノードのイベントリストを表示します。詳細情報を表示するには、このオプションを `-seqnum` と共に使用します。 | | `-seqnum {{sequence_number}}` | この番号に一致するシーケンス内のイベントを選択します。詳細情報を表示するには、`-node` と共に使用します。 | | `-time {{MM/DD/YYYY HH:MM:SS}}` | この特定の時刻に発生したイベントを選択します。MM/DD/YYYY HH: MM: SS [\+-HH: MM] という形式を使用します。2 つのタイムステートメント間に `..` 演算子を使用すると、時間範囲を指定できます。
event log show -time "04/17/2023 05:55:00".."04/17/2023 06:10:00"

比較時刻値は、コマンドを実行した時点の現在時刻が基準となります。次の例は、過去 1 分間に発生したイベントのみを表示する方法を示しています。
event log show -time >1m

このオプションの月と日のフィールドはゼロパディングされていません。これらのフィールドは 1 桁の数字でもかまいません (例: `4/1/2023 06:45:00`)。 | | `-severity {{sev_level}}` | {{sev\_level}} の値に一致するイベントを選択します。次のいずれかになるはずです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/fsx/latest/ONTAPGuide/ems-events.html)
すべてのイベントを表示するには、重大度を以下のように指定します。
event log show -severity <=DEBUG
| | `-ems-severity {{ems_sev_level}}` | {{ems\_sev\_level}} の値に一致するイベントを選択します。以下のいずれかになるはずです。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/fsx/latest/ONTAPGuide/ems-events.html)
すべてのイベントを表示するには、重大度を以下のように指定します。
event log show -ems-severity <=DEBUG
| | `-source {{text}}` | {{text}} 値に一致するイベントを選択します。ソースは通常、ソフトウェアモジュールです。 | | `-message-name {{message_name}}` | {{message\_name}} 値に一致するイベントを選択します。メッセージ名は記述的であるため、メッセージ名で出力をフィルタリングすると、特定のタイプのメッセージが表示されます。 | | `-event {{text}}` | {{text}} 値に一致するイベントを選択します。`event` フィールドには、パラメータを含むイベントの全文が含まれます。 | | `-kernel-generation-num {{integer}}` | {{integer}} 値に一致するイベントを選択します。kernel 生成番号があるのは、kernel から発生したイベントのみです。 | | `-kernel-sequence-num {{integer}}` | {{integer}} 値に一致するイベントを選択します。kernel シーケンス番号があるのは、kernel から発生したイベントのみです。 | | `-action {{text}}` | {{text}} 値に一致するイベントを選択します。`action` フィールドには、状況を修正するにはどの是正措置を講じる必要があるかが (もしある場合に) 記されています。 | | `-description {{text}}` | {{text}} 値に一致するイベントを選択します。`description` フィールドには、イベントが発生した理由とそれが意味することが記されています。 | | `-filter-name {{filter_name}}` | {{filter\_name}} 値に一致するイベントを選択します。既存のフィルターに含まれる、この値に一致するイベントのみが表示されます。 | | `-fields {{fieldname}},...` | コマンド出力に、指定された 1 つまたは複数のフィールドも含まれていることを、示しています。`-fields ?` を使用すれば、指定するフィールドを選択できます。 | **EMS イベントを表示するには** 1. ファイルシステムの NetApp ONTAP CLI に SSH 接続するには、「*Amazon FSx for NetApp ONTAP ユーザーガイ*ド」の「[NetApp ONTAP CLI の使用](managing-resources-ontap-apps.md#netapp-ontap-cli)」のセクションに記載されているステップに従います。 ``` ssh fsxadmin@{{file-system-management-endpoint-ip-address}} ``` 1. イベントログの内容を表示するときは、`event log show` コマンドを使用します。 ``` ::> event log show Time Node Severity Event ------------------- ------------- ------------- ------------------------ 6/30/2023 13:54:19 node1 NOTICE vifmgr.portup: A link up event was received on node node1, port e0a. 6/30/2023 13:54:19 node1 NOTICE vifmgr.portup: A link up event was received on node node1, port e0d. ``` `event log show` コマンドによって返される EMS イベントの詳細については、NetApp ONTAP ドキュメントセンターの「[ONTAP EMS Reference](https://docs.netapp.com/us-en/ontap-ems-9121/index.html)」を参照してください。 ## Syslog サーバーへの EMS イベント転送 Syslog サーバーに通知を転送するように EMS イベントを設定できます。EMS イベント転送は、ファイルシステムのリアルタイムモニタリングに使用され、さまざまな問題の根本原因を判断および分離します。環境にイベント通知用の Syslog サーバーがまだ含まれていない場合は、まずサーバーを作成する必要があります。DNS は、Syslog サーバー名を解決するようにファイルシステムで設定する必要があります。 **注記** Syslog の送信先は、ファイルシステムで使用されるプライマリサブネットにある必要があります。 **Syslog サーバーに通知を転送するように EMS イベントを設定するには** 1. ファイルシステムの NetApp ONTAP CLI に SSH 接続するには、「*Amazon FSx for NetApp ONTAP ユーザーガイ*ド」の「[NetApp ONTAP CLI の使用](managing-resources-ontap-apps.md#netapp-ontap-cli)」のセクションに記載されているステップに従います。 ``` ssh fsxadmin@{{file-system-management-endpoint-ip-address}} ``` 1. [イベント通知送信先の作成](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-destination-create.html)コマンドを使用して、次の属性を指定して、タイプ `syslog` のイベント通知送信先を作成します。 + `{{dest_name}}` – 作成する通知先の名前 (例: `syslog-ems`)。イベント通知の送信先名は 2～64 文字である必要があります。有効な文字は、A～Z、a～z、0～9、「\_」、「-」の ASCII 文字です。名前は、A～Z、a～z、または 0～9 で開始および終了する必要があります。 + `{{syslog_name}}` – Syslog メッセージが送信される Syslog サーバーのホスト名または IP アドレス。 + `{{transport_protocol}}` – イベントの送信に使用されるプロトコル。 + `udp-unencrypted` – セキュリティのない User Datagram Protocol。これはデフォルトのプロトコルです。 + `tcp-unencrypted` – セキュリティのない Transmission Control Protocol。 + `tcp-encrypted` — Transport Layer Security (TLS) を使用した Transmission Control Protocol。このオプションを指定すると、FSx for ONTAP は証明書を検証して送信先ホストの ID を検証します。 + `{{port_number}}` – Syslog メッセージが送信される Syslog サーバーポート。デフォルト値 `syslog-port` パラメータは、`syslog-transport` パラメータの設定によって異なります。`syslog-transport` が `tcp-encrypted` に設定されている場合、`syslog-port` の User Datagram Protocol デフォルト値は `6514` です。`syslog-transport` が `tcp-unencrypted` に設定されている場合、`syslog-port` はデフォルト値 `601` を持ちます。それ以外の場合、デフォルトポートは `514` に設定されています。 ``` ::> event notification destination create -name {{dest_name}} -syslog {{syslog_name}} -syslog-transport {{transport_protocol}} -syslog-port {{port_number}} ``` 1. [イベント通知作成](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-create.html)コマンドを使用して、前のステップで作成した通知先へのイベントフィルターで定義された一連のイベントの新しい通知を作成し、次の属性を指定します。 + `{{node_name}}` – イベントフィルターの名前。イベントフィルターに含まれるイベントは、`-destinations` パラメータで指定された送信先に転送されます。 + `{{dest_name}}` – イベント通知が送信される既存の通知先の名前。 ``` ::> event notification create -filter-name {{filter_name}} -destinations {{dest_name}} ``` 1. TCP を `{{transport_protocol}}` として選択した場合は、`event notification destination check` コマンドを使用してテストメッセージを生成し、セットアップが機能することを確認します。コマンドで次の属性を指定します。 + `{{node_name}}` – ノードの名前 (例: `FsxId07353f551e6b557b4-01`)。 + `{{dest_name}}` – イベント通知が送信される既存の通知先の名前。 ``` ::> set diag ::*> event notification destination check -node {{node_name}} -destination-name {{dest_name}} ```