Configurer une stratégie d’événements pour exécuter les commandes du mode opérationnel

Les commandes du mode opérationnel exécutent une opération ou fournissent une sortie de diagnostic sur un équipement exécutant Junos OS. Ils vous permettent d’afficher des statistiques et des informations sur l’état d’exploitation actuel d’un équipement. Elles vous permettent également de prendre des mesures correctives, telles que le redémarrage des processus logiciels, la mise hors ligne et le retour en ligne d’une carte d’interface physique, la commutation vers des interfaces redondantes et l’ajustement de la bande passante LSP (Label Switching Protocol). Pour plus d’informations sur les commandes du mode opérationnel, consultez l’explorateur cli.

Vous pouvez configurer une stratégie d’événements qui exécute des commandes en mode opérationnel et transfère la sortie de ces commandes à un emplacement spécifié pour analyse en incluant les instructions suivantes au niveau de la [edit event-options] hiérarchie :

Dans l’énoncé events , vous pouvez énumérer plusieurs événements. Si un ou plusieurs des événements répertoriés se produisent, le processus événementé exécute les commandes du mode opérationnel configurées pour l’instruction commands . Joindre chaque commande entre guillemets (" "). Le processus événementé émet les commandes dans l’ordre dans lequel elles apparaissent dans la configuration. Par exemple, dans la configuration suivante, l’exécution de policy1 la show interfaces commande est émise en premier, suivie de la show chassis alarms commande :

Vous pouvez inclure des variables dans la commande pour que les données provenant de l’événement de déclenchement soient automatiquement incluses dans la syntaxe de commande. Le processus événementé remplace chaque variable par des valeurs contenues dans l’événement qui déclenche la stratégie. Vous pouvez utiliser les variables de commande des formulaires suivants :

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

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

• {$*.attribute-name}— Le signe en dollars avec la notation astérisque ($*) représente l’événement le plus récent correspondant à l’un des événements de corrélation. La variable se résout à la valeur de l’attribut associé à l’événement le plus récent correspondant à l’un des événements corrélés spécifiés dans la configuration de la stratégie.

Pour un événement donné, vous pouvez afficher une liste d’attributs d’événement auxquels vous pouvez faire référence dans une commande en mode opérationnel en émettant la help syslog event commande :

Par exemple, dans la sortie de commande suivante, le texte entre crochets (< >) montre qu’il classifier-type s’agit d’un attribut de l’événement cosd_unknown_classifier :

Une autre façon d’afficher une liste d’attributs d’événement consiste à émettre la commande du set attributes-match event? mode de configuration au niveau de la [edit event-options policy policy-name] hiérarchie :

Par exemple, dans la sortie de commande suivante, la event.attribute liste affiche un classifier-type attribut de l’événement cosd_unknown_classifier :

Note:

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

Pour afficher la liste de tous les attributs d’événement auxquels vous pouvez faire référence, émettre la commande du set attributes-match ? mode de configuration au niveau de la [edit event-options policy policy-name] hiérarchie :

Lorsque le processus événementé exécute les commandes, il télécharge le fichier avec la sortie de commande vers l’emplacement spécifié dans l’instruction destination . Dans l’instruction destination , incluez un nom de destination configuré au niveau de la [edit event-options destinations] hiérarchie. Pour plus d’informations, consultez l’exemple : Définir des destinations pour l’archivage des fichiers par stratégies d’événements.

Dans l’instruction output-filename , définissez une chaîne descriptive qui sera incluse dans le nom de fichier. Chaque fichier téléchargé inclut également le nom de l’hôte et l’horodatage dans le nom de fichier pour s’assurer que chaque nom de fichier est unique. Si une stratégie est déclenchée plusieurs fois au cours d’une période d’une seconde, un numéro d’index est ajouté au nom de fichier pour s’assurer que les noms de fichier sont toujours uniques. La plage de nombres d’index est de 001 à 999.

À partir de Junos OS Version 14.1R3, la convention d’attribution de noms et le format du fichier de sortie généré par eventd sont modifiés. Lorsque l’événement exécute les commandes définies au niveau de la [edit event-options policy policy-name then execute-commands commands] hiérarchie et génère un fichier contenant la sortie de commande, le nom du fichier dépend de la version de Junos OS exécutée sur l’équipement. Avant la version 14.1R3 de Junos OS, le nom de fichier comporte la convention d’attribution de noms suivante :

À partir de Junos OS Version 14.1R3, le nom de fichier place la output-filename chaîne après l’horodatage.

Par exemple, sur un équipement nommé r1 exécutant Junos OS version 14.1R3 ou une version ultérieure, si vous configurez l’instruction output-filename comme ifl-events, et que cette stratégie d’événement est déclenchée trois fois en 1 seconde, les fichiers sont nommés :

• événements r1_20060623_132333_ifl

• r1_20060623_132333_ifl-events_001

• r1_20060623_132333_ifl-events_002

Par défaut, le format de sortie de commande est XML (Junos Extensible Markup Language). Configurez l’instruction output-format text pour mettre en forme la sortie de commande en tant que texte ASCII .