As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Monitoramento de eventos EMS do FSx para ONTAP
Você pode monitorar os eventos do sistema de arquivos do FSx para ONTAP usando o Sistema de gerenciamento de eventos (EMS) nativo do NetApp ONTAP. É possível visualizar esses eventos usando a CLI do NetApp ONTAP.
**Topics**
+ [Visão geral dos eventos EMS](#ems-events-overview)
+ [Visualização de eventos EMS](#view-ems-events)
+ [Encaminhamento de eventos do EMS para um servidor Syslog](#ems-log-forwarding)
## Visão geral dos eventos EMS
Os eventos EMS são notificações geradas automaticamente que alertam você quando ocorre uma condição predefinida em seu sistema de arquivos do FSx para ONTAP. Essas notificações mantêm você informado para que você possa evitar ou corrigir problemas que podem levar a problemas maiores, como aqueles de autenticação de máquina virtual de armazenamento (SVM) ou volumes cheios.
Por padrão, os eventos são registrados no log do sistema de gerenciamento de eventos. Usando o EMS, você pode monitorar eventos como alterações de senha do usuário, um componente dentro de um FlexGroup se aproximando da capacidade total, um número de unidade lógica (LUN) colocado on-line ou off-line manualmente ou um volume redimensionado automaticamente.
Para obter mais informações sobre eventos EMS do ONTAP, consulte [Referência do EMS do ONTAP](https://docs.netapp.com/us-en/ontap-ems-9121/index.html) no Centro de documentação do NetApp ONTAP. Para exibir as categorias de eventos, use o painel de navegação esquerdo do documento.
**nota**
Somente algumas mensagens do EMS do ONTAP estão disponíveis para sistemas de arquivos do FSx para ONTAP. Para ver uma lista das mensagens EMS do ONTAP disponíveis, use o comando [event catalog show](https://docs.netapp.com/us-en/ontap-cli-9131/event-catalog-show.html) da CLI do NetApp ONTAP.
As descrições de eventos EMS contêm nomes de eventos, gravidade, possíveis causas, mensagens de log e ações corretivas que podem ajudar você a decidir como responder. Por exemplo, um evento [wafl.vol.autosize.Fail](https://docs.netapp.com/us-en/ontap-ems-9121/wafl-vol-events.html#wafl-vol-autosize-fail) ocorre quando o dimensionamento automático de um volume falha. De acordo com a descrição do evento, a ação corretiva é aumentar o tamanho máximo do volume ao definir o tamanho automático.
## Visualização de eventos EMS
Use o comando [event log show](https://docs.netapp.com/us-en/ontap-cli-9131/event-log-show.html) da CLI do NetApp ONTAP para exibir o conteúdo do log de eventos. Esse comando estará disponível se você tiver o perfil `fsxadmin` em seu sistema de arquivos. A sintaxe do comando é a seguinte:
```
event log show [{{event_options}}]
```
Os eventos mais recentes são listados primeiro. Por padrão, esse comando exibe os eventos de nível de gravidade `EMERGENCY`, `ALERT` e `ERROR` com as seguintes informações:
+ **Hora**: a hora do evento.
+ **Nó**: o nó em que o evento ocorreu.
+ **Gravidade**: o nível de gravidade do evento. Para exibir os eventos de nível de gravidade `NOTICE`, `INFORMATIONAL` ou `DEBUG`, use a opção `-severity`.
+ **Evento**: o nome e a mensagem do evento.
Para exibir informações detalhadas sobre eventos, use uma ou mais das opções de eventos listadas na tabela a seguir.
| Opção de evento | Descrição |
| --- | --- |
| `-detail` | Exibe informações adicionais sobre o evento. |
| `-detailtime` | Exibe informações detalhadas do evento em ordem cronológica inversa. |
| `-instance` | Exibe informações detalhadas sobre todos os campos. |
| `-node {{nodename}}\|local` | Exibe uma lista de eventos para o nó que você especifica. Use essa opção com `-seqnum` para exibir informações detalhadas. |
| `-seqnum {{sequence_number}}` | Seleciona os eventos que correspondem a esse número na sequência. Use com `-node` para exibir informações detalhadas. |
| `-time {{MM/DD/YYYY HH:MM:SS}}` | Seleciona os eventos que aconteceram nesse horário específico. Use o formato: MM/DD/AAAA HH:MM:SS [\+- HH:MM]. Você pode especificar um intervalo de tempo usando o operador `..` entre duas declarações de tempo.event log show -time "04/17/2023 05:55:00".."04/17/2023 06:10:00"
Os valores comparativos de tempo são relativos à hora atual quando você executa o comando. O exemplo a seguir mostra como exibir apenas eventos que ocorreram no último minuto:event log show -time >1m
Os campos de mês e data dessa opção não são preenchidos com zero. Esses campos podem ter dígito únicos; por exemplo, `4/1/2023 06:45:00`. |
| `-severity {{sev_level}}` | Seleciona os eventos que correspondem ao valor {{sev\_level}}, que deve ser um dos seguintes:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/fsx/latest/ONTAPGuide/ems-events.html)
Para exibir todos os eventos, especifique a gravidade da seguinte forma:event log show -severity <=DEBUG
|
| `-ems-severity {{ems_sev_level}}` | Seleciona os eventos que correspondem ao valor {{ems\_sev\_level}}, que deve ser um dos seguintes:[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/fsx/latest/ONTAPGuide/ems-events.html)
Para exibir todos os eventos, especifique a gravidade da seguinte forma:event log show -ems-severity <=DEBUG
|
| `-source {{text}}` | Seleciona os eventos que correspondem ao valor {{text}}. Normalmente, a fonte é um módulo de software. |
| `-message-name {{message_name}}` | Seleciona os eventos que correspondem ao valor {{message\_name}}. Os nomes das mensagens são descritivos; portanto, a filtragem da saída por nome da mensagem exibe mensagens de um tipo específico. |
| `-event {{text}}` | Seleciona os eventos que correspondem ao valor {{text}}. O campo `event` contém o texto completo do evento, incluindo todos os parâmetros. |
| `-kernel-generation-num {{integer}}` | Seleciona os eventos que correspondem ao valor {{integer}}. Somente eventos provenientes do kernel têm números de geração do kernel. |
| `-kernel-sequence-num {{integer}}` | Seleciona os eventos que correspondem ao valor {{integer}}. Somente eventos provenientes do kernel têm números de sequência do kernel. |
| `-action {{text}}` | Seleciona os eventos que correspondem ao valor {{text}}. O campo `action` descreve qual ação corretiva, se houver, você deve tomar para remediar a situação. |
| `-description {{text}}` | Seleciona os eventos que correspondem ao valor {{text}}. O campo `description` descreve por que o evento aconteceu e o que isso significa. |
| `-filter-name {{filter_name}}` | Seleciona os eventos que correspondem ao valor {{filter\_name}}. Somente os eventos incluídos pelos filtros existentes que correspondem a esse valor são exibidos. |
| `-fields {{fieldname}},...` | Indica que a saída do comando também inclui os campos especificados. Você pode usar `-fields ?` para escolher os campos que deseja especificar. |
**Visualizar eventos EMS**
1. Para efetuar SSH na CLI do NetApp ONTAP do sistema de arquivos, siga as etapas documentadas na seção [Usar a CLI do NetApp ONTAP](managing-resources-ontap-apps.md#netapp-ontap-cli) do *Guia do usuário do Amazon FSx para NetApp ONTAP*.
```
ssh fsxadmin@{{file-system-management-endpoint-ip-address}}
```
1. Use o comando `event log show` para exibir o conteúdo do log 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 obter informações sobre os eventos EMS retornados pelo comando `event log show`, consulte a [Referência do EMS do ONTAP](https://docs.netapp.com/us-en/ontap-ems-9121/index.html) no Centro de documentação do NetApp ONTAP.
## Encaminhamento de eventos do EMS para um servidor Syslog
Você pode configurar eventos do EMS para encaminhar notificações para um servidor Syslog. O encaminhamento de eventos do EMS é usado para monitorar em tempo real seu sistema de arquivos a fim de determinar e isolar as causas básicas de uma ampla variedade de problemas. Caso o ambiente ainda não tenha um servidor Syslog para notificações de eventos, será necessário criar um. O DNS deverá ser configurado no sistema de arquivos para resolver o nome do servidor Syslog.
**nota**
O destino do Syslog deve estar localizado na sub-rede primária usada pelo sistema de arquivos.
**Para configurar eventos do EMS para encaminhar notificações para um servidor Syslog**
1. Para efetuar SSH na CLI do NetApp ONTAP do sistema de arquivos, siga as etapas documentadas na seção [Usar a CLI do NetApp ONTAP](managing-resources-ontap-apps.md#netapp-ontap-cli) do *Guia do usuário do Amazon FSx para NetApp ONTAP*.
```
ssh fsxadmin@{{file-system-management-endpoint-ip-address}}
```
1. Use o comando [event notification destination create](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-destination-create.html) para criar um destino de notificação de eventos do tipo `syslog`, especificando os seguintes atributos:
+ `{{dest_name}}`: o nome do destino da notificação que deve ser criado (por exemplo, `syslog-ems`). O nome de um destino de notificação de evento deve ter de 2 a 64 caracteres. Os caracteres válidos são os seguintes caracteres ASCII: A-Z, a-z, 0-9, “\_” e “-”. O nome deve começar e terminar com: A-Z, a-z ou 0-9.
+ `{{syslog_name}}`: o nome do host ou endereço IP do servidor Syslog para o qual as mensagens do Syslog são enviadas.
+ `{{transport_protocol}}`: o protocolo usado para enviar os eventos.
+ `udp-unencrypted`: protocolo de datagrama de usuário sem segurança. Esse é o protocolo padrão.
+ `tcp-unencrypted`: protocolo de controle de transmissão sem segurança.
+ `tcp-encrypted`: o protocolo de controle de transmissão com Transport Layer Security (TLS). Quando essa opção é especificada, o FSx para ONTAP verifica a identidade do host de destino validando seu certificado.
+ `{{port_number}}`: a porta do servidor Syslog para o qual as mensagens do Syslog são enviadas. O parâmetro `syslog-port` com valor padrão depende da configuração do parâmetro `syslog-transport`. Se `syslog-transport` estiver definido como `tcp-encrypted`, o valor padrão de `syslog-port` será `6514`. Se `syslog-transport` estiver definido como `tcp-unencrypted`, `syslog-port` terá o valor padrão de `601`. Caso contrário, a porta padrão será definida como `514`.
```
::> event notification destination create -name {{dest_name}} -syslog {{syslog_name}} -syslog-transport {{transport_protocol}} -syslog-port {{port_number}}
```
1. Use o comando [event notification create](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-create.html) para criar uma nova notificação de um conjunto de eventos definido por um filtro de eventos para o destino da notificação criado na etapa anterior, especificando os seguintes atributos:
+ `{{node_name}}`: o nome do filtro de evento. Os eventos incluídos no filtro de eventos são encaminhados para os destinos especificados no parâmetro `-destinations`.
+ `{{dest_name}}`: o nome do destino de notificação existente para o qual as notificações de eventos são enviadas.
```
::> event notification create -filter-name {{filter_name}} -destinations {{dest_name}}
```
1. Se tiver selecionado TCP como o `{{transport_protocol}}`, você pode usar o comando `event notification destination check` para gerar uma mensagem de teste e verificar se a configuração funciona. Especifique os seguintes atributos com o comando:
+ `{{node_name}}`: o nome do nó (por exemplo, `FsxId07353f551e6b557b4-01`).
+ `{{dest_name}}`: o nome do destino de notificação existente para o qual as notificações de eventos são enviadas.
```
::> set diag
::*> event notification destination check -node {{node_name}} -destination-name {{dest_name}}
```