Miniaplicativo EEM para capturar a saída da configuração do comando Show Stacks

Introduction

Este documento descreve como configurar um miniaplicativo Cisco IOS^® Embedded Event Manager (EEM) para capturar a saída do comando show stacks. O Cisco Technical Assistance Center (TAC) geralmente precisa dessa saída para solucionar problemas de alta utilização da CPU causados pelo SNMP (Simple Network Management Protocol).

Prerequisites

Requirements

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Simple Network Management Protocol
• Cisco IOS Embedded Event Manager (EEM)
• Syslog

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Cisco IOS versão 15.1(4)M6
• Roteador de serviços integrados Cisco 2811

Note: As configurações neste documento devem funcionar com versões anteriores do software Cisco IOS, já que ambos os miniaplicativos usam a versão 3.0 do EEM, que é suportada no Cisco IOS versão 12.4(22)T ou posterior. No entanto, isso não foi testado.

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.

Configurar

Esses miniaplicativos EEM automatizam o processo para capturar a saída do comando show stacks. Observe que:

• Ambos os miniaplicativos usam o ID de processo (PID) do mecanismo SNMP. Insira o comando show processes cpu para localizar o PID; neste exemplo, o PID é 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#

• O EEM Versão 3.0 ou posterior é necessário para usar as ações de espera. Insira o comando show event manager version para detectar a versão do EEM.
• Os dispositivos do software Cisco IOS que usam Autenticação, Autorização e Contabilidade (AAA) devem definir qual usuário pode executar ações CLI. Use o comando event manager session cli username user para esta configuração, onde user é um nome de usuário autorizado a executar todos os comandos CLI em applets EEM.
• Alguns sistemas de arquivos podem não ser suportados com a opção 'append' para redirecionar a saída. Antes de configurar o miniaplicativo, teste-o manualmente para garantir que você possa redirecionar a saída para seu sistema de arquivos.

O comando show stacks exibe as tarefas que estão sendo tratadas pelo processo especificado. Ao solucionar problemas de alta utilização da CPU, é útil descobrir quais tarefas estão sendo executadas quando a condição ocorre.

Utilização da CPU acima de 50%

Este miniaplicativo EEM detecta quando a utilização da CPU excede 50%. Nesse momento, a saída do comando show stacks é amostrada por nove segundos e gravada em um arquivo chamado SNMP_STACK.txt na memória flash. Essas informações ajudam o TAC a identificar a causa da alta utilização da CPU.

Este exemplo investiga uma condição de CPU alta causada pelo SNMP; você pode usar um applet EEM semelhante para coletar um conjunto diferente de saídas para investigar problemas de alta CPU causados por um processo diferente.

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"

%SNMP-3-INPUT_QFULL_ERR Mensagem de Syslog

Este miniaplicativo EEM é ativado se a mensagem de syslog %SNMP-3-INPUT_QFULL_ERR for gerada. Nesse momento, a saída do comando show stacks é amostrada por nove segundos e gravada em um arquivo chamado SNMP_STACK.txt na memória flash. Essas informações ajudam o TAC a identificar a causa da alta utilização da 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

Verificar

No momento, não há procedimento de verificação disponível para esta configuração.

Troubleshoot

Atualmente, não existem informações disponíveis específicas sobre Troubleshooting para esta configuração.

Informações Relacionadas

• Guia de configuração do Event Manager incorporado, Cisco IOS versão 15M&T
• Suporte Técnico e Documentação - Cisco Systems