Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Surveillance FSx des événements ONTAP EMS
Vous pouvez surveiller FSx les événements du système de fichiers ONTAP à l'aide du système de gestion des événements (EMS) natif de NetApp ONTAP. Vous pouvez consulter ces événements à l'aide de la CLI NetApp ONTAP.
**Topics**
+ [Vue d'ensemble des événements EMS](#ems-events-overview)
+ [Affichage des événements EMS](#view-ems-events)
+ [Transfert d'événements EMS vers un serveur Syslog](#ems-log-forwarding)
## Vue d'ensemble des événements EMS
Les événements EMS sont des notifications générées automatiquement qui vous alertent lorsqu'une condition prédéfinie se produit dans votre système de fichiers FSx for ONTAP. Ces notifications vous tiennent informés afin que vous puissiez prévenir ou corriger les problèmes susceptibles d'entraîner des problèmes plus importants, tels que les problèmes d'authentification des machines virtuelles de stockage (SVM) ou les volumes complets.
Par défaut, les événements sont enregistrés dans le journal du système de gestion des événements. À l'aide d'EMS, vous pouvez surveiller des événements tels que les changements de mot de passe utilisateur, un composant FlexGroup dont la capacité est presque maximale, un numéro d'unité logique (LUN) mis en ligne ou hors ligne manuellement ou le redimensionnement automatique d'un volume.
Pour plus d'informations sur les événements ONTAP EMS, consultez le document de [référence ONTAP EMS](https://docs.netapp.com/us-en/ontap-ems-9121/index.html) dans le centre de documentation NetApp ONTAP. Pour afficher les catégories d'événements, utilisez le volet de navigation de gauche du document.
**Note**
Seuls certains messages ONTAP EMS sont disponibles FSx pour les systèmes de fichiers ONTAP. Pour afficher la liste des messages ONTAP EMS disponibles, utilisez la NetApp commande ONTAP CLI [event catalog show](https://docs.netapp.com/us-en/ontap-cli-9131/event-catalog-show.html).
Les descriptions des événements EMS contiennent les noms des événements, leur gravité, leurs causes possibles, les messages de journal et les actions correctives qui peuvent vous aider à décider comment réagir. Par exemple, un événement [wafl.vol.autosize.Fail se produit lorsque le dimensionnement automatique d'un volume échoue.](https://docs.netapp.com/us-en/ontap-ems-9121/wafl-vol-events.html#wafl-vol-autosize-fail) Selon la description de l'événement, l'action corrective consiste à augmenter la taille maximale du volume lors du réglage du dimensionnement automatique.
## Affichage des événements EMS
Utilisez la commande NetApp ONTAP CLI [event log show](https://docs.netapp.com/us-en/ontap-cli-9131/event-log-show.html) pour afficher le contenu du journal des événements. Cette commande est disponible si vous détenez le `fsxadmin` rôle dans votre système de fichiers. La syntaxe de la commande est la suivante :
```
event log show [event_options]
```
Les événements les plus récents sont listés en premier. Par défaut, cette commande affiche `EMERGENCY``ALERT`, et les événements de `ERROR` niveau de gravité avec les informations suivantes :
+ **Heure** : heure de l'événement.
+ **Nœud** : nœud sur lequel l'événement s'est produit.
+ **Gravité** : niveau de gravité de l'événement. Pour afficher `NOTICE` des événements ou `INFORMATIONAL` des événements de `DEBUG` niveau de gravité, utilisez l'`-severity`option.
+ **Événement** : nom et message de l'événement.
Pour afficher des informations détaillées sur les événements, utilisez une ou plusieurs des options d'événements répertoriées dans le tableau suivant.
| Option d'événement | Description |
| --- | --- |
| `-detail` | Affiche des informations supplémentaires sur les événements. |
| `-detailtime` | Affiche des informations détaillées sur les événements dans l'ordre chronologique inverse. |
| `-instance` | Affiche des informations détaillées sur tous les champs. |
| `-node nodename\|local` | Affiche la liste des événements pour le nœud que vous spécifiez. Utilisez cette option `-seqnum` pour afficher des informations détaillées. |
| `-seqnum sequence_number` | Sélectionne les événements correspondant à ce numéro dans la séquence. Utilisez avec `-node` pour afficher des informations détaillées. |
| `-time MM/DD/YYYY HH:MM:SS` | Sélectionne les événements survenus à ce moment précis. Utilisez le format : MM/DD/YYYY HH:MM:SS [\$1- HH:MM]. Vous pouvez spécifier une plage de temps en utilisant l'`..`opérateur entre deux instructions temporelles. event log show -time "04/17/2023 05:55:00".."04/17/2023 06:10:00"
Les valeurs temporelles comparatives sont relatives à l'heure actuelle à laquelle vous exécutez la commande. L'exemple suivant montre comment afficher uniquement les événements survenus au cours de la dernière minute : event log show -time >1m
Les champs de mois et de date de cette option ne sont pas remplis à zéro. Ces champs peuvent être composés d'un seul chiffre ; par exemple,`4/1/2023 06:45:00`. |
| `-severity sev_level` | Sélectionne les événements correspondant à la *sev\$1level* valeur, qui doit être l'une des suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/fsx/latest/ONTAPGuide/ems-events.html) Pour afficher tous les événements, spécifiez leur gravité comme suit : event log show -severity <=DEBUG
|
| `-ems-severity ems_sev_level` | Sélectionne les événements correspondant à la *ems\$1sev\$1level* valeur, qui doit être l'une des suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/fsx/latest/ONTAPGuide/ems-events.html) Pour afficher tous les événements, spécifiez leur gravité comme suit : event log show -ems-severity <=DEBUG
|
| `-source text` | Sélectionne les événements correspondant à la *text* valeur. La source est généralement un module logiciel. |
| `-message-name message_name` | Sélectionne les événements correspondant à la *message\$1name* valeur. Les noms des messages étant descriptifs, le filtrage de la sortie par nom de message permet d'afficher les messages d'un type spécifique. |
| `-event text` | Sélectionne les événements correspondant à la *text* valeur. Le `event` champ contient le texte intégral de l'événement, y compris les paramètres éventuels. |
| `-kernel-generation-num integer` | Sélectionne les événements correspondant à la *integer* valeur. Seuls les événements qui proviennent du noyau ont des numéros de génération du noyau. |
| `-kernel-sequence-num integer` | Sélectionne les événements correspondant à la *integer* valeur. Seuls les événements qui proviennent du noyau ont des numéros de séquence du noyau. |
| `-action text` | Sélectionne les événements correspondant à la *text* valeur. Le `action` champ décrit les mesures correctives que vous devez prendre, le cas échéant, pour remédier à la situation. |
| `-description text` | Sélectionne les événements correspondant à la *text* valeur. Le `description` champ décrit pourquoi l'événement s'est produit et ce que cela signifie. |
| `-filter-name filter_name` | Sélectionne les événements correspondant à la *filter\$1name* valeur. Seuls les événements inclus par les filtres existants qui correspondent à cette valeur s'affichent. |
| `-fields fieldname,...` | Indique que la sortie de commande inclut également le ou les champs spécifiés. Vous pouvez l'`-fields ?`utiliser pour sélectionner les champs que vous souhaitez spécifier. |
**Pour consulter les événements EMS**
1. Pour accéder en SSH à la NetApp CLI ONTAP de votre système de fichiers, suivez les étapes décrites dans la [Utilisation de l’NetApp ONTAP CLI](managing-resources-ontap-apps.md#netapp-ontap-cli) section du guide de l'utilisateur d'*Amazon FSx pour NetApp ONTAP*.
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```
1. Utilisez la `event log show` commande pour afficher le contenu du journal des événements.
```
::> 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.
```
Pour plus d'informations sur les événements EMS renvoyés par la `event log show` commande, reportez-vous à la [référence ONTAP EMS](https://docs.netapp.com/us-en/ontap-ems-9121/index.html) dans le centre de documentation NetApp ONTAP.
## Transfert d'événements EMS vers un serveur Syslog
Vous pouvez configurer les événements EMS pour transférer les notifications à un serveur Syslog. Le transfert d'événements EMS est utilisé pour surveiller en temps réel votre système de fichiers afin de déterminer et d'isoler les causes profondes d'un large éventail de problèmes. Si votre environnement ne contient pas encore de serveur Syslog pour les notifications d'événements, vous devez d'abord en créer un. Le DNS doit être configuré sur le système de fichiers pour résoudre le nom du serveur Syslog.
**Note**
Votre destination Syslog doit se trouver dans le sous-réseau principal utilisé par votre système de fichiers.
**Pour configurer les événements EMS afin de transférer les notifications à un serveur Syslog**
1. Pour accéder en SSH à la NetApp CLI ONTAP de votre système de fichiers, suivez les étapes décrites dans la [Utilisation de l’NetApp ONTAP CLI](managing-resources-ontap-apps.md#netapp-ontap-cli) section du guide de l'utilisateur d'*Amazon FSx pour NetApp ONTAP*.
```
ssh fsxadmin@file-system-management-endpoint-ip-address
```
1. Utilisez la commande [event notification destination create](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-destination-create.html) pour créer une destination de notification d'événement de type`syslog`, en spécifiant les attributs suivants :
+ `dest_name`— Le nom de la destination de notification à créer (par exemple,`syslog-ems`). Le nom de destination d'une notification d'événement doit comporter de 2 à 64 caractères. Les caractères valides sont les caractères ASCII suivants : A-Z, a-z, 0-9, « \$1 » et « - ». Le nom doit commencer et se terminer par : A-Z, a-z ou 0-9.
+ `syslog_name`— Le nom d'hôte ou l'adresse IP du serveur Syslog auxquels les messages Syslog sont envoyés.
+ `transport_protocol`— Le protocole utilisé pour envoyer les événements :
+ `udp-unencrypted`— Protocole de datagramme utilisateur sans aucune sécurité. Il s'agit du protocole par défaut.
+ `tcp-unencrypted`— Protocole de contrôle de transmission sans sécurité.
+ `tcp-encrypted`— Protocole de contrôle de transmission avec sécurité de la couche de transport (TLS). Lorsque cette option est spécifiée, car FSx ONTAP vérifie l'identité de l'hôte de destination en validant son certificat.
+ `port_number`— Le port du serveur Syslog auquel les messages Syslog sont envoyés. Le `syslog-port` paramètre de valeur par défaut dépend du réglage du `syslog-transport` paramètre. S'il `syslog-transport` est défini sur`tcp-encrypted`, la valeur `syslog-port` par défaut est`6514`. Si `syslog-transport` est défini sur`tcp-unencrypted`, `syslog-port` possède la valeur par défaut`601`. Dans le cas contraire, le port par défaut est défini sur`514`.
```
::> event notification destination create -name dest_name -syslog syslog_name -syslog-transport transport_protocol -syslog-port port_number
```
1. Utilisez la commande [event notification create](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-create.html) pour créer une nouvelle notification d'un ensemble d'événements défini par un filtre d'événements vers la destination de notification créée à l'étape précédente, en spécifiant les attributs suivants :
+ `node_name`— Nom du filtre d'événements. Les événements inclus dans le filtre d'événements sont transférés vers les destinations spécifiées dans le `-destinations` paramètre.
+ `dest_name`— Nom de la destination de notification existante à laquelle les notifications d'événements sont envoyées.
```
::> event notification create -filter-name filter_name -destinations dest_name
```
1. Si vous avez sélectionné TCP`transport_protocol`, vous pouvez utiliser la `event notification destination check` commande pour générer un message de test et vérifier que votre configuration fonctionne. Spécifiez les attributs suivants à l'aide de la commande :
+ `node_name`— Le nom du nœud (par exemple,`FsxId07353f551e6b557b4-01`).
+ `dest_name`— Nom de la destination de notification existante à laquelle les notifications d'événements sont envoyées.
```
::> set diag
::*> event notification destination check -node node_name -destination-name dest_name
```