Este documento descreve como definir o rastreamento no Cisco Unified Contact Center Enterprise (UCCE) para clientes, serviços de gateway periférico (PG), Cisco Customer Voice Portal (CVP), Cisco UCCE Outbound Dialer, Cisco Unified Communications Manager (CallManager) (CUCM) e gateways Cisco.
A Cisco recomenda que você tenha conhecimento destes tópicos:
Faça login no servidor Finesse com o Shell Seguro (SSH) e insira esses comandos para coletar os registros necessários. Você é solicitado a identificar um servidor FTP SSH (SFTP) em que os registros serão carregados.
Logs | Comando |
---|---|
Instalar logs | arquivo get install desktop-install.log |
Logs da área de trabalho | arquivo get ativelog desktop recurse compress |
Logs do servm | arquivo get ativelog platform/log/servm*.\* compress |
Logs do Platform Tomcat | arquivo get ativelog tomcat/logs compress |
Logs de instalação do sistema operacional de voz (VOS) | file get install install.log |
Este procedimento descreve como criar e coletar arquivos de depuração:
[Debug Log]
Path=..\log\agent.dbg
Size=3000000
Threshold=DEBUG
Este procedimento descreve como criar e coletar arquivos de depuração:
[Debug Log]
Path=..\log\supervisor.dbg
Size=3000000
THRESHOLD=DEBUG
No PC cliente onde o cliente CTIOS está instalado, use Regedt32 para ativar o rastreamento. Altere estas configurações:
Versão | Localização do Registro | Valor padrão | alteram |
---|---|---|---|
Versões anteriores à versão 7.x | HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging\TraceMask | 0x07 | Aumente o valor para 0xfff. |
Versão 7.x e posterior | HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\CTIOS Tracing | 0x40000307 | Defina o valor como 0xfff para a solução de problemas. |
A saída padrão é criada e colocada em um arquivo de texto chamado CtiosClientLog na pasta c:\Program Files\Cisco Systems\CTIOS Client\CTIOS Desktop Phones\ install directory.
Estas são as configurações para depurar o serviço de sincronização do CAD:
Configuração | Valor |
---|---|
Arquivo de configuração Localização padrão |
DirAccessSynSvr.cfg C:\Program Files\Cisco\Desktop\config |
Problemas gerais | Limite=DEBUG |
Arquivos de saída | DirAccessSynSvr.log |
Estas são as configurações para depurar o servidor RASCAL do CAD 6.0(X):
Configuração | Valor |
---|---|
Arquivo de configuração Localização padrão |
FCRasSvr.cfg C:\Program Files\Cisco\Desktop\config |
Problemas gerais | Intervalo = 1-4, 50, 3000-8000 |
Problemas relacionados ao LDAP: | Intervalo = 4000-4999 |
Problemas relacionados ao LRM: | Intervalo = 1999-2000 |
Problemas relacionados ao banco de dados | Intervalo = 50-59 |
Arquivos de saída Localização padrão |
FCRasSvr.log, FCRasSvr.dbg C:\Program Files\Cisco\Desktop\log |
Estas são as configurações para depurar o servidor de bate-papo:
Configuração | Valor |
---|---|
Arquivo de configuração Localização padrão |
FCCServer.cfg C:\Program Files\Cisco\Desktop\config |
Problemas gerais | Limite=DEBUG |
Arquivos de saída Localização padrão |
FCCServer.log, FCCServer.dbg C:\Program Files\Cisco\Desktop\log |
Consulte Usar utilitário Dumplog para puxar registros para coleta de logs.
Use o utilitário de monitoramento de processo (procmon) para ativar e desativar níveis de rastreamento. Esses comandos ativam o rastreamento do gerenciador de interface periférica (PIM) do CallManager:
C:\procmon <Customer_Name> <PG_Name> <ProcessName>
>>>trace tp* !-- Turns on third party request tracing
>>>trace precall !-- Turns on precall event tracing
>>>trace *event !-- Turns on agent and call event tracing
>>>trace csta* !-- Turns on CSTA call event tracing
>>>ltrace !-- Output of all trace bits
>>>q !-- Quits
Este comando procmon desativa o rastreamento PIM do CallManager:
>>>trace * /off
Este procedimento descreve como ativar o rastreamento CUCM:
Esses comandos procmon ativam o rastreamento JGW:
C:\procmon <Customer_Name> <node> process
>>>trace JT_TPREQUESTS !-- Turns on third-party request traces
>>>trace JT_JTAPI_EVENT_USED !-- Turns on traces for the JTAPI Events the PG uses
>>>trace JT_ROUTE_MESSAGE !-- Turns on routing client traces
>>>trace JT_LOW* !-- Traces based on the underlying JTAPI and CTI layers
Um comando de exemplo é procmon ipcc pg1a jgw1.
Este procedimento descreve como ativar o rastreamento CTISVR no lado ativo:
Esses comandos procmon ativam o rastreamento para VRU PIM:
C:\procmon <Customer_Name> <PG_Name> <ProcessName>
procmon>>>trace *.* /off !-- Turns off
procmon>>>trace !-- Verifies what settings are on/off
procmon>>>trace cti* /onprocmon>>>trace opc* /on
procmon>>>trace *ecc* /onprocmon>>>trace *session* /off
procmon>>>trace *heartbeat* /off
procmon>>>ltrace /traceprocmon>>>quit
Este comando procmon desativa o rastreamento do PIM da URV:
>>>trace * /off
Este procedimento descreve como ativar o rastreamento em ambos os servidores CTIOS:
A máscara de rastreamento padrão é 0x3 em todas as versões, exceto a versão 7.0(0), onde é 0x20003.
Se a máscara de rastreamento tiver um alto valor (0xf ou superior), haverá um grande impacto no desempenho do servidor CTIOS e na taxa de conclusão de chamada. Defina a máscara de rastreamento com um valor alto somente quando estiver depurando um problema; depois de coletar os registros necessários, você deve definir a máscara de rastreamento de volta ao valor padrão.
Para fins de solução de problemas, defina a máscara de rastreamento do servidor CTIOS como:
Esses comandos opctest ativam o rastreamento OPC em um PG ativo:
opctest /cust <cust_inst> /node <node>
opctest:debug /agent /routing /cstacer /tpmsg /closedcalls
Este é um exemplo de um ambiente de laboratório:
C:\Documents and Settings\ICMAdministrator>opctest /cust cc1 /node pg1a
OPCTEST Release 8.0.3.0 , Build 27188
opctest: debug /agent /routing /cstacer /tpmsg /closedcalls !-- Use debug /on in
order to restore default tracing levels
opctest: quit
Exemplos adicionais são:
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg
!-- General example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /NCT
!-- Network transfer example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /task /passthru
!-- Multimedia example
opctest:debug /agent /routing /cstacer /rcmsg /closedcalls /inrcmsg /passthru
!-- VRU PG example
Esses comandos procmon ativam o rastreamento eagtpim em um PG ativo:
C:\>procmon <cust_inst> <node> pim<pim instance
>>>>trace tp* /on
>>>trace precall /on
>>>trace *event /on
>>>trace csta* /on
Este é um exemplo de um ambiente de laboratório:
C:\Documents and Settings\ICMAdministrator>procmon cc1 pg1a pim1
>>>>trace tp* /on
>>>>trace precall /on
>>>>trace *event /on
>>>>trace csta* /on
>>>>quit
Consulte Como usar o utilitário Dumplog para obter detalhes adicionais. Use o comando cdlog para chegar ao diretório logfiles, como mostrado neste exemplo:
c:\cdlog <customer_name> pg1a !-- Or, pgXa to depending on the PG number (X)
c:\icm\<customer_name>\<<PG#>>\logfiles\
Estes exemplos mostram como colocar a saída no arquivo padrão; em todos os casos, você pode usar /de para definir um nome específico para o arquivo de saída:
c:\icm\<customer_name>\<PG#>\logfiles\dumplog pim1 /bt <HH:MM> /et <HH:MM> /ms /o
!-- This PIM example places output in a default pim1.txt file
c:\icm\<customer_name>\<PG#>\logfiles\dumplog opc /bt <HH:MM> /et <HH:MM> /ms /o
!-- This OPC example places output in a default opc.txt file
c:\icm\<customer_name>\<PG#>\logfiles\dumplog jgw1 /bt <HH:MM> /et <HH:MM> /ms /o
c:\cdlog <customer_name> cg1a
c:\icm\<customer_name>\<cg#>\logfiles\
!-- This JTAPI example places output in a default jgw1.txt file
c:\icm\<customer_name>\cg#\logfiles\dumplog ctisvr /bt <HH:MM> /et <HH:MM> /ms /o
!-- This CTI server example places output in a default ctisvr.txt file
c:\ icm\<customer_name>\ctios\logfiles\dumplog ctios /bt <HH:MM> /et <HH:MM> /ms /o
!-- This CTIOS server example places output in a default ctios.txt file
Este procedimento descreve como ativar o rastreamento em servidores CVP com o software do Telefone IP Cisco SIP:
Este procedimento descreve como ativar o rastreamento em servidores CVP com um gateway H323:
setcalltrace on
setinterfacetrace on
Colete os arquivos CVP *.log e Error.log durante o período de teste. Esses arquivos estão no diretório C:\Cisco\CVP\logs directory on both CVP servers.
Estes são os locais dos arquivos de log do Unified CVP, onde CVP_HOME é o diretório em que o software Unified CVP está instalado.
Tipo de registro | Local |
---|---|
Registros do servidor de chamadas e/ou do servidor de relatórios |
CVP_HOME\logs\ |
Logs do console de operações | CVP_HOME\logs\OAMP\ |
Logs do servidor XML de voz (VXML) | CVP_HOME\logs\VXML\ |
Logs de agente do Protocolo de Gerenciamento de Rede Simples (SNMP - Simple Network Management Protocol) | CVP_HOME\logs\SNMP\ |
Logs do gerenciador de recursos do Unified CVP | CVP_HOME\logs\ORM\ |
Um exemplo de local é C:\Cisco\CVP.
Para aplicativos XML de voz personalizados, como um aplicativo auxiliar implantado, você pode ativar um depurador de log.
Adicione esta linha à seção <loggers> (a última seção) do arquivo de configuração settings.xml no diretório C:\Cisco\CVP\VXMLServer\applications\APP_NAME\data\application\ directory:
<logger_instance name="MyDebugLogger"
class="com.audium.logger.application.debug.ApplicationDebugLogger"/>
Em tempo de execução, este logger envia um registro VoiceXML detalhado para o diretório \Cisco\CVP\VXMLServer\applications\APP_NAME\MyDebuggerLogger directory.
Este procedimento descreve como aumentar os registros de processo do badialer no Outbound Dialer (que geralmente é encontrado em um PG).
Execute o utilitário dumplog do diretório /icm/<instance>/dialer/logfiles:
dumplog badialer /bt hh:mm:ss /et hh:mm:ss /o
Este procedimento descreve como aumentar o log do processo de importação básica.
dumplog baimport /bt hh:mm:ss /et hh:mm:ss /o
Este procedimento descreve como aumentar o registro de processo do gerenciador de campanhas.
dumplog campaignmanager /bt hh:mm:ss /et hh:mm:ss /o
No Avaya Communications Manager (ACD) PG, use o utilitário opctest para aumentar o seguinte para o CallManager e a Avaya.
C:\opctest /cust <instance> /node <pgname>
opctest: type debug /agent /closedcalls /cstacer /routing
opctest: q !-- Quits
Este procedimento descreve como aumentar o rastreamento para o processo ctisvr.
Este procedimento descreve como ativar os logs do roteador:
Para o opctest Versão 8.5, use o Diagnostic Framework Portico.
debug level 3 component "icm:Router A" subcomponent icm:rtr
Use o utilitário dumplog para extrair os logs do roteador de qualquer um dos roteadores durante o período dos testes. Consulte Como usar o utilitário Dumplog para obter detalhes adicionais.
Este é um exemplo de uma solicitação de log para logs em 21/10/2011 entre 9:00:00 e 9:30:00 (no formato de 24 horas). Esta saída vai para o arquivo C:/router_output.txt:
C:\Documents and Settings\ICMAdministrator>cdlog u7x ra
C:\icm\u7x\ra\logfiles>dumplog rtr /bd 10/21/2011 /bt 09:00:00 /ed 10/21/2011
/et 09:30:00 /ms /of C:/router_output.txt
Envie o arquivo de saída (C:/router_output.txt) para a Cisco para solução de problemas, se necessário.
Esses comandos ativam o rastreamento em servidores CVP com SIP:
#conf t
service timestamps debug datetime msec
service timestamps log datetime msec
service sequence-numbers
no logging console
no logging monitor
logging buffered 5000000 7
end
clear logging
Essa é uma plataforma muito robusta que pode lidar com as depurações sugeridas no volume de chamadas fornecido sem problemas. No entanto, a Cisco recomenda que você:
logging <syslog server ip>
logging trap debugs
show proc cpu hist
Ative estas depurações:
debug isdn q931
debug voip ccapi inout
debug ccsip mess
debug http client all
debug voip application vxml all
debug vtsp all
debug voip application all
Depois de fazer a chamada e simular o problema, pare a depuração:
#undebug all
Coletar esta saída:
term len 0
show ver
show run
show log
Esses comandos ativam o rastreamento SIP no Cisco Unified SIP Proxy (CUSP):
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
Lembre-se de desligar o login quando terminar.
Este procedimento descreve como coletar os registros:
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
No UCCE Versão 8 e posterior, você pode usar a Interface de Linha de Comando (CLI - Command-Line Interface) do Unified System para coletar rastreamentos. Comparado aos utilitários de dumplog, o CLI é um método muito rápido e eficiente para obter um conjunto inteiro de registros de um servidor, como um PG ou Rogger.
Este procedimento descreve como iniciar a análise de problemas e como determinar qual rastreamento ativar. O exemplo coleta registros desses servidores:
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect
dir c:\temp
Substitua primeira string mm-dd-aaaa:hh:mm por uma data e hora aproximadamente 15 minutos antes do evento.
Substitua segunda string mm-dd-aaaa:hh:mm por uma data e hora aproximadamente 15 minutos após o evento ser resolvido. Se o evento ainda estiver ocorrendo, reúna pelo menos 15 minutos.
Reúna essas informações adicionais, se possível:
Há duas ferramentas: uma ferramenta Estrutura de diagnóstico e a ferramenta CLI do sistema. Ambos são ícones na área de trabalho ou no diretório Programas de cada servidor.
Este procedimento descreve como usar a CLI do Unified System para rastreamento.
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect dir c:\temp