Supervisión FSx de eventos EMS de ONTAP

Modo de enfoque

Supervisión FSx de eventos EMS de ONTAP - FSx para ONTAP

Información general sobre los eventos del EMS Visualización de eventos del EMS Reenvío de eventos del EMS a un servidor Syslog

Puede supervisar los eventos del sistema FSx de archivos de ONTAP mediante el sistema de gestión de eventos (EMS) nativo de ONTAP de NetApp. Puede ver estos eventos mediante la CLI de NetApp ONTAP.

Temas

Información general sobre los eventos del EMS
Visualización de eventos del EMS
Reenvío de eventos del EMS a un servidor Syslog

Información general sobre los eventos del EMS

Los eventos de EMS son notificaciones generadas automáticamente que le avisan cuando se produce una condición predefinida en el sistema de archivos FSx de ONTAP. Estas notificaciones lo mantienen informado para que pueda prevenir o corregir problemas que pueden provocar problemas mayores, como problemas de autenticación de las máquinas virtuales de almacenamiento (SVM) o los volúmenes llenos.

De forma predeterminada, los eventos se registran en el registro del sistema de administración de eventos. Con EMS, puede monitorizar eventos como los cambios en la contraseña de un usuario, el hecho de que un componente FlexGroup se aproxime a su capacidad máxima, la conexión o desconexión manual de un número de unidad lógica (LUN) o el cambio de tamaño automático de un volumen.

Para obtener más información sobre los eventos EMS de ONTAP, consulte la referencia de EMS de ONTAP en el Centro de documentación de NetApp ONTAP. Para mostrar las categorías de eventos, utilice el panel de navegación izquierdo del documento.

nota

Solo algunos mensajes EMS de ONTAP están disponibles FSx para los sistemas de archivos de ONTAP. Para ver una lista de los mensajes EMS de ONTAP disponibles, utilice el comando show del catálogo de eventos de NetApp ONTAP CLI.

Las descripciones de los eventos del EMS contienen los nombres, la gravedad, las posibles causas, los mensajes de registro y las acciones correctivas que pueden ayudarle a decidir cómo responder. Por ejemplo, un evento wafl.vol.autoSize.fail se produce cuando no se puede ajustar automáticamente el tamaño de un volumen. Según la descripción del evento, la acción correctiva consiste en aumentar el tamaño máximo del volumen y, al mismo tiempo, configurar el tamaño automático.

Visualización de eventos del EMS

Utilice el comando NetApp ONTAP CLI event log show para mostrar el contenido del registro de eventos. Este comando está disponible si tiene el rol fsxadmin en su sistema de archivos. La sintaxis del comando es la siguiente:


event log show [event_options]

Se muestran primero los eventos más recientes. De forma predeterminada, este comando muestra los eventos del nivel de gravedad EMERGENCY, ALERT y ERROR con la siguiente información:

Time: la hora del evento.
Node: el nodo en el que se produjo el evento.
Severity: el nivel de gravedad del evento. Para mostrar los eventos de nivel de gravedad NOTICE, INFORMATIONAL o DEBUG, utilice la opción -severity.
Event: el nombre y el mensaje del evento.

Para mostrar información detallada sobre los eventos, utilice una o más de las opciones de eventos que se muestran en la tabla siguiente.

Opciones de eventos	Descripción
`-detail`	Muestra información adicional sobre el evento.
`-detailtime`	Muestra la información detallada de eventos en orden cronológico inverso.
`-instance`	Muestra información detallada sobre todos los campos.
`-node nodename\|local`	Muestra una lista de eventos del nodo que especifique. Utilice esta opción con `-seqnum` para mostrar información detallada.
`-seqnum sequence_number`	Selecciona los eventos de la secuencia que coinciden con este número. Utilice esta opción con `-node` para mostrar información detallada.
`-time MM/DD/YYYY HH:MM:SS`	Selecciona los eventos que ocurrieron en este momento específico. Utilice el formato: MM/DD/YYYY HH:MM:SS [+- HH:MM]. Puede especificar un intervalo de tiempo mediante el operador `..` entre dos marcas de tiempo. `event log show -time "04/17/2023 05:55:00".."04/17/2023 06:10:00"` Los valores de tiempo comparativos son relativos a la hora actual en la que se ejecuta el comando. En el ejemplo siguiente, se indica cómo mostrar únicamente los eventos que se produjeron en el último minuto: `event log show -time >1m` Los campos de mes y fecha de esta opción no están rellenados con ceros. Estos campos pueden ser de un solo dígito; por ejemplo, `4/1/2023 06:45:00`.
`-severity sev_level`	Selecciona los eventos que coinciden con el `sev_level` valor, que debe ser uno de los siguientes: `EMERGENCY`: interrupción `ALERT`: punto único de error `ERROR`: degradación `NOTICE`: información `INFORMATIONAL`: información `DEBUG`: información sobre depuración Para mostrar todos los eventos, especifique la gravedad de la siguiente manera: `event log show -severity <=DEBUG`
`-ems-severity ems_sev_level`	Selecciona los eventos que coinciden con el `ems_sev_level` valor, que debe ser uno de los siguientes: `NODE_FAULT`: se detecta un daño en los datos o el nodo no puede proporcionar el servicio de atención al cliente. `SVC_FAULT`: se detecta una pérdida temporal de servicio (normalmente un error de software transitorio). `NODE_ERROR`: se detecta un error de hardware que no es inmediatamente fatal. `SVC_ERROR`: se detecta un error de software que no es inmediatamente fatal. `WARNING`: un mensaje de alta prioridad que no indica ningún error. `NOTICE`: un mensaje de prioridad normal que no indica ningún error. `INFO`: un mensaje de baja prioridad que no indica ningún error. `DEBUG`: un mensaje de depuración. `VAR`: un mensaje de gravedad variable, seleccionado en tiempo de ejecución. Para mostrar todos los eventos, especifique la gravedad de la siguiente manera: `event log show -ems-severity <=DEBUG`
`-source text`	Selecciona los eventos que coinciden con el `text` valor. La fuente suele ser un módulo de software.
`-message-name message_name`	Selecciona los eventos que coinciden con el `message_name` valor. Los nombres de los mensajes son descriptivos, por lo que filtrar la salida por nombre de mensaje muestra mensajes de un tipo específico.
`-event text`	Selecciona los eventos que coinciden con el `text` valor. El campo `event` contiene el texto completo del evento, incluidos los parámetros.
`-kernel-generation-num integer`	Selecciona los eventos que coinciden con el `integer` valor. Solo los eventos que provienen del núcleo tienen números de generación del núcleo.
`-kernel-sequence-num integer`	Selecciona los eventos que coinciden con el `integer` valor. Solo los eventos que provienen del núcleo tienen números de generación del núcleo.
`-action text`	Selecciona los eventos que coinciden con el `text` valor. El campo `action` describe qué medidas correctivas, si las hay, debe tomar para corregir la situación.
`-description text`	Selecciona los eventos que coinciden con el `text` valor. El campo `description` describe por qué ocurrió el evento y qué significa.
`-filter-name filter_name`	Selecciona los eventos que coinciden con el `filter_name` valor. Solo se muestran los eventos incluidos en los filtros existentes que coinciden con este valor.
`-fields fieldname,...`	Indica que el resultado del comando también incluye el campo o los campos especificados. Puede utilizar `-fields ?` para elegir los campos que desee especificar.

Cómo visualizar los eventos del EMS

Para conectarse mediante SSH a la NetApp CLI de ONTAP de su sistema de archivos, siga los pasos descritos en la Uso de NetApp ONTAP CLI sección de la Guía del usuario de Amazon FSx for NetApp ONTAP.
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```

Utilice el comando event log show para mostrar el contenido del registro de eventos.


::> 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.

Para obtener información sobre los eventos de EMS devueltos por el event log show comando, consulte la referencia de EMS de ONTAP en el NetApp centro de documentación de ONTAP.

Reenvío de eventos del EMS a un servidor Syslog

Puede configurar los eventos del EMS para reenviar notificaciones a un servidor Syslog. El reenvío de eventos del EMS se utiliza para supervisar en tiempo real el sistema de archivos a fin de determinar y aislar las causas fundamentales de una amplia gama de problemas. Si su entorno no contiene aún un servidor Syslog para notificaciones de eventos, primero debe crear uno. El DNS debe estar configurado en el sistema de archivos para resolver el nombre del servidor Syslog.

nota

El destino de Syslog debe ubicarse en la subred principal que usa el sistema de archivos.

Cómo configurar eventos del EMS para reenviar notificaciones a un servidor de Syslog

Para conectarse mediante SSH a la NetApp CLI de ONTAP de su sistema de archivos, siga los pasos descritos en la Uso de NetApp ONTAP CLI sección de la Guía del usuario de Amazon FSx for NetApp ONTAP.
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```
Use el comando event notification destination create para crear un destino de notificación de eventos de tipo syslog y especifique los siguientes atributos:
- dest_name: el nombre del destino de la notificación que se va a crear (por ejemplo, syslog-ems). El nombre del destino de una notificación de evento debe tener una longitud de entre 2 y 64 caracteres. Los caracteres válidos son los siguientes caracteres ASCII A-Z, a-z, 0-9, “_” y “-”. El nombre debe empezar y terminar por A-Z, a-z o 0-9.
- syslog_name: el nombre de host del servidor de Syslog o la dirección IP a la que se envían los mensajes de Syslog.
- transport_protocol: el protocolo que se usa para enviar los eventos.
  - udp-unencrypted: protocolo de datagramas de usuario sin seguridad. Es el protocolo TCP predeterminado.
  - tcp-unencrypted: protocolo de control de transmisión sin seguridad.
  - tcp-encrypted: protocolo de control de transmisión con seguridad de la capa de transporte (TLS). Si se especifica esta opción, FSx ya que ONTAP verifica la identidad del host de destino validando su certificado.
- port_number: el puerto del servidor de Syslog al que se envían los mensajes de Syslog. El parámetro syslog-port de valor predeterminado depende de la configuración del parámetro syslog-transport. Si syslog-transport se establece en tcp-encrypted, el valor predeterminado syslog-port es 6514. Si syslog-transport se establece en tcp-unencrypted, syslog-port tiene el valor predeterminado 601. De lo contrario, el puerto predeterminado se establece en 514.
```
::> event notification destination create -name dest_name -syslog syslog_name -syslog-transport transport_protocol -syslog-port port_number
```
Use el comando event notification create para crear una nueva notificación de un conjunto de eventos definido por un filtro de eventos para el destino de la notificación creada en el paso anterior. Especifique los siguientes atributos:
- node_name: el nombre del filtro de eventos. Los eventos que se incluyen en el filtro de eventos se reenvían a los destinos especificados en el parámetro -destinations.
- dest_name: el nombre del destino de notificación existente al que se envían las notificaciones de eventos.
```
::> event notification create -filter-name filter_name -destinations dest_name
```
Si seleccionó TCP como transport_protocol, puede usar el comando event notification destination check para generar un mensaje de prueba y comprobar que la configuración funciona. Especifique los siguientes atributos con el comando:
- node_name: el nombre del nodo (por ejemplo, FsxId07353f551e6b557b4-01).
- dest_name: el nombre del destino de notificación existente al que se envían las notificaciones de eventos.
```
::> set diag
::*> event notification destination check -node node_name -destination-name dest_name
```