Introduction
Este documento descreve o utilitário dumplog, que permite exibir logs de processo do Cisco Intelligent Contact Management (ICM).
Prerequisites
Requirements
A Cisco recomenda que você tenha conhecimento destes tópicos:
- Como solucionar problemas de software
- ICM Cisco
Componentes Utilizados
As informações neste documento são baseadas no Cisco ICM.
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. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.
O que faz o utilitário dumplog?
O utilitário dumplog converte os arquivos de log binários gravados pelos processos do Cisco ICM em formato legível. Depois de convertido, o conteúdo do arquivo de log pode ser consultado para obter informações sobre a operação do ICM. Geralmente, o dumplog é usado como uma ferramenta para solucionar problemas, mas também pode ser educacional.
O utilitário dumplog pode ser chamado de um prompt de comando diretamente no servidor ICM ou de uma sessão Telnet para o servidor ICM.
Note: Os próximos exemplos supõem que o ICM esteja instalado na unidade C. Se o ICM estiver instalado em uma unidade diferente, os locais do diretório serão alterados de acordo.
Para as convenções de nome de servidor usadas neste documento, consulte Convenções de Nome de Servidor do ICM.
Como chegar ao diretório Logfile
O caminho para o diretório do arquivo de log do Cisco ICM é <root>\icm\customer instance name\node name, onde <root> é a unidade onde o ICM está instalado, por exemplo, C, D ou E.
Por exemplo, se você considerar que o Cisco ICM Call Router está instalado na unidade C, o diretório de arquivo de log no geocscortra estaria localizado em: c:\icm\csco\rtra\logfiles.
Note: Isso pode ser usado como atalho para o diretório logfiles: c:\>cdlog <cust_inst> <ICM_Node>.
Uso
As opções de linha de comando para o utilitário dumplog são mostradas nesta seção. Eles podem ajudá-lo a resolver problemas, pois permitem que você visualize os arquivos de log do Cisco ICM em um período de tempo específico. O período de tempo pode ser definido com as opções /bd, /bt, /ed e /et. O usuário também pode procurar uma sequência específica para isolar e solucionar problemas de comportamento questionável do ICM.
Essas informações também podem ser encontradas no Guia do Administrador do Cisco Intelligent Call Router.
dumplog [ProcessName(s)] [/dir Dirs] [/if InputFile] [/o]
[/of OutputFile]
[/c] [/bd BeginDate(mm/dd/yyyy)] [/bt BeginTime(hh:mm:ss)]
[/ed EndDate(mm/dd/yyyy)] [/et EndTime(hh:mm:ss)] [/hr HoursBack]
[/all] [/last] [/prev] [bin] [/m MatchString] [/x ExcludeString] [/ms] [/debug]
[/ciscoLog]
[/unzipCmdPrefix Prefix for Unzip command]
[/unzipCmdInfix Infix for Unzip command]
[/unzipCmdPostfix Postfix for Unzip command]
[/unzipTempfile Temporary filename for unzip command]
[/zipPostfix Postfix of zipped files]
[/tzadjustoff]
[/help] [?]
Descrições de Parâmetros
| Nomedo(s) processo(s) |
O comando despeja o log do dia atual para esse processo, a menos que você especifique datas ou horas diferentes com outros argumentos. |
| [/dir Diretórios] |
Diretório especifica o local dos arquivos de log para todos os processos listados na linha de comando após a opção /dir. Se no /dir switch for usado, o diretório atual é usado por padrão. |
| [/se] |
InputFile especifica um arquivo .ems específico para despejo. O token /if é opcional. Se você especificar um arquivo de entrada, os argumentos /bd, /bt, /ed, /et, /hr e /all serão ignorados. |
| /o |
Grava a saída em um arquivo de texto no diretório \logfiles. O nome do arquivo é formado quando você adiciona o sufixo .txt ao prefixo do processo especificado ou ao nome do arquivo de entrada (sem o sufixo .ems). O arquivo é gravado no diretório atual. |
| /of |
OutputFile especifica um arquivo de texto de saída; por exemplo, c:\temp\mylog.txt. |
| /c |
Especifica a saída contínua. O comando não sai depois de chegar ao final do registro. Em vez disso, ele espera e grava todas as entradas adicionais que aparecem no registro. |
| /bd |
BeginDate(mm/dd/aaaa) especifica a data de início. Se usado com /bt, especifica um intervalo de datas. Caso contrário, o dumplog despeja eventos somente para a data especificada. |
| /bt |
BeginTime(hh:mm:ss) especifica a hora de início. Use with /et para especificar um intervalo de tempo. |
| /ed |
EndDate(mm/dd/aaaa) especifica a data de término. Use with /bd para especificar um intervalo de dias. |
| /et |
EndTime(hh:mm:ss) especifica a hora de término. Use with /bt para especificar um intervalo de tempo. |
| /hr |
HorasAnteriores especifica um número de horas anteriores à hora atual. |
| /all |
Exibe todas as informações dos arquivos de log de processo especificados. |
| /last |
Exibe informações do arquivo de log mais recente do processo. |
| /prev |
Exibe informações sobre o último arquivo de log do processo. |
| /m |
MatchString exibe somente eventos que contêm uma correspondência para a cadeia de caracteres especificada. |
| /x |
ExcludeString exibe somente eventos que não contêm uma correspondência para a cadeia de caracteres especificada. |
| [/ms] |
Exibe milissegundos em carimbos de data/hora. |
| [/cm] |
Use várias cores ao despejar logs mesclados. Cada processo recebe uma cor diferente. Você deve especificar um ProcessPrefix ou um InputFile. Se você fornecer apenas um valor ProcessPrefix (por exemplo, rtr, nm ou lgr), dumplog exibirá o log do dia atual para esse processo por padrão. |
| /ciscoLog |
Ativa a funcionalidade CiscoLog. |
| /unzipCmdPrefix |
Parâmetros de prefixo para unzip, por exemplo gzip -d -c. |
| /unzipCmdInfix |
Parâmetro de infixo para unzip, por exemplo ">". |
| /unzipCmdPostfix |
Parâmetro Postfix para unzip, por exemplo "". |
| /unzipTempfile |
Arquivo temporário para descompactação, por exemplo "temp.ems". |
| /zipPostfix |
Parâmetro de sufixo de arquivo, por exemplo ".gz". |
| /tzadjustoff |
Quando os arquivos EMS são copiados para um sistema em um fuso horário diferente, ou se o fuso horário no sistema for alterado, sem essa opção, todas as consultas feitas são relativas à máquina em que os arquivos de log foram gerados. Caso contrário, /tzadjust é usado para alternar o comportamento onde as consultas são feitas em relação a esse tempo da máquina. |
Note: Para visualizar os arquivos de log redirecionados com o Microsoft Notepad, salve o arquivo de log em um arquivo de texto (use o argumento dumplog /of) e abra o arquivo de texto no prompt de comando com o comando notepad filename.
Exemplo de uso de dumplog
Este exemplo mostra como fazer o dump do arquivo de log de rtr no roteador de 29 de abril de 1999 até 30 de abril de 1999. Ele gera um arquivo de log chamado rtr.txt. O arquivo rtr.txt agora pode ser visualizado com um editor de texto padrão, como o Notepad.
c:\icm\csco\rtra\logfiles dumplog rtr /bd 04/29/1999 /ed 04/30/1999 /o
Este comando faz o dump do arquivo de log pgag de um gateway periférico (PG) começando na última vez que um novo arquivo de log foi aberto para saída.
c:\icm\csco\rtra\logfiles dumplog pgag /last
Esse comando despeja logs de vários processos na maneira entrelaçada e grava a saída em um único arquivo de saída.
dumplog /ms /hr 1 /of output.txt rtr mds rts
14:51:40:298 ra-rts Trace: Received 1 System Capacity Real Time records
14:51:40:298 ra-rts Trace: Updating base System Capacity Real Time record for ID1 1 and ID2 0, cbRecSize=96
14:51:43:298 ra-rtr Trace: TIP: TIPUpLink::sendCongestionControlTIPMsg Sent CongestionControlEvent
14:51:46:298 ra-rtr Trace: TIP: TIPUpLink::sendCongestionControlTIPMsg Sent CongestionControlEvent
14:51:49:298 ra-rtr Trace: TIP: TIPUpLink::sendCongestionControlTIPMsg Sent CongestionControlEvent
14:51:49:688 ra-mds MDS Process is reporting periodic overall metering statistics.
Uma sintaxe com hífens também é suportada.
dumplog -ms -hr 1 -of output.txt rtr mds rts
Feedback