Utiliser des événements corrélés pour déclencher une stratégie d’événements

Configurez une stratégie d’événements pour qu’elle s’exécute lorsque deux événements corrélés ou plus se produisent.

Comprendre les événements corrélés

Outre la configuration d’une stratégie d’événements pour qu’elle se déclenche sur un seul événement, vous pouvez également configurer une stratégie d’événements qui met en corrélation deux événements ou plus. Si les événements se produisent comme spécifié, la stratégie d’événements exécute les actions configurées. Par exemple, vous pouvez émettre certaines commandes de mode opérationnel lorsqu’un événement UI_CONFIGURATION_ERROR est généré dans les cinq minutes suivant un événement UI_COMMIT_PROGRESS. Par exemple, vous pouvez télécharger un fichier particulier si un événement DCD_INTERFACE_DOWN est généré deux fois dans un intervalle de 60 secondes.

Pour corréler des événements dans une stratégie d’événements, incluez les déclarations suivantes au niveau de la [edit event-options] hiérarchie :

Dans l’instruction events , vous pouvez lister plusieurs événements déclencheurs. Pour plus d’informations sur la définition d’événements dans les stratégies d’événements, consultez Vue d’ensemble des stratégies d’événements et des notifications d’événements. Pour corréler ces événements avec d’autres événements, vous configurez les within attributes-match instructions et/ou.

L’instruction within définit les événements de corrélation qui doivent (ou ne doivent pas) se produire dans un intervalle de temps spécifié avant un événement déclencheur. L’instruction attributes-match permet au système de prendre en compte les attributs d’un événement. L’instruction attributes-match peut corréler l’attribut d’un événement avec l’attribut d’un autre événement ou avec une expression régulière. La stratégie d’événement n’exécute les actions configurées dans l’instruction then que si les conditions spécifiées sont remplies. Les sections suivantes expliquent comment utiliser les instructions.

Corrélez les événements par intervalle de temps

Vous pouvez configurer une stratégie d’événement pour qu’elle s’exécute uniquement si un événement déclencheur se produit dans un intervalle de temps spécifié après un autre événement. Pour corréler des événements, configurez l’instruction within seconds events . La stratégie est exécutée si l’un des événements de corrélation définis dans l’instruction within seconds events se produit dans le nombre de secondes configuré avant l’un des événements déclencheurs définis dans la première events instruction. Le nombre de secondes peut être compris entre 60 et 604 800. L’instruction not ne provoque l’exécution de la stratégie que si les événements de corrélation ne se produisent pas dans l’intervalle de temps configuré avant un événement déclencheur.

Par exemple, l’appareil exécute la stratégie suivante si l’un des événements déclencheurs, event3, event4ou event5, se produit dans les 60 secondes suivant l’un des événements corrélés, event1 ou event2.

Pour configurer une stratégie d’événement afin qu’elle s’exécute uniquement si un événement déclencheur se produit dans un intervalle de temps spécifié après plusieurs événements, vous devez configurer des instructions distinctes within . Chaque within instruction doit utiliser un intervalle de temps différent. Lorsque vous configurez plusieurs within instructions, chaque instruction doit avoir un événement correspondant qui se produit dans son intervalle de temps respectif pour que la stratégie se déclenche. Ainsi, le système évalue les instructions à l’aide d’un ET logique.

Par exemple, l’appareil exécute la stratégie suivante si l’un des événements déclencheurs, event4, event5ou event6, se produit dans les 60 secondes suivant event1 et se produit également dans les 50 secondes suivant event2 event3ou .

Pour configurer une stratégie d’événements afin de corréler les événements par intervalle de temps :

  1. Configurez un ou plusieurs événements déclencheurs.

  2. Configurez les événements de corrélation qui doivent ou ne doivent pas se produire avant un événement déclencheur et dans l’intervalle de temps spécifié.

    • Pour spécifier qu’un événement de corrélation doit se produire dans l’intervalle de temps spécifié avant un événement déclencheur, omettez le not mot-clé.

    • Pour spécifier qu’un événement de corrélation ne doit pas se produire dans l’intervalle de temps spécifié avant un événement déclencheur, incluez le mot-clé not .

    • Pour spécifier que plusieurs événements de corrélation doivent se produire dans des intervalles de temps spécifiés avant un événement déclencheur, incluez plusieurs within instructions qui définissent chacune des intervalles de temps différents.

  3. Configurez les actions que la stratégie d’événement exécute si les conditions sont remplies.

L’instruction within prend également en charge l’exécution d’une stratégie d’événement lorsque l’événement déclencheur se produit un certain nombre de fois au cours d’un intervalle de temps donné. Pour plus d’informations, consultez Déclencher une stratégie d’événement en fonction du nombre d’événements.

Corrélation d’événements en fonction d’attributs d’événement

De nombreux événements ont un ou plusieurs attributs, que vous pouvez référencer dans les stratégies d’événements. Par exemple, considérez le message suivant du journal système d’un UI_COMMIT événement :

Le message générique UI_COMMIT de l’événement est : User 'username' requested 'command' operation (comment: message).

Il possède les trois attributs suivants : username, command, et message.

L’instruction attributes-match vous permet d’établir une correspondance de stratégie d’événement plus précise en comparant les attributs d’événement aux valeurs souhaitées à l’aide des equalscomparaisons , matcheset starts-with . La déclaration corrèle les événements comme suit :

  • event1.attribute-name equals event2.attribute-name: n’exécute la stratégie que si l’attibute event1 et l’attribut event2 ont la même valeur.

  • event.attribute-name matches regular-expression: exécute la stratégie uniquement si la valeur d’attribut event correspond à l’expression régulière donnée. Pour plus d’informations, consultez Utiliser des expressions régulières pour affiner l’ensemble des événements qui déclenchent une stratégie.

  • event1.attribute-name starts-with event2.attribute-name: exécute la stratégie uniquement si la valeur de l’attribut event1 commence par la valeur de l’attribut event2 .

Les événements référencés dans les attributes-match relevés doivent être soit l’événement déclencheur, soit les événements corrélés inclus dans les relevés de la stratégie d’événement within . Vous devez définir une ou plusieurs within instructions lorsque l’instruction attributes-match :

  • Comprend un equals ou starts-with comparaison

  • Comprend une matches comparaison qui inclut une clause pour un événement qui n’est pas un événement déclencheur.

Une attributes-match instruction peut inclure plusieurs equalsinstructions , matches, et starts-with de comparaison. Le système évalue plusieurs instructions de comparaison à l’aide d’un opérateur ET logique. Ainsi, pour exécuter la stratégie d’événement attributes-match , toutes les conditions doivent être évaluées comme vraies.

Par exemple, supposons que vous configurez plusieurs sondes de surveillance des performances en temps réel (RPM) et que l’une d’entre elles utilise le nom Connectivity du propriétaire et possède un test nommé Management. Si vous référencez l’événement de ping_test_failed la sonde dans une stratégie d’événements, vous souhaitez distinguer le test de sonde RPM qui a généré l’événement. La stratégie d’événement suivante correspond aux attributs et test-name de l’événement ping_test_failed afin que la stratégie d’événement test-owner ne se déclenche que pour la sonde appropriée. La stratégie d’événement s’exécute uniquement si les deux conditions de correspondance sont vraies. Pour obtenir une explication détaillée de l’exemple, consultez Exemple : corrélation d’événements en fonction de l’intervalle de temps et des attributs d’événement.

De même, la stratégie d’événement suivante se déclenche sur l’événement SYSTEM non standard, qui a un messages attribut. Dans l’instruction attributes-match , toutes les instructions doivent être vraies pour appeler la stratégie d’événement matches :

Vous pouvez utiliser des variables de stratégie d’événement dans l’instruction attributes-match pour faire la différence entre un attribut d’événement déclencheur et un attribut d’événement corrélé. Les événements déclencheurs sont ceux que vous configurez au niveau de la [edit event-options policy policy-name events] hiérarchie. La notation du double signe dollar ($$) représente l’événement qui déclenche une stratégie et {$$.attribute-name} se résout en la valeur de l’attribut de l’événement déclencheur. Pour corréler des événements, le signe dollar unique avec la notation de nom d’événement ($event) représente l’événement le plus récent qui correspond au nom de l’événement et {$event.attribute-name} se résout en la valeur de l’attribut associé à cet événement.

Par exemple, la stratégie d’événement suivante exécute les actions sous l’instruction then si quatre validations ou plus sont effectuées sur une période de 5 minutes et que le nom d’utilisateur d’un ou plusieurs des événements corrélés est le même que le nom d’utilisateur de l’événement déclencheur.

Il existe de nombreuses façons de trouver les attributs que vous pouvez référencer pour un événement spécifique, par exemple :

  • Utilisez l’outil Explorateur de journaux système .

  • Utilisez la help syslog event commande mode opérationnel de la CLI.

  • Utilisez l’aide contextuelle en mode configuration lorsque vous configurez l’attribut.

L’application Explorateur de journaux système vous permet de rechercher les messages standard du journal système pour un système d’exploitation et une version donnés. Les détails du message incluent les attributs que vous pouvez référencer pour cet événement. De plus, le champ Attributs répertorie tous les attributs de cet événement.

Dans la CLI, la help syslog event commande mode opérationnel affiche également une liste des attributs que vous pouvez référencer pour un événement donné. La sortie de la commande affiche les attributs d’événement entre crochets (<>). La sortie suivante montre que l’événement ACCT_ACCOUNTING_SMALL_FILE_SIZE a trois attributs : filename, file-size, et record-size.

Remarque :

Vous pouvez filtrer la sortie d’une recherche à l’aide du symbole de barre verticale (|). Pour plus d’informations sur l’utilisation du symbole de pipe, reportez-vous au Guide de l’utilisateur CLI.

Vous pouvez également afficher les attributs d’événement en exécutant la set attributes-match event? commande de mode de configuration au niveau de la [edit event-options policy policy-name] hiérarchie, comme illustré dans l’exemple suivant :

Remarque :

Dans cette set commande, il n’y a pas d’espace entre le nom de l’événement et le point d’interrogation (?).

Comment représenter les événements déclencheurs et corrélés dans une stratégie d’événements

Dans les arguments de script d’événement et les instructions de stratégie d’événement prises en charge telles que l’instruction, vous pouvez utiliser des execute-commands variables de stratégie d’événement pour faire la différence entre un événement déclencheur et un événement corrélé. Vous configurez les événements déclencheurs et les événements corrélés dans les instructions suivantes au niveau de la [edit event-options policy policy-name] hiérarchie :

  • Événement déclencheur : configuré dans l’instruction events
  • Événement corrélé : configuré dans l’instruction within seconds events

Vous pouvez utiliser des variables de stratégie d’événement des formulaires suivants pour représenter les événements déclencheurs et corrélés :

  • {$$.attribute-name}: la notation du double dollar ($$) représente l’événement qui déclenche la stratégie. Lorsqu’elle est combinée avec un nom d’attribut, la variable se résout en la valeur de l’attribut associé à l’événement déclencheur. Par exemple, {$$.interface-name} se résout sur le nom d’interface associé à l’événement déclencheur.

  • {$event.attribute-name}: le signe dollar unique avec la notation de nom d’événement ($event) représente l’événement le plus récent qui correspond à event. Lorsqu’elle est combinée avec un nom d’attribut, la variable se résout en la valeur de l’attribut associé à cet événement. Par exemple, lorsqu’une stratégie émet la show interfaces {$COSD_CHAS_SCHED_MAP_INVALID.interface-name} commande, la {$COSD_CHAS_SCHED_MAP_INVALID.interface-name} variable se résout en nom d’interface associé à l’événement le plus récent COSD_CHAS_SCHED_MAP_INVALID mis en cache par le processus d’événement.

  • {$*.attribute-name}: le signe dollar avec l’astérisque ($*) représente l’événement le plus récent qui correspond à l’un des événements corrélés. La variable est résolue en la valeur de l’attribut associé à l’événement le plus récent qui correspond à l’un des événements corrélés spécifiés dans la configuration de la stratégie.

Dans les stratégies d’événements, vous pouvez référencer des événements spécifiques à l’aide de variables de stratégie d’événements. Tenez compte de la politique d’événement suivante :

Dans la show interfaces {$$.interface-name} commande, la valeur de l’attribut interface-name event e1, e2ou e3 est substituée à la {$$.interface-name} variable.

Dans la show interfaces {$e4.interface-name} commande, la valeur de l’attribut interface-name de l’événement le plus récent e4 est substituée à la {$e4.interface-name} variable.

Dans la show interfaces {$*.interface-name} commande, la valeur de l’attribut interface-name de l’événement , e5ou e6 le plus récent e4est substituée à la {$*.interface-name} variable. Si l’un des , e1ou se produit dans les 60 secondes suivant e4, e5ou e6, la valeur de l’attribut interface-name de cet événement de corrélation (e4, e5ou e6) est substituée à la {$*.interface-name} variable.e3 e2 Si l’événement corrélé n’a pas d’attributinterface-name, le logiciel n’exécute pas la show interfaces {$*.interface-name} commande.

Si e1 se produit dans les 60 secondes suivant les deux e4 et e5, la {$*.interface-name} variable utilise la valeur de l’attribut interface-name pour e4. La stratégie utilise e4 parce que le processus d’événement (eventd) recherche les événements correspondants dans l’ordre séquentiel configuré dans l’instruction within . Dans ce cas, la commande est e4 > e5 > e6.

Exemple : corrélation d’événements en fonction d’un intervalle de temps

La stratégie d’événement suivante émet un ensemble de commandes et télécharge le fichier de sortie résultant sur un site d’archivage. Le système exécute la stratégie d’événements si l’un des événements déclencheurs, event3, event4ou event5, se produit dans les 60 secondes suivant l’un des événements corrélés, event1 ou event2, se produit. Le pseudo-code de la stratégie est le suivant :

La destination de la stratégie d’événement définit deux sites d’archivage. L’appareil tente de transférer vers le premier site d’archivage de la liste, en ne passant au site suivant qu’en cas d’échec du transfert. La configuration de la stratégie d’événement est la suivante :

Exemple : corrélation d’événements en fonction d’attributs d’événement

Dans la stratégie d’événement suivante, les deux événements sont mis en corrélation si leurs valeurs d’attribut d’événement correspondent. La correspondance des attributs des deux événements garantit que les deux événements sont liés. Dans ce cas, les adresses d’interface doivent correspondre et les noms d’interface physique (ifd) doivent correspondre.

L’erreur RPD_KRT_IFDCHANGE se produit lorsque le processus du protocole de routage (rpd) envoie une demande au noyau pour modifier l’état d’une interface et que la demande échoue. L’erreur RPD_RDISC_NOMULTI se produit lorsqu’une interface est configurée pour la découverte de routeur, mais que l’interface ne prend pas en charge les opérations de multicast IP requises.

Exemple : corrélation d’événements en fonction d’un intervalle de temps et d’attributs d’événement

Dans l’exemple suivant, une organisation souhaite enregistrer toutes les configurations ayant échoué qui ont entraîné une perte de connectivité au réseau de gestion. L’organisation utilise une configuration de test RPM (Real Time Performance Monitoring) qui vérifie l’accessibilité du réseau de gestion à chaque minute. Les opérateurs valident toujours les modifications à l’aide de la commit confirmed commande CLI. La commit confirmed commande permet de restaurer automatiquement la configuration si les changements de configuration affectent la connectivité.

La stratégie d’événement exécute un script d’événement, save-rollback.slax, pour copier la configuration ayant échoué remplacée par la restauration automatique vers un emplacement spécifique. Le script d’événement copie le fichier de restauration /config/juniper.conf.1.gz dans le répertoire /var/tmp pour le stockage et l’examen ultérieur.

L’événement déclencheur de stratégie d’événement est l’événement UI_COMMIT_NOT_CONFIRMED. Cet événement se produit lorsque l’appareil annule automatiquement la validation confirmée. Lorsque le système déclenche une restauration confirmée par validation, l’événement UI_COMMIT_NOT_CONFIRMED se produit deux fois. Le premier message d’événement indique que la restauration est en cours et le second message d’événement indique que la restauration est terminée. Ainsi, la stratégie d’événement doit mettre en corrélation les deux événements UI_COMMIT_NOT_CONFIRMED afin que le système ne déclenche pas la stratégie d’événement deux fois. Dans cet exemple, le deuxième événement UI_COMMIT_NOT_CONFIRMED doit se produire dans les 50 secondes suivant le premier événement.

Pour déterminer si la configuration a entraîné une perte de connectivité au réseau de gestion, la stratégie d’événements met également en corrélation l’événement UI_COMMIT_NOT_CONFIRMED avec l’événement PING_TEST_FAILED de la sonde RPM. Un événement PING_TEST_FAILED se produit lorsque le test RPM sur le réseau de gestion échoue. Dans cet exemple, l’événement UI_COMMIT_NOT_CONFIRMED doit se produire dans les 60 secondes suivant l’événement PING_TEST_FAILED. Pour spécifier le test de sonde RPM qui a généré l’événement, la stratégie d’événement inclut l’instruction attributes-match et ne se déclenche que lorsque l’attribut de l’événement test-owner correspond Connectivity et que l’attribut de test-name l’événement correspond Management.

La stratégie d’événement configure des instructions distinctes within pour l’événement PING_TEST_FAILED et le premier événement UI_COMMIT_NOT_CONFIRMED. À l’aide de plusieurs within instructions, les deux conditions doivent être remplies pour que la stratégie d’événement se déclenche. Chaque within instruction nécessite un intervalle de temps différent. De même, les deux attributes-match conditions doivent être vraies pour que la stratégie se déclenche.

La configuration de la stratégie d’événement est la suivante :

Le save-rollback.slax script de l’événement est le suivant :

Lorsque l’équipement exécutant Junos OS déclenche la stratégie d’événements, l’équipement enregistre le fichier de configuration de restauration dans le répertoire /var/tmp avec un nouveau nom de fichier qui inclut l’horodatage.