Documentation Produit
Application Delivery Management
14.1 - Current Release 13.1 13.0 12.1
Voir PDF

Créer des règles d’événement

February 1, 2024
Contributeur: 
C

24 mai 2018

Vous pouvez configurer des règles pour surveiller des événements spécifiques. Les règles facilitent la surveillance d’un grand nombre d’événements générés sur votre infrastructure Citrix Application Delivery Controller (ADC).

Vous pouvez filtrer un ensemble d’événements en configurant des règles avec des conditions spécifiques et en affectant des actions aux règles. Lorsque les événements générés répondent aux critères de filtre de la règle, l’action associée à la règle est exécutée. Les conditions pour lesquelles vous pouvez créer des filtres sont : gravité, instances Citrix ADC, catégorie, objets de défaillance, commandes de configuration et messages.

Vous pouvez affecter les actions suivantes aux événements :

  • Action d’envoi d’un e-mail : envoyez un e-mail pour les événements qui correspondent aux critères du filtre.

  • Envoyer une action d’interruptions : envoyer ou transférer des interruptions SNMP vers une destination d’interruptions externe

  • Actiond’envoi de SMS : envoyez un message SMS pour chaque événement correspondant aux critères du filtre.

  • Exécuter l’action de commande : Exécutez une commande lorsqu’un événement entrant répond à la règle configurée.

  • Exécuter une action de travail : Exécuter une tâche concerne les événements qui correspondent aux critères de filtre que vous avez spécifiés.

  • Supprimer l’action : supprime supprimer un événement pour une période spécifique.

Vous pouvez également renvoyer les notifications à un intervalle spécifié jusqu’à ce qu’un événement soit effacé. Et vous pouvez personnaliser l’e-mail avec une ligne d’objet spécifique, un message utilisateur et/ou une pièce jointe.

Image localisée

Par exemple, en tant qu’administrateur, vous pouvez surveiller les événements « utilisation élevée de l’UC » pour des instances Citrix ADC spécifiques si ces événements peuvent entraîner une panne de vos instances Citrix ADC. Vous pouvez créer une règle pour surveiller les instances et spécifier une action qui vous enverra une notification par e-mail lorsqu’un événement de la catégorie « utilisation élevée du processeur » se produit. Vous pouvez programmer l’exécution de la règle à une heure précise, par exemple entre 11 h et 23 h, afin de ne pas être averti chaque fois qu’un événement est généré.

La configuration d’une règle d’événement implique les tâches suivantes :

  1. Définissez la règle

  2. Choisissez la gravité de l’événement détecté par la règle

  3. Spécifiez la catégorie de l’événement

  4. Spécifier les instances Citrix ADC auxquelles la règle s’applique

  5. Spécifier les objets de défaillance

  6. Spécifier des filtres supplémentaires

  7. Spécifier les actions à effectuer lorsque la règle détecte un événement

Étape 1 - Définir une règle d’événement

Accédez à Réseaux > Événements > Règles, puis cliquez sur Ajouter . Si vous souhaitez activer votre règle, cochez la case Activer la règle .

Vous pouvez définir l’option Event Age pour spécifier l’intervalle de temps (en secondes) après lequel Citrix Application Delivery Management (ADM) actualise une règle d’événement.

Remarque :

La valeur minimale de l’âge de l’événement est de 60 secondes. Si vous gardez le champ Âge de l’événement vide, la règle d’événement est appliquée immédiatement après l’événement.

Sur la base de l’exemple ci-dessus, vous souhaiterez peut-être être averti par e-mail chaque fois que votre instance Citrix ADC présente un événement « utilisation élevée du processeur » pendant une période de 60 secondes ou plus. Vous pouvez définir l’âge de l’événement à 60 secondes, de sorte que chaque fois que votre instance Citrix ADC présente un événement « utilisation élevée du processeur » pendant 60 secondes ou plus, vous receviez une notification par e-mail contenant les détails de l’événement.

Image localisée

Vous pouvez également filtrer les règles d’événement par famille de périphériques pour suivre l’instance de Citrix ADC à partir de laquelle Citrix ADM reçoit un événement.

Étape 2 - Choisir la gravité de l’événement

Vous pouvez créer des règles d’événement qui utilisent les paramètres de gravité par défaut. La gravité indique la gravité actuelle des événements auxquels vous souhaitez ajouter la règle des événements.

Vous pouvez définir les niveaux de gravité suivants : Critique, Majeur, Mineur, Avertissement, Effacer et Informations.

Image localisée

Remarque

Vous pouvez configurer la gravité des événements génériques et spécifiques à l’entreprise. Pour modifier la gravité des événements pour les instances Citrix ADC gérées sur Citrix ADM, accédez à Réseaux > Événements > Paramètresdes événements. Choisissez la catégorie pour laquelle vous souhaitez configurer la gravité de l’événement, puis cliquez sur Configurer la gravité . Attribuez un nouveau niveau de gravité et cliquez sur OK.

Étape 3 - Spécifier la catégorie d’événement

Vous pouvez spécifier la ou les catégories des événements générés par vos instances Citrix ADC. Toutes les catégories sont créées sur des instances Citrix ADC. Ces catégories sont ensuite mappées avec Citrix ADM qui peut être utilisé pour définir des règles d’événements. Sélectionnez la catégorie à prendre en compte et déplacez-la de la table Disponible vers la table configurée.

Dans l’exemple ci-dessus, vous devrez choisir « CPUusageHigh » comme catégorie d’événement dans le tableau affiché.

Image localisée

Étape 4 - Spécifier les instances de Citrix ADC

Sélectionnez les adresses IP des instances Citrix ADC pour lesquelles vous souhaitez définir la règle d’événement. Dans la section Instances, cliquez sur Sélectionner des instances. Dans la page Sélectionner des instances, choisissez vos instances, puis cliquez sur Sélectionner .

Image localisée

Étape 5 - Sélectionner les objets de défaillance

Vous pouvez sélectionner un objet d’échec dans la liste déroulante fournie ou ajouter un objet d’échec pour lequel un événement a été généré. Les objets d’échec sont des instances d’entité ou des compteurs pour lesquels un événement a été généré.

L’objet Failure affecte la façon dont un événement est traité et garantit que l’objet Failure reflète le problème exact tel qu’il a été notifié. Cela peut être utilisé pour détecter rapidement les problèmes et identifier la raison de l’échec, au lieu de simplement signaler les événements bruts. Par exemple, si un utilisateur rencontre des problèmes de connexion, l’objet de l’échec est le nom d’utilisateur ou le mot de passe, tel que « nsroot ».

Cette liste peut contenir des noms de compteur pour tous les événements liés au seuil, des noms d’entité pour tous les événements liés à l’entité, des noms de certificats pour les événements liés au certificat, etc.

Image localisée

Étape 6 - Spécifier des filtres supplémentaires

Vous pouvez filtrer davantage une règle d’événement en :

  • Commandes de configuration : vous pouvez spécifier la commande de configuration complète ou spécifier le modèle de description dans un astérisque (*) pour filtrer les événements. Outre la commande, vous pouvez choisir de filtrer davantage la règle d’événement en fonction de l’état d’authentification de la commande et/ou de son statut d’exécution. Par exemple, pour un événement NetScalerConfigChange, tapez *bind system global policy_name*.

    Image localisée

  • Messages - Vous pouvez spécifier la description complète du message ou spécifier le modèle de description dans un astérisque (*) pour filtrer les événements.
    Par exemple, pour un événement NetScalerConfigChange, tapez *ns_client_ipaddress:10.102.126.250*.

    Image localisée

Étape 7 - Ajouter des actions de règle d’événement

Vous pouvez ajouter des actions de règle d’événement pour affecter des actions de notification à un événement. Ces notifications sont envoyées ou exécutées lorsqu’un événement répond aux critères de filtre définis ci-dessus. Vous pouvez ajouter les actions d’événement suivantes :

  • Envoyer une action e-mail

  • Envoyer une action de piège

  • Envoyer une action par SMS

  • Exécuter l’action de commande

  • Exécuter une action de travail

  • Supprimer l’action

Pour définir l’action relative à la règle relative aux événements de messagerie électronique :

Lorsque vous choisissez le type d’action d’événement Envoyer une action e-mail, un message électronique est déclenché lorsque les événements répondent aux critères de filtre définis. Vous devrez soit créer une liste de distribution d’e-mails en fournissant les détails du serveur de messagerie ou du profil de messagerie, soit sélectionner une liste de distribution d’e-mails que vous avez créée précédemment.

Vous pouvez également ajouter une ligne d’objet personnalisée et un message utilisateur, et télécharger une pièce jointe à votre e-mail lorsqu’un événement entrant correspond à la règle configurée.

Grâce à cette option, vous pouvez également vous assurer que tous les événements critiques sont traités et qu’aucune notification importante par e-mail n’est oubliée, en cochant la case Répéter la notification par e-mail jusqu’à ce que l’événement soit désactivé pour envoyer des notifications par e-mail répétées pour les règles relatives aux événements qui répondent aux critères que vous avez sélectionnés. Par exemple, si vous avez créé une règle d’événement pour les instances qui impliquent des défaillances de disque et que vous souhaitez être averti jusqu’à ce que le problème soit résolu, vous pouvez choisir de recevoir des notifications par e-mail répétées sur ces événements.

Image localisée

Pour définir l’action de la règle Trap Event :

Lorsque vous choisissez le type d’action d’événement Envoyer une action d’interruption, les interruptions SNMP sont envoyées ou transférées vers une destination d’interruption externe. En définissant une liste de distribution d’interruptions (ou les détails d’une destination d’interruptions et d’un profil d’interruptions), les messages d’interruptions sont envoyés à un auditeur d’interruptions spécifiques lorsque les événements répondent aux critères de filtre définis.

Pour définir l’action de la règle relative aux événements SMS :

Lorsque vous choisissez le type d’action d’événement Envoyer une action par SMS, un message SMS (Short Message Service ) pour chaque événement qui correspond aux critères du filtre. Vous devrez soit créer une liste de distribution de SMS en fournissant les détails du serveur SMS ou du profil SMS, soit sélectionner une liste de distribution de SMS que vous avez créée précédemment.

Pour définir l’action Exécuter la commande :

Lorsque vous choisissez l’action d’événement Exécuter l’action de commande, vous pouvez créer une commande ou un script qui peut être exécuté sur Citrix ADM pour les événements correspondant à un critère de filtre particulier. Par exemple, si un événement de gravité « critique » est déclenché lors d’un changement de configuration sur une instance gérée, vous pouvez exécuter un script de commande.

Vous pouvez également définir les paramètres suivants pour le script Run Command Action :

   
Paramètre Description
$source Ce paramètre correspond à l’adresse IP source de l’événement reçu.
Catégorie $ Ce paramètre correspond au type de pièges défini dans la catégorie du filtre
$entité Ce paramètre correspond aux instances ou aux compteurs d’entités pour lesquels un événement a été généré. Il peut inclure les noms de compteur pour tous les événements liés aux seuils, les noms d’entités pour tous les événements liés aux entités et les noms de certificats pour tous les événements liés aux certificats.
$severity Ce paramètre correspond à la gravité de l’événement.
$failureobj L’objet Failure affecte la façon dont un événement est traité et garantit que l’objet Failure reflète le problème exact tel qu’il a été notifié. Cela peut être utilisé pour détecter rapidement les problèmes et identifier la raison de l’échec, au lieu de simplement signaler les événements bruts.

Remarque

Pendant l’exécution de la commande, ces paramètres seront remplacés par des valeurs réelles.

Pour configurer l’action événementielle « Exécuter l’action de commande » sur Citrix ADM :

  1. Sous Actions relatives aux règles d’événement , cliquez sur Ajouter une action et sélectionnez Exécuter une action de commande dans la liste déroulante Type d’action .

  2. Sur la page Créer une liste de distribution de commandes , indiquez un nom de profil et la commande à exécuter. Cette commande sera exécutée lorsque les événements répondront aux critères de filtre définis.

    Image localisée

    Remarque

    Vous pouvez activer les options Ajout de sortie et Ajout d’erreurs si vous souhaitez stocker la sortie et les erreurs générées (le cas échéant) lorsque vous exécutez un script de commande dans les fichiers journaux du serveur Citrix ADM. Si vous n’activez pas ces options, Citrix ADM ignorera toutes les sorties et erreurs générées lors de l’exécution du script de commande.

Pour définir l’action Exécuter la tâche, procédez comme suit :

En créant un profil avec des tâches de configuration, une tâche est exécutée en tant que tâche intégrée ou personnalisée pour les instances Citrix ADC, Citrix SDX et Citrix SD-WAN WO, pour les événements et les alarmes correspondant aux critères de filtre que vous avez spécifiés.

  1. Sous Actions relatives aux règles d’événement , cliquez sur Ajouter une action et sélectionnez Exécuter l’action de tâche dans le menu Type d’action .

  2. Créez un profil avec une tâche que vous souhaitez exécuter lorsque les événements répondent aux critères de filtre définis.

  3. Lors de la création d’une tâche, spécifiez un nom de profil, le type d’instance, le modèle de configuration et l’action que vous souhaitez effectuer en cas d’échec des commandes de la tâche.

  4. En fonction du type d’instance sélectionné et du modèle de configuration choisi, spécifiez vos valeurs de variables et cliquez sur Terminer pour créer le travail.

    Image localisée

Pour définir l’action de suppression :

Lorsque vous choisissez l’ action d’événement Supprimer l’action, vous pouvez configurer une période, en minutes, pendant laquelle un événement est supprimé ou supprimé. Vous pouvez supprimer l’événement pendant au moins 1 minute.

Image localisée

Votre règle d’événement est maintenant créée avec des filtres appropriés et des actions de règle d’événement bien définies.

Créer des règles d’événement
February 1, 2024
Contributeur: 
C
February 1, 2024
Contributeur: 
C

Dans cet article

Commentaires sur le site | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.