Applets EEM pour capturer le résultat à partir de la configuration de la commande Show Stacks

Introduction

Ce document décrit comment configurer une applet Cisco IOS^® Embedded Event Manager (EEM) afin de capturer le résultat de la commande show stacks. Le centre d'assistance technique Cisco (TAC) a généralement besoin de cette sortie pour résoudre les problèmes d'utilisation élevée du CPU causés par le protocole SNMP (Simple Network Management Protocol).

Conditions préalables

Conditions requises

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Protocole de gestion de réseau simple (SNMP)
• Cisco IOS Embedded Event Manager (EEM)
• Syslog

Components Used

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Cisco IOS version 15.1(4)M6
• Routeur à services intégrés Cisco 2811

Note: Les configurations de ce document doivent fonctionner avec les versions antérieures du logiciel Cisco IOS, puisque les deux applets utilisent EEM version 3.0, qui est prise en charge dans Cisco IOS version 12.4(22)T ou ultérieure. Cependant, cela n'a pas été testé.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Configuration

Ces applets EEM automatisent le processus pour capturer le résultat de la commande show stacks. Notez que :

• Les deux applets utilisent l'ID de processus (PID) du moteur SNMP. Entrez la commande show processes cpu afin de trouver le PID ; dans cet exemple, le PID est 188 :
  
  

  2811#show processes cpu | include SNMP ENGINE
   PID Runtime(ms)     Invoked      uSecs   5Sec   1Min   5Min TTY Process
   188          40           1      40000  0.00%  0.04%  0.01%   0 SNMP ENGINE
  2811#

• EEM version 3.0 ou ultérieure est nécessaire pour utiliser les actions d'attente. Entrez la commande show event manager version afin de détecter la version EEM.
• Les périphériques du logiciel Cisco IOS qui utilisent l'authentification, l'autorisation et la comptabilité (AAA) doivent définir quel utilisateur peut exécuter des actions CLI. Utilisez la commande event manager session cli username user pour cette configuration, où user est un nom d'utilisateur autorisé à exécuter toutes les commandes CLI dans les applets EEM.
• Certains systèmes de fichiers peuvent ne pas être pris en charge avec l'option 'append' pour rediriger la sortie. Avant de configurer l'applet, testez-la manuellement afin de vous assurer que vous pouvez rediriger la sortie vers votre système de fichiers.

La commande show stacks affiche les tâches traitées par le processus spécifié. Lors du dépannage de problèmes d'utilisation élevée du CPU, il est utile de savoir quelles tâches sont exécutées lorsque la condition se produit.

Utilisation du processeur supérieure à 50 %

Cette applet EEM détecte quand l'utilisation du CPU dépasse 50 %. À ce moment-là, la sortie de la commande show stacks est échantillonnée pendant neuf secondes et enregistrée dans un fichier appelé SNMP_STACK.txt dans la mémoire Flash. Ces informations aident le TAC à identifier la cause de l'utilisation élevée du CPU.

Cet exemple examine une condition CPU élevée causée par SNMP ; vous pouvez utiliser une applet EEM similaire afin de collecter un ensemble de sorties différent pour étudier les problèmes de CPU élevés causés par un processus différent.

event manager applet SNMP_STACK
event snmp oid 1.3.6.1.4.1.9.9.109.1.1.1.1.10.1 get-type exact entry-op gt 
   entry-val "50" exit-op lt exit-val "15" poll-interval 2 maxrun 20
action 0.0 syslog msg "High CPU DETECTED"
action 0.1 cli command "enable"
action 1.1 cli command "show clock | append flash:SNMP_STACK.TXT"
action 1.2 cli command "show proc cpu sort | append flash:SNMP_STACK.TXT"
action 2.1 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 2.2 wait 1
action 2.3 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 2.4 wait 1
action 2.5 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 2.6 wait 1
action 2.7 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 2.8 wait 1
action 2.9 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.1 wait 1
action 3.2 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.3 wait 1
action 3.4 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.5 wait 1
action 3.6 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.7 wait 1
action 3.8 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"

Message Syslog %SNMP-3-INPUT_QFULL_ERR

Cette applet EEM est activée si le message syslog %SNMP-3-INPUT_QFULL_ERR est généré. À ce moment-là, la sortie de la commande show stacks est échantillonnée pendant neuf secondes et enregistrée dans un fichier appelé SNMP_STACK.txt dans la mémoire Flash. Ces informations aident le TAC à identifier la cause de l'utilisation élevée du CPU.

event manager applet SNMP_STACK
event syslog pattern "%SNMP-3-INPUT_QFULL_ERR"
action 1.0 cli command "enable"
action 2.1 cli command "show clock | append flash:SNMP_STACK.TXT"
action 2.2 cli command "show proc cpu sort | append flash:SNMP_STACK.TXT"
action 3.1 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.2 wait 1
action 3.3 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.4 wait 1
action 3.5 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.6 wait 1
action 3.7 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 3.8 wait 1
action 3.9 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.1 wait 1
action 4.2 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.3 wait 1
action 4.4 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.5 wait 1
action 4.6 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.7 wait 1
action 4.8 cli command "show stacks 188 | append flash:SNMP_STACK.TXT"
action 4.9 wait 1

Vérification

Aucune procédure de vérification n'est disponible pour cette configuration.

Dépannage

Il n'existe actuellement aucune information de dépannage spécifique pour cette configuration.

Informations connexes

• Guide de configuration de Event Manager intégré, Cisco IOS version 15M&T
• Support et documentation techniques - Cisco Systems