监控 FSx for ONTAP EMS 事件

您可以使用 NetAPP ONTAP 的本机事件管理系统（EMS）监控 FSx for ONTAP 文件系统事件。您可以使用 NetApp ONTAP CLI 查看这些事件。

主题

EMS 事件概述
查看 EMS 事件
EMS 事件转发到系统日志服务器

EMS 事件概述

EMS 事件是自动生成的通知，当你的 FSx for ONTAP 文件系统出现预定义的情况时，这些通知会提醒你。这些通知可让您随时了解情况，以便预防或纠正问题，避免导致更大问题，例如存储虚拟机（SVM）身份验证问题或卷已满。

默认情况下，事件会记录在事件管理系统日志中。使用 EMS，您可以监控诸如用户密码更改、容量 FlexGroup 接近满、逻辑单元号 (LUN) 已手动联机或脱机或卷大小自动调整等事件。

有关 ONTAP EMS 事件的更多信息，请参阅 ONTAP 文档中心的 “ONTAP EMS 参考 NetApp ”。要显示事件类别，请使用文档的左侧导航窗格。

注意

仅部分 ONTAP EMS 消息适用于 FSx for ONTAP 文件系统。要查看可用 ONTAP EMS 消息的列表，请使用 ONTAP NetApp CLI 事件目录 show 命令。

EMS 事件描述包含事件名称、严重性、可能的原因、日志消息和纠正措施，可帮助您决定如何响应。例如，当自动调整卷大小失败时即会发生 wafl.vol.autoSize.fail 事件。根据事件描述，纠正措施是在设置自动调整大小的同时增加最大卷的大小。

查看 EMS 事件

使用 NetApp ONTAP CLI 事件日志 show 命令显示事件日志的内容。如果您在文件系统上具有 fsxadmin 角色，则此命令适用。命令语法如下所示：


event log show [event_options]

最近的事件列在最前面。默认情况下，此命令会显示 EMERGENCY、ALERT、和 ERROR 严重性等级事件，其中包含以下信息：

时间 – 事件的时间。
节点 –发生事件的节点。
严重性 –事件的严重性等级。要显示 NOTICE、INFORMATIONAL、或 DEBUG 严重性等级事件，请使用 -severity 选项。
事件 –事件名称和消息。

要显示有关事件的详细信息，请使用下表中列出的一个或多个事件选项。

事件选项	描述
`-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]。您可以通过在两个时间语句之间使用 `..` 运算符来指定时间范围。 `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`	选择与`文本`值匹配的事件。源代码通常是软件模块。
`-message-name message_name`	选择与 `message_name` 值匹配的事件。消息名称是描述性的，因此按消息名称筛选输出会显示特定类型的消息。
`-event text`	选择与`文本`值匹配的事件。`event` 字段包含事件全文，包括任何参数。
`-kernel-generation-num integer`	选择与`整数`值匹配的事件。仅来自内核的事件具有内核生成号。
`-kernel-sequence-num integer`	选择与`整数`值匹配的事件。仅来自内核的事件具有内核序列号。
`-action text`	选择与`文本`值匹配的事件。`action` 字段描述了您必须采取哪些纠正措施（如果有）来纠正这种情况。
`-description text`	选择与`文本`值匹配的事件。`description` 字段描述了事件发生的原因及其含义。
`-filter-name filter_name`	选择与 `filter_name` 值匹配的事件。只有与该值匹配的现有筛选条件所包含的事件才会显示。
`-fields fieldname,...`	表示命令输出中还包括指定的一个或多个字段。您可以使用 `-fields ?` 选择想要指定的字段。

查看 EMS 事件

要通过 SSH 登录文件系统的 NetApp ONTAP CLI，请按照《适用于 ONTAP 的 Amazon FSx 用户指南》一使用 NetApp ONTAP CLI节中记录的步骤 NetApp 进行操作。
```
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 事件的信息，请参阅 ONTAP 文档中心的《ONTAP EMS 参考》 NetApp 。

EMS 事件转发到系统日志服务器

您可以将 EMS 事件配置为将通知转发到 Syslog 服务器。EMS 事件转发用于实时监控您的文件系统，以确定和隔离各种问题的根本原因。如果您的环境中还没有用于事件通知的 Syslog 服务器，则必须先创建一个 Syslog 服务器。必须在文件系统上配置 DNS 才能解析 Syslog 服务器名称。

注意

您的 Syslog 目标必须位于文件系统使用的主子网中。

配置 EMS 事件以将通知转发到 Syslog 服务器

要通过 SSH 登录文件系统的 NetApp ONTAP CLI，请按照《适用于 ONTAP 的 Amazon FSx 用户指南》一使用 NetApp ONTAP CLI节中记录的步骤 NetApp 进行操作。
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```
使用事件通知目的地 create 命令创建类型为的事件通知目的地syslog，指定以下属性：
- dest_name— 要创建的通知目标的名称（例如，syslog-ems）。事件通知目标名称的长度必须为 2 到 64 个字符。有效字符是以下 ASCII 字符：A-Z、a-z、0-9、“_” 和 “-”。名称的开头和结尾必须是：A-Z、a-z 或 0-9。
- syslog_name— 系统日志消息发送到的系统日志服务器主机名或 IP 地址。
- transport_protocol— 用于发送事件的协议：
  - udp-unencrypted— 没有安全性的用户数据报协议。这是默认协议。
  - tcp-unencrypted— 没有安全性的传输控制协议。
  - tcp-encrypted— 具有传输层安全性 (TLS) 的传输控制协议。指定此选项后，FSx for ONTAP 将通过验证目标主机的证书来验证其身份。
- port_number— 系统日志消息发送到的 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
```
使用 e vent notification create 命令为事件过滤器定义的一组事件创建新的通知，发送到在上一步中创建的通知目的地，并指定以下属性：
- 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 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

卷指标

使用 Cloud Insights 监控