监控 FSx ONTAP EMS 事件

PDF

RSS

聚焦模式

监控 FSx ONTAP EMS 事件 - FSx 适用于 ONTAP

EMS 事件概述查看 EMS 事件 EMS 事件转发到 Syslog 服务器

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

主题

EMS 事件概述
查看 EMS 事件
EMS 事件转发到 Syslog 服务器

EMS 事件概述

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

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

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

注意

只有一些 ONTAP EMS 消息可用 FSx 于 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/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 登录文件系统的 NetApp ONTAP CLI，请按照《Amazon for NetApp ONTAP 用户指南》中记录的步骤 FSx 进行操作。使用 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 事件的信息，请参阅 ONTAP 文档中心的《ONTAP EMS 参考》 NetApp 。

EMS 事件转发到 Syslog 服务器

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

注意

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

将 EMS 事件配置为转发通知至 Syslog 服务器。

要通过 SSH 登录文件系统的 NetApp ONTAP CLI，请按照《Amazon for NetApp ONTAP 用户指南》中记录的步骤 FSx 进行操作。使用 NetApp ONTAP CLI
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```
使用 event notification destination create 命令，创建类型为 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 - 采用传输层安全性协议 (TLS) 的传输控制协议。指定此选项后，fo FSx r 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
```
使用 event 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
```