FSx for ONTAP EMS イベントのモニタリング

フォーカスモード

FSx for ONTAP EMS イベントのモニタリング - FSx for ONTAP

EMS イベントの概要 EMS イベントを表示する Syslog サーバーへの EMS イベント転送

FSx for ONTAP ファイルシステムのイベントは、NetApp ONTAP のネイティブの Events Management System (EMS) を使用することでモニタリングできます。これらのイベントは、NetApp ONTAP CLI を使用して閲覧できます。

トピック

EMS イベントの概要
EMS イベントを表示する
Syslog サーバーへの EMS イベント転送

EMS イベントの概要

EMS イベントとは、事前に定義した条件が FSx for ONTAP ファイルシステム発生したときに警告する、自動生成される通知のことです。これらの通知は、絶えず情報を提供することで、より大きな問題 (ストレージ仮想マシン (SVM) の認証問題やフルボリュームなど) につながる可能性のある問題の、予防または修正を可能にします。

デフォルトでは、イベントはイベント管理システムのログに記録されます。EMS を使用すれば、ユーザーパスワードが変更された、FlexGroup 内の構成要素が最大容量に達しつつある、論理ユニット番号 (LUN) が手動でオンラインまたはオフラインにされた、ボリュームが自動的にサイズ変更された、などのイベントをモニタリングできます。

ONTAP EMS イベントの詳細については、NetApp ONTAP ドキュメントセンターの「ONTAP EMS Reference」を参照してください。イベントカテゴリを表示するには、ドキュメントの左側にあるナビゲーションペインを使用します。

注記

ONTAP EMS メッセージの中には、FSx for ONTAP ファイルシステムで使用できないものがあります。使用可能な ONTAP EMS メッセージのリストを表示するには、NetApp ONTAP CLI イベントカタログ表示コマンドを使用します。

EMS イベントの説明には、イベント名、重大度、考えられる原因、ログメッセージ、そして、対応の仕方を決める際に役立つ是正措置が記されています。例えば、ボリュームの自動サイズ調整が失敗すると、wafl.vol.autoSize.fail イベントが発生します。このイベントの説明には、是正措置は、自動サイズ調整中にボリュームの最大サイズを増やすことと記されています。

EMS イベントを表示する

イベントログの内容を表示するときは、NetApp ONTAP CLI イベントログ表示コマンドを使用します。このコマンドは、お使いのファイルシステムに 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` の値に一致するイベントを選択します。次のいずれかになるはずです。 `EMERGENCY` — 中断 `ALERT` — 単一障害点 `ERROR` — 低下 `NOTICE` - 情報 `INFORMATIONAL` - 情報 `DEBUG` - デバッグ情報すべてのイベントを表示するには、重大度を以下のように指定します。 `event log show -severity <=DEBUG`
`-ems-severity ems_sev_level`	`ems_sev_level` の値に一致するイベントを選択します。以下のいずれかになるはずです。 `NODE_FAULT` — データの破損が検出されたか、ノードがクライアントサービスを提供できない。 `SVC_FAULT` — 一時的なサービスの中断 (通常は短時間のソフトウェア障害) が検出された。 `NODE_ERROR` — ハードウェアのエラーが検出された (ただし、直ちに復旧不可能になるレベルではない)。 `SVC_ERROR` — ソフトウェアのエラーが検出された (ただし、直ちに復旧不可能になるレベルではない)。 `WARNING` — 優先度の高いメッセージ。障害は示されていない。 `NOTICE` — 優先度が中程度のメッセージ。障害は示されていない。 `INFO` — 優先度の低いメッセージ。障害は示されていない。 `DEBUG` — デバッグメッセージ。 `VAR` — 実行時に選択された、重大度が変化する可能性のあるメッセージ。すべてのイベントを表示するには、重大度を以下のように指定します。 `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 イベントを表示するには

ファイルシステムの NetApp ONTAP CLI に SSH 接続するには、「Amazon FSx for NetApp ONTAP ユーザーガイド」の「NetApp ONTAP CLI の使用」のセクションに記載されているステップに従います。
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```

イベントログの内容を表示するときは、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」を参照してください。

Syslog サーバーへの EMS イベント転送

Syslog サーバーに通知を転送するように EMS イベントを設定できます。EMS イベント転送は、ファイルシステムのリアルタイムモニタリングに使用され、さまざまな問題の根本原因を判断および分離します。環境にイベント通知用の Syslog サーバーがまだ含まれていない場合は、まずサーバーを作成する必要があります。DNS は、Syslog サーバー名を解決するようにファイルシステムで設定する必要があります。

注記

Syslog の送信先は、ファイルシステムで使用されるプライマリサブネットにある必要があります。

Syslog サーバーに通知を転送するように EMS イベントを設定するには

ファイルシステムの NetApp ONTAP CLI に SSH 接続するには、「Amazon FSx for NetApp ONTAP ユーザーガイド」の「NetApp ONTAP CLI の使用」のセクションに記載されているステップに従います。
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```
イベント通知送信先の作成コマンドを使用して、次の属性を指定して、タイプ 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
```
イベント通知作成コマンドを使用して、前のステップで作成した通知先へのイベントフィルターで定義された一連のイベントの新しい通知を作成し、次の属性を指定します。
- node_name – イベントフィルターの名前。イベントフィルターに含まれるイベントは、-destinations パラメータで指定された送信先に転送されます。
- dest_name – イベント通知が送信される既存の通知先の名前。
```
::> event notification create -filter-name filter_name -destinations dest_name
```
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
```