SUR CETTE PAGE
-
Comment représenter les événements déclencheurs et corrélés dans une stratégie d’événements
-
Exemple : corrélation d’événements en fonction d’un intervalle de temps
-
Exemple : corrélation d’événements en fonction d’attributs d’événement
-
Exemple : corrélation d’événements en fonction d’un intervalle de temps et d’attributs d’événement
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.
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 lashow 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écentCOSD_CHAS_SCHED_MAP_INVALIDmis 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 :
[edit event-options]
policy p1 {
events [ e1 e2 e3 ];
within 60 events [ e4 e5 e6 ];
then {
execute-commands {
commands {
"show interfaces {$$.interface-name}";
"show interfaces {$e4.interface-name}";
"show interfaces {$*.interface-name}";
}
output-filename command-output.txt;
destination some-dest;
}
}
}
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 :
if trigger event is (event3 or event4 or event5)
and
(event1 or event2 has been received within the last 60 seconds)
then {
run a set of commands;
log the output of these commands to a location;
}
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 :
[edit event-options]
policy policy1 {
events [ event3 event4 event5 ];
within 60 events [ event1 event2 ];
then {
execute-commands {
commands {
"command";
}
output-filename my_cmd_out;
destination policy1-command-dest;
}
}
}
destinations {
policy1-command-dest {
archive-sites {
scp://robot@my.big.com/a/b;
scp://robot@my.little.com/a/b;
}
}
}
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.
[edit event-options]
policy policy1 {
events rpd_rdisc_nomulti;
within 500 events rpd_krt_ifdchange;
attributes-match {
rpd_rdisc_nomulti.interface-address equals rpd_krt_ifdchange.address;
rpd_rdisc_nomulti.interface-name starts-with rpd_krt_ifdchange.ifd-index;
}
then {
... actions ...
}
}
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 :
event-options {
policy faulty-rollback {
events ui_commit_not_confirmed;
within 60 events ping_test_failed;
within 50 events ui_commit_not_confirmed;
attributes-match {
ping_test_failed.test-owner matches "^Connectivity$";
ping_test_failed.test-name matches "^Management$";
}
then {
event-script save-rollback.slax;
}
}
event-script {
file save-rollback.slax;
}
}
Le save-rollback.slax script de l’événement est le suivant :
version 1.2;
ns junos = "http://xml.juniper.net/junos/*/junos";
ns xnm = "http://xml.juniper.net/xnm/1.1/xnm";
ns jcs = "http://xml.juniper.net/junos/commit-scripts/1.0";
import "../import/junos.xsl";
match / {
/* Get system time with hyphens instead of spaces */
var $modified-time = translate( $localtime, " ", "-" );
/* Use time to differentiate saved rollback versions */
var $filename = "saved-rollback-" _ $modified-time _ ".gz";
/* Copy the file */
var $file-copy-rpc = <file-copy> {
<source> "/config/juniper.conf.1.gz";
<destination> "/var/tmp/" _ $filename;
}
var $results = jcs:invoke( $file-copy-rpc );
/* Report any errors or success */
if( $results/..//xnm:error ) {
for-each( $results/..//xnm:error ) {
expr jcs:syslog( "external.error", "File Copy Error: ", message );
}
}
else {
expr jcs:syslog( "external.info", "Faulty rollback configuration saved." );
}
}
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.
user@host> file list /var/tmp/saved* /var/tmp/saved-rollback-Wed-Aug-19-09:02:55-2026.gz