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

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 dans votre infrastructure.

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 les suivantes : gravité, instances de Citrix Application Delivery Controller (NetScaler), 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

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

  • Envoyer des notifications Slack : envoyez des notifications sur le canal Slack configuré pour les événements qui correspondent aux critères du filtre.

  • Envoyer des notifications PagerDuty : envoyez des notifications d’événements en fonction des configurations de PagerDuty pour les événements qui correspondent aux critères de filtre.

  • Envoyer des notifications ServiceNow : générer automatiquement des incidents ServiceNow pour un événement qui correspond aux critères de filtre.

Pour plus d’informations, voir Ajouter des actions de règle d’événement

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 une pièce jointe.

Surveiller les événements avec des règles

Par exemple, en tant qu’administrateur, vous souhaiterez peut-être surveiller les événements « d’utilisation élevée du processeur » pour des instances NetScaler spécifiques si ces événements peuvent entraîner une panne de vos instances NetScaler. Vous pouvez :

  • Créez une règle pour surveiller les instances et spécifier une action qui vous envoie une notification par e-mail lorsqu’un événement de la catégorie « utilisation élevée du processeur » se produit.

  • Planifiez l’exécution de la règle à une heure précise, par exemple entre 11 h et 23 h 00, 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écifiez les instances NetScaler auxquelles la règle s’applique

  5. Sélectionner des objets d’échec

  6. Spécifier des filtres avancés

  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 à Infrastructure > Événements > Règles, puis cliquez sur Ajouter. Si vous souhaitez activer votre règle, activez la case à cocher Activer la règle.

Vous pouvez définir l’option Event Age pour spécifier l’intervalle de temps (en secondes) après lequel NetScaler 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 NetScaler enregistre un événement « utilisation élevée du processeur » pendant 60 secondes ou plus. Vous pouvez définir l’âge de l’événement à 60 secondes, de sorte que chaque fois que votre instance NetScaler enregistre 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.

Créer une règle d'événement

Vous pouvez également filtrer les règles d’événements par famille d’instances pour suivre l’instance NetScaler à partir de laquelle NetScaler ADM reçoit un événement.

Si vous souhaitez inclure une expression régulière autre que la correspondance de formes avec un astérisque (*), sélectionnez Activer le filtre avancé avec correspondance régulière.

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

Définir les niveaux de gravité

Remarque

Vous pouvez configurer la gravité des événements génériques et spécifiques à Advanced. Pour modifier la gravité des événements pour les instances NetScaler gérées sur NetScaler ADM, accédez à Infrastructure > Événements > Paramètres des é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écifiez 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 NetScaler. Toutes les catégories sont créées sur des instances NetScaler. Ces catégories sont ensuite mappées avec NetScaler 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 devez choisir « cpuUsageHigh » comme catégorie d’événement dans le tableau affiché.

Définir la catégorie d'événement

Étape 4 - Spécifier les instances NetScaler

Sélectionnez les adresses IP des instances NetScaler 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 .

Spécifier les instances

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

Vous pouvez sélectionner un objet de défaillance dans la liste fournie ou ajouter un objet de défaillance pour lequel un événement a été généré. Vous pouvez également spécifier une expression régulière pour ajouter des objets de défaillance. En fonction de l’expression régulière spécifiée, les objets défaillants sont automatiquement ajoutés à la liste. Les objets d’échec sont des instances d’entité ou des compteurs pour lesquels un événement a été généré.

Important

Pour répertorier les objets d’échec à l’aide d’une expression régulière, sélectionnez Activer le filtre avancé avec correspondance d’expressions régulières à l’étape 1.

L’objet défaillant affecte la façon dont un événement est traité et garantit qu’il reflète exactement le problème tel qu’il a été notifié. Ce filtre vous permet de suivre rapidement les problèmes liés aux objets défaillants et d’identifier la cause d’un problème. Par exemple, si un utilisateur rencontre des problèmes de connexion, l’objet d’é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.

Liste des objets

Étape 6 - Spécifier les filtres avancés

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 une expression régulière pour filtrer les événements.

    Vous pouvez également filtrer la règle d’événement en fonction de l’état d’authentification de la commande et/ ou de son état d’exécution. Par exemple, pour un NetscalerConfigChange event, tapez [.]*bind system global policy_name[.]*.

    Filtre de commandes de configuration avancées

  • Messages  : vous pouvez spécifier la description complète du message ou spécifier une expression régulière pour filtrer les événements.
    Par exemple, pour un NetscalerConfigChange événement, tapez [.]*ns_client_ipaddress :10.122.132.142[.]* or ns_client_ipaddress :^([.]*10.122.132.142[.]*).

    Filtres de messages avancés

É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 un e-mail Action

  • Envoyer une action de piège

  • Exécuter l’action de commande

  • Exécuter une action de travail

  • Supprimer l’action

  • Envoyer des notifications Slack

  • Envoyer des notifications PagerDuty

  • Envoyer des notifications ServiceNow

Pour définir une action de règle d’événement de messagerie électronique

Lorsque vous choisissez le type d’action d’action Envoyer un e-mail, un e-mail est déclenché lorsque les événements répondent aux critères de filtre définis. Vous devez 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 déjà créée.

En raison du nombre élevé de serveurs virtuels configurés dans NetScaler ADM, vous pouvez recevoir un grand nombre d’e-mails chaque jour. Les e-mails ont une ligne d’objet par défaut qui fournit des informations sur la gravité de l’événement, la catégorie de l’événement et l’objet de la défaillance. Mais la ligne d’objet ne contient aucune information sur le nom du serveur virtuel d’où proviennent ces événements. Vous avez désormais la possibilité d’inclure des informations supplémentaires telles que le nom de l’entité affectée, le nom de l’objet défaillant.

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.

Lors de l’envoi d’e-mails pour les notifications d’événements, vous pouvez envoyer un e-mail de test pour tester les paramètres configurés. Le bouton « Tester » vous permet désormais d’envoyer un e-mail de test après avoir configuré un serveur de messagerie, les listes distribuées associées et d’autres paramètres. Cette fonctionnalité garantit que les paramètres fonctionnent correctement.

Vous pouvez également vous assurer que tous les événements critiques sont traités et qu’aucune notification par e-mail importante n’est oubliée, en cochant la case Répéter la notification par e-mail jusqu’à ce que l’événement soit effacé pour envoyer des notifications par e-mail répétées concernant les règles d’événement répondant 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.

Définir l'action de règle d'événement e-mail

Pour définir une action de règle d’événement d’interruption

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 des interruptions (ou une destination et des détails sur le profil des interruptions), des messages d’interruption sont envoyés à des auditeurs d’interruptions spécifiques lorsque les événements répondent aux critères de filtre définis.

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

Lorsque vous choisissez l’action d’événement Exécuter une action de commande, vous pouvez créer une commande ou un script qui peut être exécuté sur NetScaler ADM pour les événements correspondant à un critère de filtre particulier.

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 de défaillance affecte la façon dont un événement est traité et garantit que l’objet de défaillance reflète exactement le problème 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 sont remplacés par des valeurs réelles.

Par exemple, considérez que vous souhaitez définir une action de commande d’exécution lorsque l’état d’un serveur virtuel d’équilibrage de charge est Arrêté. En tant qu’administrateur, vous pouvez envisager de proposer une solution rapide en ajoutant un autre serveur virtuel. Dans NetScaler ADM, vous pouvez :

  • Écrivez un fichier script (.sh).

    Voici un exemple de fichier de script (.sh) :

     #!/bin/sh
 source=$1
 failureobj=$2
 payload='{"params":{"warning":"YES"},"lbvserver":{"name":"'$failureobj'","servicetype":"HTTP","ipv46":"x.x.x.x","port":"80","td":"","m":"IP","state":"ENABLED","rhistate":"PASSIVE","appflowlog":"ENABLED","
 bypassaaaa":"NO","retainconnectionsoncluster":"NO","comment":""}}'
 url="http://$source/nitro/v1/config/lbvserver"
 curl --insecure -basic -u nsroot:nsroot -H "Content-type: application/json" -X POST -d $payload $url

 <!--NeedCopy-->

  • Enregistrez le fichier .sh dans n’importe quel emplacement persistant de l’agent NetScaler ADM. Par exemple, /var.

  • Indiquez l’emplacement du fichier .sh dans NetScaler ADM à exécuter lorsque les critères de la règle sont remplis.

Pour définir l’action Exécuter la commande pour créer un nouveau serveur virtuel :

  1. Définissez la règle

  2. Sélectionnez la gravité de l’événement

  3. Sélectionnez la catégorie d’événement : entitydown

  4. Sélectionnez l’instance sur laquelle le serveur virtuel est configuré

  5. Sélectionnez ou créez un objet de défaillance pour le serveur virtuel

  6. Sous Actions des règles d’événement, cliquez sur Ajouter une action et sélectionnez Exécuter une action de commande dans la liste des types d’action .

  7. Sous Liste d’exécution des commandes, cliquez sur Ajouter.

    La page Créer une liste de distribution de commandes s’affiche.

    1. Dans Nom du profil, spécifiez un nom de votre choix

    2. Dans Exécuter la commande, spécifiez l’emplacement de l’agent NetScaler ADM où le script doit être exécuté. Par exemple : /sh/var/demo.sh $source $failureobj.

    3. Sélectionnez Ajouter la sortie et Ajouter les erreurs

      Remarque

      Vous pouvez activer les options Ajouter la sortie et Ajouter les 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 NetScaler ADM. Si vous n’activez pas ces options, NetScaler ADM ignore toutes les sorties et erreurs générées lors de l’exécution du script de commande.

    4. Cliquez sur Créer.

  8. Dans la page Ajouter une action d’événement, cliquez sur OK .

    Ajouter une action d'événement

    Remarque

    Vous pouvez activer les options Ajouter la sortie et Ajouter les 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 NetScaler ADM. Si vous n’activez pas ces options, NetScaler ADM ignore toutes les sorties et erreurs générées lors de l’exécution du script de commande.

Pour définir l’action de Execute travail

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 en tant que tâche personnalisée pour les instances NetScaler et NetScaler SDX, pour les événements et les alarmes qui correspondent aux critères de filtre que vous avez spécifiés.

  1. Sous Actions de règle d’événement, cliquez sur Ajouter une action et sélectionnez Exécuter une action de travail dans la liste déroulante 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.

Exécuter une action de travail

Pour définir l’action Supprimer

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.

Définir l'action de suppression

Pour définir les notifications Slack depuis NetScaler ADM

Configurez le canal Slack requis en fournissant le nom du profil et l’URL du webhook dans l’interface graphique de NetScaler ADM. Les notifications d’événement sont ensuite envoyées à ce canal. Vous pouvez configurer plusieurs canaux Slack pour recevoir ces notifications

  1. Dans NetScaler ADM, accédez àInfrastructure > Événements > Règles, puis cliquez surAjouterpour créer une règle.

  2. Dans la page Créer une règle, définissez les paramètres de règle tels que la gravité et la catégorie. Sélectionnez les instances ainsi que les objets de défaillance qui doivent être surveillés.

  3. Sous Actions relatives aux règles d’événement, cliquez sur Ajouter une action. Sélectionnez ensuite Envoyer des notifications Slack dans la liste des types d’action, puis sélectionnez Liste des profils Slack.

  4. Vous pouvez également ajouter une liste de profils Slack en cliquant sur Ajouter en regard du champ Liste des profils Slack.

  5. Entrez les paramètres suivants pour créer une liste de profils :

    1. Nom du profil. Tapez le nom de la liste de profils à configurer sur NetScaler ADM.

    2. Nom de la chaîne. Entrez le nom de la chaîne Slack à laquelle les notifications d’événements doivent être envoyées.

    3. URL du webhook. Entrez l’URL du webhook de la chaîne que vous avez saisie précédemment. Les webhooks entrants sont un moyen simple de publier des messages provenant de sources externes dans Slack. L’URL est liée en interne au nom du canal et toutes les notifications d’événement sont envoyées à cette URL pour être publiées sur le canal Slack désigné. Un exemple de webhook est le suivant : https://hooks.slack.com/services/T0******E/B9X55DUMQ/c4tewWAiGVTT51Fl6oEOVirK

  6. Cliquez sur Créer, puis sur OK dans la fenêtre Ajouter une action d’événement .

Remarque :

Vous pouvez également ajouter les profils Slack en accédant à Système > Notifications > Profils Slack. Cliquez sur Ajouter et créez le profil comme décrit dans la section précédente.

Vous pouvez consulter l’état des profils Slack que vous avez créés.

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.

Pour définir les notifications PagerDuty depuis NetScaler ADM

Vous pouvez ajouter un profil PagerDuty en option dans NetScaler ADM pour surveiller les notifications d’incident en fonction de vos configurations PagerDuty. PagerDuty vous permet de configurer les notifications par e-mail, SMS, notification push et appel téléphonique sur le numéro enregistré.

Avant d’ajouter un profil PagerDuty dans NetScaler ADM, assurez-vous d’avoir effectué les configurations requises dans PagerDuty. Pour plus d’informations, consultez la documentation de PagerDuty.

Vous pouvez sélectionner votre profil PagerDuty comme l’une des options pour obtenir des notifications pour les fonctionnalités suivantes :

  • Événements  : liste des événements générés pour les instances NetScaler.

  • Licences  : liste des licences actuellement actives, sur le point d’expirer, etc.

  • Certificats SSL  : liste des certificats SSL ajoutés aux instances NetScaler.

Pour ajouter un profil PagerDuty dans ADM :

  1. Connectez-vous à NetScaler ADM à l’aide des informations d’identification de l’administrateur.

  2. Accédez à Paramètres > Notifications > Profils PagerDuty.

  3. Cliquez sur Ajouter pour créer un profil.

  4. Dans la page Créer un profil PagerDuty :

    1. Indiquez le nom de profil de votre choix.

    2. Entrez la clé d’intégration.

      Vous pouvez obtenir la clé d’intégration sur votre portail PagerDuty.

    3. Cliquez sur Créer.

    Cas d’utilisation :

    Envisagez un scénario dans lequel vous :

    • souhaitez envoyer des notifications à votre profil PagerDuty.

    • J’ai configuré l’appel téléphonique comme option dans PagerDuty pour recevoir des notifications.

    • souhaitez recevoir des alertes téléphoniques concernant les événements NetScaler.

    Pour configurer :

    1. Accédez à Événements > Règles

    2. Sur la page Créer une règle, configurez tous les autres paramètres pour créer une règle.

    3. Sous Actions de création de règles, cliquez sur Ajouter une action.

      La page Ajouter une action d’événement s’affiche.

      1. Sous Type d’action, sélectionnez Envoyer les notifications PagerDuty.

        Notification PagerDuty

      2. Sélectionnez votre profil PagerDuty et cliquez sur OK.

        Créer un profil PagerDuty

    Une fois la configuration terminée, chaque fois qu’un nouvel événement est généré pour l’instance NetScaler, vous recevez un appel téléphonique. À partir de l’appel téléphonique, vous pouvez décider de :

    • Reconnaissez l’événement

    • Marquez-le comme résolu

    • Transférer à un autre membre de l’équipe

Pour générer automatiquement des incidents ServiceNow à partir de NetScaler ADM

Vous pouvez générer automatiquement des incidents ServiceNow pour les événements NetScaler ADM en sélectionnant le profil ServiceNow sur l’interface graphique de NetScaler ADM. Vous devez choisir le profil ServiceNow dans NetScaler ADM pour configurer une règle d’événement.

Avant de configurer une règle d’événement pour générer automatiquement des incidents ServiceNow, intégrez NetScaler ADM à une instance ServiceNow. Pour plus d’informations, consultez Configurer l’adaptateur ITSM pour ServiceNow.

Pour configurer une règle d’événement, accédez à Événements > Règles .

  1. Sur la page Créer une règle, configurez tous les autres paramètres pour créer une règle.

  2. Sous Actions de création de règles, cliquez sur Ajouter une action.

    La page Ajouter une action d’événement s’affiche.

    1. Dans Type d’action, sélectionnez Envoyer des notifications ServiceNow.

    2. Dans le profil ServiceNow, sélectionnez le profil Citrix_Workspace_SN dans la liste.

    3. Cliquez sur OK.

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.