Aumento do rastreamento

Introdução

O Sistema de Gerenciamento de Eventos (EMS - Event Management System) do Cisco Intelligent Contact Management (ICM) fornece uma interface de programa de aplicativos (API - Application Program Interface) para processos do ICM a serem usados para relatar eventos. Este documento discute como ativar o rastreamento para ajudar a solucionar problemas no Cisco ICM.

Pré-requisitos

Requisitos

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

• ICM Cisco

• Microsoft Windows NT versão 4 e Windows 2000

Componentes Utilizados

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

• Cisco ICM versão 4.6.2 e posteriores

• Microsoft Windows versão 4 e Windows 2000

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a sua rede estiver ativa, certifique-se de que entende o impacto potencial de qualquer comando.

Conventions

Consulte as Convenções de Dicas Técnicas da Cisco para obter mais informações sobre convenções de documentos.

Ativar Rastreamento

Há duas maneiras de documentar problemas no Cisco ICM: com a API ou ativando o rastreamento.

API

Use a API para:

• Registre um evento no arquivo de registro EMS local.

• Registre um evento no Registro de Eventos do Aplicativo do Microsoft Windows NT/2000.

• Enviar um evento ao servidor de banco de dados para armazenamento no banco de dados do Cisco ICM.

• Envie um evento para o serviço de encaminhamento de atendimento ao cliente central para entrega ao Centro de Assistência Técnica da Cisco (TAC).

Ativar Rastreamento

Para solucionar problemas do ICM, você pode ativar o rastreamento com um destes procedimentos:

• Editor do Registro do Microsoft Windows NT ou Windows 2000

• Utilitário Regacc

• OPCtest

• rttest

• Procmon

Observação: certifique-se de desativar todo o rastreamento quando terminar. Além disso, o mais importante, não deixe as janelas de comando do processo abertas quando terminar o teste. Isso afeta seriamente os recursos do sistema, especialmente a utilização da CPU e da memória.

Editor do Registro do Windows NT ou Windows 2000

Conclua estas etapas para executar regedit32:

1. Escolha Start > Run.

2. Digite regedt32 para abrir o Editor do Registro do Windows NT ou do Windows 2000.

   Este é um exemplo das configurações do Editor do Registro e do Gerenciador de interface de periférico (PIM) do EMS. Para exibir essas configurações, navegue até este caminho:

   • Cisco ICM versão 4.6 e anterior:

     Software\geotel\icr\cust_inst\ICRcomponenttype\EMS\CurrentVersion\
       Library\Processes

   • Cisco ICM versão 5.0 e posterior:

     Software\Cisco Systems,Inc.\icm\cust_inst\ICMcomponenttype\EMS\
       CurrentVersion\Library\Processes

   Idealmente, você verá as teclas no lado esquerdo da janela Editor do Registro e os valores no lado direito.

3. Clique duas vezes no valor que deseja alterar e a caixa de diálogo Editor de DWORD será exibida.

4. No painel Radix, clique em Hex.

5. Altere o valor.

6. Click OK.

Esta tabela mostra os valores que você pode alterar no Editor do Registro. Os valores mais comuns a serem alterados são AllLogFileMax, LogFileMax e TraceMask. A contagem do arquivo de log nunca deve ser alterada.

Valor	Caminho
EMSAllLogFileMax	Tamanho máximo total de todos os arquivos de log EMS para o processo. O padrão é 6000000/6 MB ou 2000000/2 MB.
ContagemDeArquivosDeRegistroDeTodosEMSA	Número de arquivos de log EMS para o processo. O padrão é 20 e geralmente não precisa ser alterado.
EMSLogFileMax	O tamanho máximo de cada arquivo de log do EMS. O padrão é 100000 ou 100K.
EMSTraceMask	Bit de rastreamento para que o processo tenha mais dados registrados nos arquivos de log do EMS. O padrão é 0.
EMSUsuárioDados	Deixe este campo em branco. A definição de bits de rastreamento em procmon preenche esse campo automaticamente.
EMSDisplayToScreen	O padrão é 1. Defina como 0 para não exibir os dados na janela do processo. Isso consome menos CPU e permite acesso mais fácil a pcAnywhere.

Se você precisar aumentar o rastreamento para solucionar problemas, primeiro determine a quantidade de espaço livre em disco na máquina. Se houver espaço em disco suficiente disponível, faça as seguintes alterações:

• Defina EMSAllLogFileMax como 100 MB.

  Observação: primeiro verifique se há espaço em disco suficiente na unidade em que o Cisco ICM está instalado.

• Defina EMSLogFileMax como 10 MB.

• Defina EMSDisplayToScreen como 0.

• As alterações de registro devem ser feitas para cada processo do qual você planeja coletar logs.

  Observação: lembre-se de que EMSAllLogfilesMTax é cumulativo. Se você definir EMSAllLogfilesMax como 100 MB para OPC, PIM1, PIM2 e CTISVR, use 400 MB do espaço disponível na unidade.

• Os tamanhos de arquivo sugeridos são apenas um ponto de referência. Centrais de contato grandes e ocupadas podem precisar aumentar EMSAllLogfilesMax para garantir que os registros não sejam substituídos.

Exibir Rastreamentos de Mensagem

Quando as mensagens forem capturadas, exiba-as com o utilitário EMS dumplog. O Dumplog lê um arquivo de log EMS, formata os dados de eventos e grava os dados formatados em um arquivo de saída. Se o arquivo de log incluir eventos de rastreamento de mensagem, cada mensagem rastreada será exibida em formato decodificado na saída de dumplog.

Quando os dados forem capturados, redefina os valores alterados.

Utilitário Regacc

O utilitário regacc é orientado por comandos e pode ser usado em uma sessão Telnet. Digite regacc no prompt de comando. Esta tabela lista os comandos regacc mais comuns:

Comando	O que ele faz
regcd	Altera o diretório atual do Registro.
regdir	Lista o diretório atual do Registro.
regpwd	Imprime o diretório de trabalho atual.
regset	Define um novo valor do Registro no diretório de trabalho do Registro atual.
q	Sai do utilitário regacc.
?	Exibe a Ajuda do regacc.
comando /?	Exibe a sintaxe de um comando individual.

Este exemplo mostra como acessar o diretório que contém os processos para ativar o rastreamento. Execute o comando regcd para alterar o diretório e, em seguida, o comando regdir para exibir o conteúdo do diretório de trabalho atual.

regcd
Cisco ICM version 4.6 and earlier:
regacc:regcd software\geotel\icr\cal\pg1a\ems\currentversion\library\processes

Cisco ICM version 5.0 and later:
regacc:regcd software\Cisco Systems, Inc.\icm\cal\pg1a\ems\currentversion\library\processes
regacc:regdir
		<KEY>       : DCServer
               <KEY>       : et
               <KEY>       : hsl
               <KEY>       : mds
               <KEY>       : mis
               <KEY>       : nm
               <KEY>       : nmm
               <KEY>       : opc
               <KEY>       : pgag
               <KEY>       : pim1
               <KEY>       : tsyp

Observação: esse valor é exibido em várias linhas devido a limitações de espaço.

Nesse caso, o processo PIM precisa de rastreamento. O comando regcd é usado para mover para o diretório pim1, e o comando regdir para visualizar o conteúdo desse diretório.

regacc:  regcd pim1 
regacc:regdir

EMSAllLogFilesMax             : REG_DWORD: 1e8480
EMSBreakOnExit                : REG_DWORD: 0x0
EMSBreakOnInit                : REG_DWORD: 0x0
EMSDebugBreak                 : REG_DWORD: 0x1
EMSDisplayToScreen            : REG_DWORD: 0x1
EMSForwardLevel               : REG_DWORD: 0x1
EMSLogFileCountMax            : REG_DWORD: 0x3e8
EMSLogFileLocation            : REG_SZ: logfiles
EMSLogFileMax                 : REG_DWORD: 0x186a0 
EMSNTEventLogLevel            : REG_DWORD: 0x2
EMSTraceMask                  : REG_DWORD: 0x0
EMSUserData                   : REG_BINARY: FFFF

O comando regset é usado para alterar o valor. Neste exemplo, o tamanho de EMSLogFileMax é alterado de 5 MB para 1 MB.

Observação: você deve usar formatos hexadecimais ao alterar valores.

regacc:regset emsalllogfilesmax 1e8480 
emsalllogfilesmax 1e8480                    :REG_DWORD:  1e8480

OPCTest, Rttest e Procmon

Aqui está uma explicação dos processos usados no rastreamento.

OPCtest

Você pode usar o OPCTest para ativar o rastreamento somente para o processo OPC. Ative os medidores de rastreamento individuais com o comando debug. Em OPCTest, digite debug /? para obter mais informações sobre o comando.

Se o processo for confirmado ou se os serviços forem interrompidos, as opções especificadas serão desativadas. Ainda é necessário usar o comando regacc ou regedt32 para aumentar EMSAllLogFilesMax e EMSLogFilesMax para que os dados não sejam incluídos na saída.

Para desativar o rastreamento do OPCTest, execute o comando debug /noall. Não se esqueça de minimizar todas as janelas de processo ao concluir os testes.

Consulte Utilização do Utilitário de Linha de Comando de Teste do OPC para obter mais informações sobre OPCTest.

Rttest

Você pode executar o comando rttest para ativar o rastreamento somente para o processo RTR. Use o comando debug para ativar medidores de rastreamento individuais. Em rttest, digite debug /? para obter mais informações sobre o comando.

Se o processo for confirmado ou se os serviços forem interrompidos, as opções especificadas serão desativadas. Ainda é necessário usar o comando regacc ou regedt32 para aumentar EMSAllLogFilesMax e EMSLogFilesMax para que os dados não sejam incluídos na saída.

Consulte O Utilitário Cisco ICM rttest para obter mais informações sobre rttest.

Procmon

Você pode usar procmon para ativar o rastreamento nos processos pims, mis e ctiserver. Infelizmente, não há uma opção padrão para ativar o rastreamento para esses processos. Por exemplo, a opção para o switch Definity é debug, enquanto para iniciar um rastreamento PIM VRU, você deve definir o medidor de rastreamento e usar o comando ltrace para exibir os medidores de rastreamento. Para ver mais informações sobre o uso de procmon, digite o seguinte no prompt do DOS:

procmon custname device process

Execute o comando mhelp para listar as opções para o processo individual.

Aqui está um exemplo das opções para o switch Definity:

C:\>procmon cust pg2a pim1
>>>>debug /?
Usage: acd_debug [/noagent] [/agent] [/agent+] [/agent++] [/nobri] [/bri]
                 [/bri+] [/nocall] [/call] [/call+] [/nocms] [/cms] [/cms+]
                 [/noconfig] [/config] [/nocv] [/cv] [/noerror] [/error]
                 [/nohb] [/hb] [/ken] [/ken+] [/noken] [/noopc] [/opc]
                 [/nopost] [/post] [/nosim] [/sim] [/notg] [/tg] [/notimer]
                 [/timer] [/notp] [/tp] [/tp+] [/trace] [/novq] [/vq] [/vq+]
                 [/warning] [/nowarning] [/all] [/noall] [/set UserSetBit]
                 [/help] [/?]

O utilitário regacc é construído em procmon. Em procmon, você pode executar o comando mhelp para visualizar os comandos regacc.

Se o processo for confirmado ou se os serviços forem interrompidos, as opções especificadas serão desativadas. Ainda é necessário usar os comandos regacc ou regedt32 para aumentar EMSAllLogFilesMax e EMSLogFilesMax para que os dados não sejam incluídos na saída.

Para desativar o rastreamento de procmon, digite debug /noall. Não se esqueça de minimizar todas as janelas de processo ao concluir os testes.

Consulte Utilização do Remote Process Monitor Console (Procmon) para obter mais informações sobre procmon.

Informações Relacionadas

• Usando o utilitário OPC Test Command Line
• Utilitário ICM rttest Cisco
• Usando o Procmon (console de monitor de processo remoto)
• Como usar o utilitário Dumplog
• Suporte Técnico - Cisco Systems