Secuencias de comandos de EEM utilizadas para solucionar problemas

Introducción

Este documento describe cómo utilizar la herramienta Embedded Event Manager (EEM) para resolver problemas en la red que, de otra manera, son difíciles de fijar o no tienen una frecuencia regular que permita la resolución de problemas normal.

¿Qué es EEM?

EEM es un sistema flexible diseñado para personalizar Cisco IOS^®, XR y NX-OS. EEM le permite automatizar tareas, realizar mejoras menores y crear soluciones alternativas. 

¿Cuándo utilizar EEM?

Los scripts EEM tienen dos propósitos:

• Para ayudar a resolver un problema: cuando necesita resolver problemas de naturaleza intermitente, los scripts EEM pueden ser particularmente útiles. Le permiten automatizar el proceso de recolección de los resultados de los comandos show y debug, lo que le permite capturar datos que de otra manera serían extremadamente difíciles de recopilar.
• Para ayudar a proporcionar una solución: en los casos en los que se requiere una solución temporal mientras el Technical Assistance Center (TAC) realiza un análisis de la causa principal. Tomemos por ejemplo una situación en la que el problema es intermitente, pero el reinicio de una interfaz soluciona el problema. Los scripts EEM se pueden utilizar para activar esta acción tan pronto como comience el problema. 

En cualquier caso, para utilizar las secuencias de comandos EEM es necesario identificar un evento de activación que puede utilizar para activar el script.

Guiones EEM de ejemplo

En esta sección se incluyen scripts EEM de ejemplo para ayudar a resolver problemas.

Ejecutar comandos cada 30 segundos para archivos en Flash

Ejecute comandos cada 30 segundos al archivo en flash; los comandos show se pueden adaptar a lo que desee ejecutar:

event manager applet show-rtp-streams
  event timer watchdog name timer time 30
  action 0.5 cli command "enable"
  action 1.0 cli command "show clock | append flash:filename.txt"
  action 2.0 cli command "show ip cache flow | append flash:filename.txt"
  action 3.0 cli command "show voip rtp conn" | append flash:filename.txt"
  action 4.0 cli command "show call active voice br" | append flash:filename.txt"

Nota: Algunos sistemas de archivos flash (como bootflash o slotX) no admiten la operación append. No se trata de una limitación de EEM, sino más bien de una limitación de los sistemas de archivos Flash lineales. Los sistemas de archivos de acceso aleatorio como diskX o flash en los switches de escritorio (3560, 3750, etc.) admiten anexarse a un archivo.

Nota: Si el dispositivo está configurado para la autorización de comandos de autenticación, autorización y contabilidad (AAA), EEM debe configurarse con un nombre de usuario autorizado para ejecutar todos los comandos CLI en todas las políticas EEM configuradas.  Para hacer esto, ingrese event manager session cli username USER donde USER es el usuario AAA apropiado.

Utilice un Watchdog para vaciar el registro del router cada X segundos a un servidor FTP o Flash

De manera similar, puede utilizar un vigilante para volcar el registro del router cada X segundos a un servidor FTP o flash:

event manager applet dump-log
  event timer watchdog name timer time 1800
  action 0.5 cli command "enable"
  action 1.0 cli command "show log | append ftp://user:pass@10.1.1.1/debugs.txt"

También puede utilizar un script Expect en un dispositivo UNIX dentro de un cronjob para extraer el registro cada X minutos. En lugar de empujarlo con EEM; reemplace el nombre de usuario y la contraseña por las cadenas adecuadas para las credenciales de inicio de sesión:

 > dhcp-64-102-154-159:Desktop sholl$ cat login-script  
 > #!/usr/bin/expect  
 >
 > set timeout 60 
 > spawn telnet -N 10.1.1.1
 >
 > # Uncomment these if you are prompted for a username by the router 
 > # expect "login:"
 > # send "username\n"
 > expect "Password: "
 > send "password\n"
 > expect ">"
 > send "en\n"
 > expect "Password:"
 > send "password\n"
 > expect "#"
 > send "term len 0\n"
 > expect "#"
 > send "sh log\n"
 > expect "#"
 > send "exit\n"
 > send "exit\n"
 >
 > dhcp-64-102-154-159:Desktop sholl$ crontab -e 
 >
 > # min   hour    mday    month   wday    command
 >    0     4       0        0       0     Desktop/login-script >> outputlog.txt

Activar depuraciones en el arranque del router

Habilite debugs en el inicio del router; cambie las depuraciones a lo que desee habilitar:

event manager applet en-debugs-at-boot
event timer cron cron-entry "@reboot"
  action 1.0 cli command "enable"
  action 2.0 cli command "debug isdn q931"
  action 2.2 cli command "debug isdn q921"
  action 2.4 cli command "debug isdn standard"

Inhabilitar Depuraciones después de un Mensaje Específico

Desactive las depuraciones después de que se detecte un mensaje de depuración específico para evitar que el registro se llene. Desactive la secuencia de comandos EEM (en sí misma) después. Cambie el patrón según la situación:

event manager applet disableDebugsOnError
  event syslog occurs 1 pattern "Endpt not available"
  action 3.0 cli command "enable"
  action 3.2 cli command "un all"
  action 3.3 cli command "config t"
  action 3.4 cli command "no event manager applet disableDebugsOnError"
  action 3.5 cli command "end"

Troubleshoot

Solución de problemas de VPN

Aunque la mayoría de las formas de problemas de VPN generalmente no requieren EEM para resolver problemas, en algunos casos el problema puede ser transitorio, lo que dificulta obtener la información necesaria. Entre los casos pertinentes se incluyen:

• Utilice EEM para Resolver Problemas de Interrupciones/Interrupciones de IGP a través de VPN
• Secuencias de comandos de EEM utilizadas para solucionar problemas de inestabilidad de túnel causados por índices de parámetros de seguridad no válidos
• Mensaje de error Syslog "%CRYPTO-4-RECVD_PKT_MAC_ERR:" con Ping Loss Over IPsec Tunnel Troubleshooting

Solucionar problemas de alta utilización de la CPU

Se suele encontrar que a veces la utilización de la CPU se incrementa durante un período de tiempo muy corto y en momentos indeterminados. Por lo tanto, se hace muy difícil ejecutar los comandos que deben ejecutarse en el momento de la utilización alta de la CPU. Aquí es cuando un script EEM puede ser muy útil. Establezca los valores de la CPU en los que debe activarse y obtiene los resultados del comando.

Esta es una secuencia de comandos de ejemplo y debería personalizarse según sus necesidades:  

 event manager applet capture_cpu_spike
   event snmp oid 1.3.6.1.4.1.9.2.1.56 get-type next entry-op ge entry-val 60
   exit-time 10 poll-interval 1
   action 001 syslog msg "CPU Utilization is high"
   action 002 cli command "en"
   action 003 cli command "show proc cpu sort | append flash:cpuinfo"
   action 004 cli command "show proc cpu sort | append flash:cpuinfo"
   action 005 cli command "show stack 236 | append flash:cpuinfo"
   action 006 cli command "show call active voice brief | append flash:cpuinfo"
   action 007 cli command "show voip rtp connection | append flash:cpuinfo"
   action 008 cli command "show isdn call-rate | append flash:cpuinfo"
   action 009 cli command "show log | append flash:cpuinfo"
   action 010 cli command "show mem stat his | append flash:cpuinfo"
   action 011 cli command "show proc cpu his | append flash:cpuinfo"
   action 012 cli command "show align | append flash:cpuinfo"

La secuencia de comandos anterior no sólo detecta la utilización de la CPU y ejecuta los comandos, sino que también agrega los resultados a la memoria flash: o cualquier otro lugar de elección. Se activa cuando la utilización de la CPU supera el 60 %. Esto debe personalizarse según sus necesidades. Sin embargo, se debe tener cuidado al considerar el espacio libre del sistema de archivos antes de implementar el script. 

Información Relacionada

• Referencia de Comandos de Administración de Redes de Cisco IOS
• Comunidad de soporte de Cisco: secuencias de comandos de EEM
• Soporte Técnico y Documentación - Cisco Systems

Historial de revisiones