Activar rastreo

Introducción

El Sistema de gestión de eventos (EMS) de Cisco Intelligent Contact Management (ICM) proporciona una interfaz de programa de aplicaciones (API) para que los procesos de ICM la utilicen para informar de eventos. Este documento explica cómo activar el seguimiento para ayudar a resolver problemas en Cisco ICM.

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• ICM de Cisco

• Microsoft Windows NT versión 4 y Windows 2000

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• Cisco ICM Versión 4.6.2 y posterior

• Microsoft Windows versión 4 y Windows 2000

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). If your network is live, make sure that you understand the potential impact of any command.

Convenciones

Consulte Convenciones de Consejos TécnicosCisco para obtener más información sobre las convenciones del documento.

Activar seguimiento

Hay dos maneras de documentar los problemas en Cisco ICM, con la API o activando el seguimiento.

API

Utilice la API para:

• Registre un evento en el archivo de registro local de EMS.

• Registre un evento en el registro de eventos de la aplicación de Microsoft Windows NT/2000.

• Envíe un evento al servidor de base de datos para su almacenamiento en la base de datos de Cisco ICM.

• Envíe un evento al servicio de reenvío del servicio de atención al cliente central para su entrega al centro de asistencia técnica Cisco Technical Assistance Center (TAC).

Activar seguimiento

Para resolver problemas de ICM, puede activar el seguimiento con uno de estos procedimientos:

• Editor del Registro de Microsoft Windows NT o Windows 2000

• Utilidad regacc

• OPCtest

• rttest

• Procmon

Nota: Asegúrese de desactivar todo el seguimiento cuando haya terminado. Además, lo que es más importante, no deje abiertas las ventanas de comandos de proceso cuando termine la prueba. Esto afecta gravemente a los recursos del sistema, especialmente la utilización de la CPU y la memoria.

Editor del Registro de Windows NT o Windows 2000

Complete estos pasos para ejecutar regedit32:

1. Elija Start > Run.

2. Escriba regedt32 para abrir el Editor del Registro de Windows NT o Windows 2000.

   A continuación se muestra un ejemplo de la configuración del Editor del Registro y del Administrador de interfaz de periféricos (PIM) de EMS. Para ver esta configuración, navegue a esta trayectoria:

   • Cisco ICM versión 4.6 y anteriores:

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

   • Cisco ICM versión 5.0 y posteriores:

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

   Lo ideal sería ver las claves a la izquierda de la ventana del Editor del Registro y los valores a la derecha.

3. Haga doble clic en el valor que desea cambiar y aparecerá el cuadro de diálogo Editor DWORD.

4. En el panel Radix, haga clic en Hex.

5. Cambie el valor.

6. Click OK.

En esta tabla se muestran los valores que puede cambiar en el Editor del Registro. Los valores más comunes que se deben cambiar son AllLogFileMax, LogFileMax y TraceMask. El recuento de archivos de registro no debe modificarse nunca.

Valor	Trayecto:
EMSAllLogFileMax	Tamaño máximo total de todos los archivos de registro de EMS para el proceso. El valor predeterminado es 6000000/6 MB o 2000000/2 MB.
EMSAllLogFileCount	Número de archivos de registro de EMS para el proceso. El valor predeterminado es 20 y, normalmente, no es necesario modificarlo.
EMSLogFileMax	El tamaño máximo de cada archivo de registro de EMS. El valor predeterminado es 100000 o 100K.
EMSTraceMask	Bit de seguimiento para que el proceso tenga más datos registrados en los archivos de registro de EMS. El valor predeterminado es 0.
EMSUserData	Deje este espacio en blanco. La configuración de bits de seguimiento en procmon rellena automáticamente este campo.
EMSDisplayToScreen	El valor predeterminado es 1. Defina el valor en 0 para no mostrar los datos en la ventana de proceso. Esto supone un menor uso de la CPU y permite un acceso más sencillo a pcAnywhere.

Si necesita aumentar el seguimiento para solucionar problemas, determine primero la cantidad de espacio libre en disco del equipo. Si hay suficiente espacio en disco disponible, realice estos cambios:

• Establezca EMSAllLogFileMax en 100 MB.

  Nota: Primero asegúrese de que tiene suficiente espacio en disco en la unidad donde está instalado Cisco ICM.

• Establezca EMSLogFileMax en 10 MB.

• Establezca EMSDisplayToScreen en 0.

• Se deben realizar los cambios en el registro para cada proceso del que planee recopilar registros.

  Nota: Recuerde que EMSAllLogfilesMTax es acumulativo. Si establece EMSAllLogfilesMax en 100 MB para OPC, PIM1, PIM2 y CTISVR, utilizará 400 MB del espacio de unidad disponible.

• Los tamaños de archivo sugeridos son simplemente un punto de referencia. Es posible que los centros de contacto grandes y ocupados necesiten aumentar EMSAllLogfilesMax para asegurarse de que no se sobrescriban los registros.

Mostrar seguimientos de mensajes

Una vez capturados los mensajes, muéstrelos con la utilidad dumplog EMS. Dumplog lee un archivo de registro de EMS, da formato a los datos de eventos y escribe los datos con formato en un archivo de salida. Si el archivo de registro incluye eventos de seguimiento de mensajes, cada mensaje de seguimiento aparece en formato decodificado en la salida dumplog.

Cuando se capturan los datos, restablezca los valores que ha cambiado.

Utilidad regacc

La utilidad regacc es controlada por comandos y se puede utilizar en una sesión Telnet. Escriba regacc en el símbolo del sistema. Esta tabla enumera los comandos regacc más comunes:

Comando	Qué hace
regcd	Cambia el directorio del Registro actual.
regdir	Muestra el directorio del Registro actual.
regpwd	Imprime el directorio de trabajo actual.
regset	Establece un nuevo valor del Registro en el directorio de trabajo actual del Registro.
q	Sale de la utilidad regacc.
?	Muestra la Ayuda de regacc.
command /?	Muestra la sintaxis de un comando individual.

En este ejemplo se muestra cómo tener acceso al directorio que contiene los procesos para activar el seguimiento. Ejecute el comando regcd para cambiar el directorio y luego el comando regdir para mostrar el contenido del directorio de trabajo actual.

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

Nota: Este valor se muestra en varias líneas debido a limitaciones de espacio.

En este caso, el proceso PIM necesita seguimiento. El comando regcd se utiliza para moverse al directorio pim1, y el comando regdir para ver el contenido de ese directorio.

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

El comando regset se utiliza para cambiar el valor. En este ejemplo, el tamaño de EMSLogFileMax cambia de 5 MB a 1 MB.

Nota: Debe utilizar formatos hexadecimales al cambiar los valores.

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

OPCTest, Rttest y Procmon

A continuación se explican los procesos utilizados en el seguimiento.

OPCtest

Puede utilizar OPCTest para activar el seguimiento sólo para el proceso OPC. Active los medidores de seguimiento individuales con el comando debug. En OPCTest, escriba debug /? para obtener más información acerca del comando.

Si el proceso se confirma o si se detienen los servicios, las opciones especificadas se desactivan. Todavía es necesario utilizar el comando regacc o regedt32 para aumentar EMSAllLogFilesMax y EMSLogFilesMax para que los datos no se ajusten en la salida.

Para desactivar el seguimiento desde OPCTest, ejecute el comando debug /noall. No olvide minimizar todas las ventanas de proceso cuando termine la prueba.

Consulte Uso de la Utilidad de Línea de Comandos de Prueba OPC para obtener más información sobre OPCTest.

Rttest

Puede ejecutar el comando rttest para activar el seguimiento sólo para el proceso RTR. Utilice el comando debug para activar los medidores de seguimiento individuales. En rttest, escriba debug /? para obtener más información acerca del comando.

Si el proceso se confirma o si se detienen los servicios, las opciones especificadas se desactivan. Todavía es necesario utilizar el comando regacc o regedt32 para aumentar EMSAllLogFilesMax y EMSLogFilesMax para que los datos no se ajusten en la salida.

Consulte Utilidad rttest de Cisco ICM para obtener más información sobre rttest.

Procmon

Puede utilizar procmon para activar el seguimiento en los procesos pims, mis y ctiserver. Desafortunadamente, no existe una opción estándar para activar el seguimiento de estos procesos. Por ejemplo, la opción para el switch Definity es debug, mientras que para iniciar un seguimiento PIM VRU, debe establecer el medidor de seguimiento y utilizar el comando ltrace para ver los medidores de seguimiento. Para ver más información sobre el uso de procmon, escriba esto en una indicación de DOS:

procmon custname device process

Ejecute el comando mhelp para enumerar las opciones para el proceso individual.

A continuación se muestra un ejemplo de las opciones para el modificador 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] [/?]

La utilidad regacc está integrada en procmon. Dentro de procmon, puede ejecutar el comando mhelp para ver los comandos regacc.

Si el proceso se confirma o si se detienen los servicios, las opciones especificadas se desactivan. Todavía es necesario utilizar los comandos regacc o regedt32 para aumentar EMSAllLogFilesMax y EMSLogFilesMax de modo que los datos no se ajusten en la salida.

Para desactivar el seguimiento desde procmon, ingrese debug /noall. No olvide minimizar todas las ventanas de proceso cuando termine la prueba.

Refiérase a Uso de la Consola de Monitor de Proceso Remoto (Procmon) para obtener más información sobre procmon.

Información Relacionada

• Uso de la utilidad de línea de comandos del test OPC (Controlador periférico abierto)
• La utilidad rttest ICM de Cisco
• Uso de consola de monitor de proceso remoto (Procmon)
• Cómo usar la utilidad Dumplog
• Soporte Técnico - Cisco Systems