Este documento describe cómo configurar el seguimiento en Cisco Unified Contact Center Enterprise (UCCE) para clientes, servicios de gateway periférico (PG), el portal de voz del cliente (CVP) de Cisco, el Marcador de salida de Cisco UCCE, Cisco Unified Communications Manager (CallManager) (CUCM) y gateways de Cisco.
Cisco recomienda que tenga conocimiento sobre estos temas:
Inicie sesión en el servidor Finesse con Secure Shell (SSH) e introduzca estos comandos para recopilar los registros que necesita. Se le solicita que identifique un servidor FTP (SFTP) de SSH en el que se cargarán los registros.
Registros | Comando |
---|---|
Instalar registros | file get install desktop-install.log |
Registros del escritorio | archivo get activelog desktop recurs compress |
Registros del servicio | archivo get activelog platform/log/servm*.\* compress |
Registros de Tomcat de plataforma | archivo get activelog tomcat/logs recurs compress |
Registros de instalación del sistema operativo de voz (VOS) | file get install install.log |
Este procedimiento describe cómo crear y recopilar archivos de depuración:
[Debug Log]
Path=..\log\agent.dbg
Size=3000000
Threshold=DEBUG
Este procedimiento describe cómo crear y recopilar archivos de depuración:
[Debug Log]
Path=..\log\supervisor.dbg
Size=3000000
THRESHOLD=DEBUG
En el equipo cliente donde está instalado el cliente CTIOS, utilice Regedt32 para activar el seguimiento. Cambie esta configuración:
Versión | Ubicación del registro | Valor Predeterminado | Cambiar |
---|---|---|---|
Versiones anteriores a 7.x | HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging\TraceMask | 0x07 | Aumente el valor a 0xfff. |
Versión 7.x y posterior | HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\CTIOS Rastreo | 0x4000307 | Establezca el valor en 0xfff para la resolución de problemas. |
El resultado predeterminado se crea y se coloca en un archivo de texto denominado CtiosClientLog en el directorio c:\Program Files\Cisco Systems\CTIOS Client\CTIOS Desktop Phones\ install directory.
Estos son los ajustes para depurar el servicio CAD Sync:
Configuración | Valor |
---|---|
Archivo de configuración Ubicación predeterminada |
DirAccessSynSvr.cfg C:\Program Files\Cisco\Desktop\config |
Problemas generales | Threshold=DEBUG |
Archivos de salida | DirAccessSynSvr.log |
Estos son los ajustes para depurar el servidor RASCAL de CAD 6.0(X):
Configuración | Valor |
---|---|
Archivo de configuración Ubicación predeterminada |
FCRasSvr.cfg C:\Program Files\Cisco\Desktop\config |
Problemas generales | Intervalo = 1-4, 50, 3000-8000 |
Problemas relacionados con LDAP: | Intervalo = 4000-4999 |
Problemas relacionados con LRM: | Intervalo = 1999-2000 |
Problemas relacionados con la base de datos | Intervalo = 50-59 |
Archivos de salida Ubicación predeterminada |
FCRasSvr.log, FCRasSvr.dbg C:\Program Files\Cisco\Desktop\log |
Estos son los ajustes para depurar el servidor de chat:
Configuración | Valor |
---|---|
Archivo de configuración Ubicación predeterminada |
FCCServer.cfg C:\Program Files\Cisco\Desktop\config |
Problemas generales | Threshold=DEBUG |
Archivos de salida Ubicación predeterminada |
FCCServer.log, FCCServer.dbg C:\Program Files\Cisco\Desktop\log |
Consulte Uso de la utilidad Dumplog para extraer registros para la recopilación de registros.
Utilice la utilidad de supervisión de procesos (procmon) para activar y desactivar los niveles de seguimiento. Estos comandos activan el seguimiento del administrador de interfaz periférica (PIM) de 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 desactiva el seguimiento de PIM de CallManager:
>>>trace * /off
Este procedimiento describe cómo activar el seguimiento de CUCM:
Estos comandos procmon activan el seguimiento 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
Un comando de ejemplo es procmon ipcc pg1a jgw1.
Este procedimiento describe cómo habilitar el seguimiento CTISVR en el lado activo:
Estos comandos procmon activan el seguimiento para el PIM VRU:
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 desactiva el seguimiento de PIM de VRU:
>>>trace * /off
Este procedimiento describe cómo habilitar el seguimiento en ambos servidores CTIOS:
La máscara de seguimiento predeterminada es 0x3 en todas las versiones excepto en la versión 7.0(0), donde es 0x20003.
Si la máscara de seguimiento tiene un valor alto (0xf o superior), hay un gran impacto en el rendimiento del servidor CTIOS y en la tasa de finalización de llamadas. Establezca la máscara de seguimiento en un valor alto sólo cuando esté depurando un problema; una vez que haya recopilado los registros necesarios, debe volver a establecer la máscara de seguimiento en su valor predeterminado.
Para solucionar problemas, configure la máscara de seguimiento del servidor CTIOS en:
Estos comandos opctest activan el seguimiento OPC en un PG activo:
opctest /cust <cust_inst> /node <node>
opctest:debug /agent /routing /cstacer /tpmsg /closedcalls
Este es un ejemplo de un entorno de laboratorio:
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
Otros ejemplos son:
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
Estos comandos procmon activan el seguimiento de eagtpim en un PG activo:
C:\>procmon <cust_inst> <node> pim<pim instance
>>>>trace tp* /on
>>>trace precall /on
>>>trace *event /on
>>>trace csta* /on
Este es un ejemplo de un entorno de laboratorio:
C:\Documents and Settings\ICMAdministrator>procmon cc1 pg1a pim1
>>>>trace tp* /on
>>>>trace precall /on
>>>>trace *event /on
>>>>trace csta* /on
>>>>quit
Refiérase a Cómo Utilizar la Utilidad Dumplog para obtener detalles adicionales. Utilice el comando cdlog para llegar al directorio logfiles, como se muestra en este ejemplo:
c:\cdlog <customer_name> pg1a !-- Or, pgXa to depending on the PG number (X)
c:\icm\<customer_name>\<<PG#>>\logfiles\
Estos ejemplos muestran cómo colocar el resultado en el archivo predeterminado; en todos los casos, puede utilizar /de para definir un nombre específico para el archivo de salida:
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 procedimiento describe cómo habilitar el seguimiento en servidores CVP con el software del teléfono IP SIP de Cisco:
Este procedimiento describe cómo habilitar el seguimiento en servidores CVP con una gateway H323:
setcalltrace on
setinterfacetrace on
Recopile el archivo CVP *.log y los archivos Error.log durante el período de prueba. Estos archivos se encuentran en el directorio C:\Cisco\CVP\logs directory on both CVP servers.
Estas son las ubicaciones de los archivos de registro de Unified CVP, donde CVP_HOME es el directorio en el que está instalado el software Unified CVP.
Tipo de registros | Ubicación |
---|---|
Registros de servidor de llamadas o de servidor de informes |
CVP_HOME\logs\ |
Registros de la consola de operaciones | CVP_HOME\logs\OAMP\ |
Registros de servidor XML de voz (VXML) | CVP_HOME\logs\VXML\ |
Registros de agentes del protocolo simple de administración de red (SNMP) | CVP_HOME\logs\SNMP\ |
Registros del administrador de recursos de Unified CVP | CVP_HOME\logs\ORM\ |
Una ubicación de ejemplo es C:\Cisco\CVP.
Para aplicaciones XML de voz personalizadas como una aplicación audium implementada, puede activar un registrador de depuración.
Agregue esta línea a la sección <loggers> (la última sección) del archivo de configuración settings.xml en el directorio C:\Cisco\CVP\VXMLServer\applications\APP_NAME\data\application\ directory:
<logger_instance name="MyDebugLogger"
class="com.audium.logger.application.debug.ApplicationDebugLogger"/>
En tiempo de ejecución, este registrador envía un registro VoiceXML detallado a \Cisco\CVP\VXMLServer\applications\APP_NAME\MyDebuggerLogger directory.
Este procedimiento describe cómo aumentar los registros del proceso de badialer en el Marcador de salida (que normalmente se encuentra en un PG).
Ejecute la utilidad dumplog desde el directorio /icm/<instance>/dialer/logfiles:
dumplog badialer /bt hh:mm:ss /et hh:mm:ss /o
Este procedimiento describe cómo aumentar el registro del proceso baimport.
dumplog baimport /bt hh:mm:ss /et hh:mm:ss /o
Este procedimiento describe cómo aumentar el registro del proceso del administrador de campañas.
dumplog campaignmanager /bt hh:mm:ss /et hh:mm:ss /o
En el PG de Avaya Communications Manager (ACD), utilice la utilidad opctest para aumentar lo siguiente tanto para CallManager como para Avaya.
C:\opctest /cust <instance> /node <pgname>
opctest: type debug /agent /closedcalls /cstacer /routing
opctest: q !-- Quits
Este procedimiento describe cómo aumentar el seguimiento para el proceso ctisvr.
Este procedimiento describe cómo habilitar los registros del router:
Para opctest Release 8.5, use el Diagnostic Framework Portico en su lugar.
debug level 3 component "icm:Router A" subcomponent icm:rtr
Utilice la utilidad dumplog para extraer los registros del router de cualquier router durante el período de tiempo de las pruebas. Refiérase a Cómo Utilizar la Utilidad Dumplog para obtener detalles adicionales.
Este es un ejemplo de una solicitud de registro para los registros del 21/10/2011 entre las 09:00:00 y las 09:30:00 (en formato de hora de 24 horas). Esta salida va al archivo 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
Envíe el archivo de resultados (C:/router_output.txt) a Cisco para la resolución de problemas si es necesario.
Estos comandos activan el seguimiento en servidores CVP con 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
Se trata de una plataforma muy robusta que puede manejar las depuraciones sugeridas en el volumen de llamadas proporcionado sin problemas. Sin embargo, Cisco recomienda que:
logging <syslog server ip>
logging trap debugs
show proc cpu hist
Habilitar estos debugs:
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
Después de realizar la llamada y simular el problema, detenga la depuración:
#undebug all
Recopile este resultado:
term len 0
show ver
show run
show log
Estos comandos activan el seguimiento SIP en el proxy SIP de Cisco Unified (CUSP):
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
Recuerde desactivar la sesión cuando haya terminado.
Este procedimiento describe cómo recopilar los registros:
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
En UCCE versión 8 y posteriores, puede utilizar la interfaz de línea de comandos (CLI) de Unified System para recopilar seguimientos. En comparación con las utilidades dumplog, la CLI es un método muy rápido y eficiente para obtener un conjunto completo de registros de un servidor como un PG o Rogger.
Este procedimiento describe cómo iniciar el análisis de problemas y cómo determinar qué seguimiento habilitar. El ejemplo recopila registros de estos servidores:
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect
dir c:\temp
Reemplace la primera cadena mm-dd-yyyy:hh:mm por una fecha y hora aproximadamente 15 minutos antes del evento.
Reemplace la segunda cadena mm-dd-yyyy:hh:mm por una fecha y hora que es aproximadamente 15 minutos después de que se resuelva el evento. Si el evento continúa, reúna al menos 15 minutos.
Recopile esta información adicional si es posible:
Hay dos herramientas: una herramienta Diagnostic Framework y la herramienta CLI del sistema. Ambos son iconos en el escritorio o en el directorio Programs de cada servidor.
Este procedimiento describe cómo utilizar la CLI de Unified System para el seguimiento.
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect dir c:\temp