FSx 監控ONTAPEMS事件

您可以使用 NetAPP ONTAP的原生事件管理系統 () FSx監控ONTAP檔案系統事件EMS。您可以使用檢視這些事件 NetAppONTAPCLI。

主題

EMS 事件概觀
檢視 EMS 事件
EMS 事件轉送至 Syslog 伺服器

EMS 事件概觀

EMS 事件會自動產生通知，在FSxONTAP檔案系統的中發生預先定義的條件時提醒您。這些通知會通知您，以便您可以防止或修正可能導致較大問題的問題，例如儲存虛擬機器 (SVM) 身分驗證問題或完整磁碟區。

根據預設，事件會記錄在事件管理系統日誌中。使用 EMS，您可以監控事件，例如使用者密碼變更、 FlexGroup 接近完整容量的成分、邏輯單位號碼 (LUN) 已手動上線或離線，或磁碟區自動調整大小。

如需ONTAPEMS事件的詳細資訊，請參閱文件中心的ONTAPEMS參考 NetApp ONTAP。若要顯示事件類別，請使用文件的左側導覽窗格。

注意

只有部分ONTAPEMS訊息FSx可用於 ONTAP 檔案系統。若要檢視可用ONTAPEMS訊息的清單，請使用CLI事件目錄 show NetApp ONTAP命令。

EMS 事件描述包含事件名稱、嚴重性、可能的原因、日誌訊息和修正動作，可協助您決定如何回應。例如，當磁碟區的自動調整大小失敗時，會發生 wafl.volautoSize..fail 事件。根據事件描述，修正動作是在設定自動調整大小時增加磁碟區的大小上限。

檢視 EMS 事件

使用 NetApp ONTAPCLI事件日誌 show 命令來顯示事件日誌的內容。如果您在檔案系統上具有 fsxadmin角色，即可使用此命令。命令語法如下所示：


event log show [event_options]

首先列出最新的事件。根據預設，此命令會顯示 EMERGENCY、 ALERT和 ERROR嚴重性層級事件，其中包含下列資訊：

時間 – 事件的時間。
Node – 事件發生的節點。
嚴重性 – 事件的嚴重性層級。若要顯示 NOTICE、 INFORMATIONAL或 DEBUG嚴重性層級事件，請使用 -severity選項。
事件 – 事件名稱和訊息。

若要顯示事件的詳細資訊，請使用下表所列的一或多個事件選項。

事件選項	描述
`-detail`	顯示其他事件資訊。
`-detailtime`	以反向時間順序顯示詳細事件資訊。
`-instance`	顯示所有欄位的詳細資訊。
`-node nodename\|local`	顯示您指定之節點的事件清單。使用此選項搭配 `-seqnum` 顯示詳細資訊。
`-seqnum sequence_number`	選取符合序列中此數字的事件。使用搭配 `-node` 顯示詳細資訊。
`-time MM/DD/YYYY HH:MM:SS`	選取在此特定時間發生的事件。使用格式：MM/DD/YYYYHH：MM：SS 【+- HH：MM】。您可以在兩個時間陳述式之間使用`..`運算子來指定時間範圍。 `event log show -time "04/17/2023 05:55:00".."04/17/2023 06:10:00"` 比較時間值是相對於您執行命令時的目前時間。下列範例顯示如何僅顯示最後一分鐘內發生的事件： `event log show -time >1m` 此選項的月份和日期欄位不是零填充。這些欄位可以是單一數字；例如 `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-sequence-num integer`	選取符合`integer`值的事件。只有來自核心的事件具有核心序號。
`-action text`	選取符合 `text`值的事件。`action` 欄位說明若有修正動作，您必須採取哪些修正動作來修正情況。
`-description text`	選取符合 `text`值的事件。`description` 欄位說明事件發生的原因及其意義。
`-filter-name filter_name`	選取符合 `filter_name`值的事件。只有符合此值的現有篩選條件包含的事件才會顯示。
`-fields fieldname,...`	表示命令輸出也包含指定的欄位。您可以使用 `-fields ?`來選擇要指定的欄位。

檢視 EMS 事件

若要SSH進入CLI檔案系統的 NetApp ONTAP，請遵循 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 文件中心的ONTAPEMS參考。

EMS 事件轉送至 Syslog 伺服器

您可以設定EMS事件將通知轉送至 Syslog 伺服器。EMS事件轉送用於即時監控檔案系統，以判斷和隔離各種問題的根本原因。如果您的環境尚未包含事件通知的 Syslog 伺服器，您必須先建立一個。DNS必須在檔案系統上設定以解析 Syslog 伺服器名稱。

注意

您的 Syslog 目的地必須位於檔案系統使用的主要子網路中。

設定EMS事件以將通知轉送至 Syslog 伺服器

若要SSH進入CLI檔案系統的 NetApp ONTAP，請遵循 Amazon FSx for NetApp ONTAP 使用者指南 使用 NetApp ONTAP CLI一節中記載的步驟。
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```
使用事件通知目的地建立命令來建立類型的事件通知目的地syslog，指定下列屬性：
- dest_name – 要建立的通知目的地名稱（例如 syslog-ems)。事件通知目的地名稱長度必須為 2 到 64 個字元。有效字元包括下列ASCII字元：A-Z、a-z、0-9、"_" 和 "-"。名稱必須以 A-Z、a-z 或 0-9 開頭和結尾。
- syslog_name – 傳送 Syslog 訊息的 Syslog 伺服器主機名稱或 IP 地址。
- transport_protocol – 用來傳送事件的通訊協定：
  - udp-unencrypted – 無安全性的使用者資料包通訊協定。這是預設通訊協定。
  - tcp-unencrypted – 無安全性的傳輸控制通訊協定。
  - tcp-encrypted – 具有 Transport Layer Security () 的傳輸控制通訊協定TLS。指定此選項時， FSx 對於 ONTAP 驗證目的地主機的憑證，驗證其身分。
- port_number – 傳送 Syslog 訊息的 Syslog 伺服器連接埠。預設值syslog-port參數取決於 syslog-transport 參數的設定。如果 syslog-transport 設定為 tcp-encrypted，syslog-port則預設值為 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
```

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

磁碟區指標

使用 Cloud Insights 監控