

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Monitorización de FSx para eventos ONTAP EMS
<a name="ems-events"></a>

Puede monitorizar FSx para detectar eventos del sistema de archivos ONTAP mediante el sistema de gestión de eventos (EMS) nativo de NetAPP ONTAP. Puede ver estos eventos mediante la CLI NetApp ONTAP.

**Topics**
+ [Información general sobre los eventos del EMS](#ems-events-overview)
+ [Visualización de eventos del EMS](#view-ems-events)
+ [Reenvío de eventos del EMS a un servidor Syslog](#ems-log-forwarding)

## Información general sobre los eventos del EMS
<a name="ems-events-overview"></a>

Los eventos del EMS son notificaciones generadas automáticamente que le avisan cuando se produce una condición predefinida en el sistema de archivos de FSx para 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 el EMS, puede supervisar eventos como los cambios de contraseña de usuario, un componente de un FlexGroup que se acerca a su capacidad máxima, un número de unidad lógica (LUN) que se conecta o desconecta manualmente o un volumen que se redimensiona automáticamente.

Para obtener más información sobre los eventos del EMS de ONTAP, consulte la [referencia de EMS de ONTAP](https://docs.netapp.com/us-en/ontap-ems-9121/index.html) 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 para FSx para los sistemas de archivos ONTAP. Para ver una lista de los mensajes del EMS de ONTAP disponibles, use el comando [event catalog show](https://docs.netapp.com/us-en/ontap-cli-9131/event-catalog-show.html) de la CLI de NetApp ONTAP.

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](https://docs.netapp.com/us-en/ontap-ems-9121/wafl-vol-events.html#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
<a name="view-ems-events"></a>

Use el comando de la CLI [event log show](https://docs.netapp.com/us-en/ontap-cli-9131/event-log-show.html) de NetApp ONTAP 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/AAAA HH:MM:SS [\+- HH:MM]. Puede especificar un intervalo de tiempo mediante el operador `..` entre dos marcas de tiempo.<pre>event log show -time "04/17/2023 05:55:00".."04/17/2023 06:10:00"</pre><br />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:<pre>event log show -time >1m</pre><br />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 valor {{sev\_level}}, que debe ser uno de los siguientes:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/fsx/latest/ONTAPGuide/ems-events.html)<br />Para mostrar todos los eventos, especifique la gravedad de la siguiente manera:<pre>event log show -severity <=DEBUG</pre> | 
| `-ems-severity {{ems_sev_level}}` | Selecciona los eventos que coinciden con el valor {{ems\_sev\_level}}, que debe ser uno de los siguientes:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/fsx/latest/ONTAPGuide/ems-events.html)<br />Para mostrar todos los eventos, especifique la gravedad de la siguiente manera:<pre>event log show -ems-severity <=DEBUG</pre> | 
| `-source {{text}}` | Selecciona los eventos que coinciden con el valor del {{texto}}. La fuente suele ser un módulo de software. | 
| `-message-name {{message_name}}` | Selecciona los eventos que coinciden con el valor del {{message\_name}}. 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 valor del {{texto}}. El campo `event` contiene el texto completo del evento, incluidos los parámetros. | 
| `-kernel-generation-num {{integer}}` | Selecciona los eventos que coinciden con el valor {{entero}}. 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 valor {{entero}}. 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 valor del {{texto}}. 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 valor del {{texto}}. El campo `description` describe por qué ocurrió el evento y qué significa. | 
| `-filter-name {{filter_name}}` | Selecciona los eventos que coinciden con el valor del {{filter\_name}}. 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**

1. Para conectarse mediante SSH a la CLI de NetApp ONTAP de su sistema de archivos, siga los pasos descritos en la sección [Uso de la CLI de NetApp ONTAP](managing-resources-ontap-apps.md#netapp-ontap-cli) de la *Guía del usuario de Amazon FSx para NetApp ONTAP*.

   ```
   ssh fsxadmin@{{file-system-management-endpoint-ip-address}}
   ```

1. 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 del EMS devueltos por el comando `event log show`, consulte la [referencia del EMS de ONTAP](https://docs.netapp.com/us-en/ontap-ems-9121/index.html) en el Centro de documentación de NetApp ONTAP.

## Reenvío de eventos del EMS a un servidor Syslog
<a name="ems-log-forwarding"></a>

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**

1.  Para conectarse mediante SSH a la CLI de NetApp ONTAP de su sistema de archivos, siga los pasos descritos en la sección [Uso de la CLI de NetApp ONTAP](managing-resources-ontap-apps.md#netapp-ontap-cli) de la *Guía del usuario de Amazon FSx para NetApp ONTAP*.

   ```
   ssh fsxadmin@{{file-system-management-endpoint-ip-address}}
   ```

1. Use el comando [event notification destination create](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-destination-create.html) 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). Cuando se especifica esta opción, FSx para 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}}
   ```

1. Use el comando [event notification create](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-create.html) 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}}
   ```

1. 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}}
   ```