In questo documento viene descritto come impostare la traccia in Cisco Unified Contact Center Enterprise (UCCE) per client, servizi GRE (Peripheral Gateway), Cisco Customer Voice Portal (CVP), Cisco UCCE Outbound Dialer, Cisco Unified Communications Manager (CallManager) (CUCM) e gateway Cisco.
Cisco raccomanda la conoscenza dei seguenti argomenti:
Accedere al server Finesse con Secure Shell (SSH) e immettere questi comandi per raccogliere i log necessari. Viene chiesto di identificare un server FTP SSH (SFTP) in cui caricare i log.
Log | Comando |
---|---|
Installa registri | file get install desktop-install.log |
Registri desktop | file get activelog desktop recurs compress |
Log servm | file get activelog platform/log/servm*.\* comprimi |
Log Tomcat della piattaforma | file get activelog tomcat/logs recurs compress |
Registri di installazione VOS (Voice Operating System) | file get install.log |
In questa procedura viene descritto come creare e raccogliere i file di debug:
[Debug Log]
Path=..\log\agent.dbg
Size=3000000
Threshold=DEBUG
In questa procedura viene descritto come creare e raccogliere i file di debug:
[Debug Log]
Path=..\log\supervisor.dbg
Size=3000000
THRESHOLD=DEBUG
Sul PC client in cui è installato il client CTIOS, utilizzare Regedt32 per attivare la funzionalità di traccia. Cambia le impostazioni:
Release | Percorso Registro di sistema | Valore predefinito | Cambia |
---|---|---|---|
Release precedenti alla 7.x | HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging\TraceMask | 0x07 | Aumentare il valore a 0xfff. |
Release 7.x e successive | HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\CTIOS Tracing | 0x40000307 | Impostare il valore su 0xfff per la risoluzione dei problemi. |
L'output predefinito viene creato e inserito in un file di testo denominato CtiosClientLog nella directory di installazione c:\Programmi\Cisco Systems\CTIOS Client\CTIOS Desktop Phones\.
Di seguito sono riportate le impostazioni per eseguire il debug del servizio di sincronizzazione CAD.
Impostazione | Valore |
---|---|
File di configurazione Percorso predefinito |
DirAccessSynSvr.cfg C:\Program Files\Cisco\Desktop\config |
Problemi generali | Soglia=DEBUG |
File di output | DirAccessSynSvr.log |
Di seguito sono riportate le impostazioni per eseguire il debug del server CAD 6.0(X) RASCAL:
Impostazione | Valore |
---|---|
File di configurazione Percorso predefinito |
FCRasSvr.cfg C:\Program Files\Cisco\Desktop\config |
Problemi generali | Intervallo = 1-4, 50, 3000-8000 |
Problemi relativi a LDAP: | Intervallo = 4000-4999 |
Problemi relativi a LRM: | Intervallo = 1999-2000 |
Problemi relativi al database | Intervallo = 50-59 |
File di output Percorso predefinito |
FCRasSvr.log, FCRasSvr.dbg C:\Program Files\Cisco\Desktop\log |
Di seguito sono riportate le impostazioni per eseguire il debug del server di chat:
Impostazione | Valore |
---|---|
File di configurazione Percorso predefinito |
ServerFCS.cfg C:\Program Files\Cisco\Desktop\config |
Problemi generali | Soglia=DEBUG |
File di output Percorso predefinito |
FCCServer.log, FCCServer.dbg C:\Program Files\Cisco\Desktop\log |
Vedere Utilizzare l'utilità Dumplog per eseguire il pull dei log per la raccolta dei log.
Usare l'utilità di monitoraggio del processo (procmon) per attivare e disattivare i livelli di traccia. Questi comandi attivano la traccia di CallManager Peripheral Interface Manager (PIM):
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
Questo comando procmon disattiva la traccia PIM di CallManager:
>>>trace * /off
In questa procedura viene descritto come attivare la traccia CUCM:
I seguenti comandi procmon attivano il trace 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 di esempio è procmon ipcc pg1a jgw1.
Questa procedura descrive come abilitare il trace del CTISVR sul lato attivo:
Questi comandi procmon attivano il trace per 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
Questo comando procmon disattiva la traccia PIM della VRU:
>>>trace * /off
In questa procedura viene descritto come abilitare la traccia in entrambi i server CTIOS:
La maschera di traccia predefinita è 0x3 in tutte le versioni ad eccezione della versione 7.0(0), dove è 0x2003.
Se il valore della maschera di traccia è elevato (0xf o superiore), le prestazioni del server CTIOS e la percentuale di completamento delle chiamate saranno notevolmente compromesse. Impostare la maschera di traccia su un valore alto solo quando si esegue il debug di un problema; dopo aver raccolto i registri necessari, è necessario impostare nuovamente la maschera di traccia sul valore predefinito.
Per la risoluzione dei problemi, impostare la maschera di traccia del server CTIOS su:
I seguenti comandi ottici attivano il trace OPC su un PG attivo:
opctest /cust <cust_inst> /node <node>
opctest:debug /agent /routing /cstacer /tpmsg /closedcalls
Questo è un esempio da un ambiente lab:
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
Altri esempi sono:
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
Questi comandi procmon attivano il tracciamento eagtpim su un PG attivo:
C:\>procmon <cust_inst> <node> pim<pim instance
>>>>trace tp* /on
>>>trace precall /on
>>>trace *event /on
>>>trace csta* /on
Questo è un esempio da un ambiente lab:
C:\Documents and Settings\ICMAdministrator>procmon cc1 pg1a pim1
>>>>trace tp* /on
>>>>trace precall /on
>>>>trace *event /on
>>>>trace csta* /on
>>>>quit
Per ulteriori informazioni, consultare Uso dell'utilità Dumplog. Utilizzare il comando cdlog per accedere alla directory logfiles, come mostrato nell'esempio:
c:\cdlog <customer_name> pg1a !-- Or, pgXa to depending on the PG number (X)
c:\icm\<customer_name>\<<PG#>>\logfiles\
In questi esempi viene illustrato come inserire l'output nel file predefinito; in tutti i casi, è possibile utilizzare /of per definire un nome specifico per il file di output:
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
In questa procedura viene descritto come abilitare la traccia sui server CVP con il software Cisco SIP IP Phone:
In questa procedura viene descritto come abilitare la traccia sui server CVP con un gateway H323:
setcalltrace on
setinterfacetrace on
Raccogliere il file CVP *.log e i file Error.log per l'ora del periodo di prova. Questi file si trovano nella directory C:\Cisco\CVP\logs su entrambi i server CVP.
Queste sono le posizioni dei file di log per Unified CVP, dove CVP_HOME è la directory in cui è installato il software Unified CVP.
Tipo di log | Posizione |
---|---|
Registri server di chiamata e/o server di report |
CVP_HOME\logs\ |
Registri console operazioni | CVP_HOME\logs\OAMP\ |
Registri server Voice XML (VXML) | CVP_HOME\logs\VXML\ |
Registri agente SNMP (Simple Network Management Protocol) | CVP_HOME\logs\SNMP\ |
Registri di Unified CVP Resource Manager | CVP_HOME\logs\ORM\ |
Un esempio di percorso è C:\Cisco\CVP.
Per applicazioni Voice XML personalizzate, ad esempio un'applicazione Audium distribuita, è possibile attivare un registratore di debug.
Aggiungere questa riga alla sezione <loggers> (l'ultima sezione) del file di configurazione settings.xml nella directory C:\Cisco\CVP\VXMLServer\applications\APP_NAME\data\application\:
<logger_instance name="MyDebugLogger"
class="com.audium.logger.application.debug.ApplicationDebugLogger"/>
In fase di esecuzione, questo logger invia un log VoiceXML dettagliato alla directory \Cisco\CVP\VXMLServer\applications\APP_NAME\MyDebuggerLogger.
In questa procedura viene descritto come aumentare i registri di processo di conversione in uscita (generalmente disponibili in PG).
Eseguire l'utilità dumplog dalla directory /icm/<istanza>/dialer/logfiles:
dumplog badialer /bt hh:mm:ss /et hh:mm:ss /o
In questa procedura viene descritto come aumentare il log del processo baimport.
dumplog baimport /bt hh:mm:ss /et hh:mm:ss /o
In questa procedura viene descritto come aumentare il registro del processo di Gestione campagne.
dumplog campaignmanager /bt hh:mm:ss /et hh:mm:ss /o
In Avaya Communications Manager (ACD) PG, utilizzare l'utilità opctest per aumentare i valori seguenti per CallManager e Avaya.
C:\opctest /cust <instance> /node <pgname>
opctest: type debug /agent /closedcalls /cstacer /routing
opctest: q !-- Quits
In questa procedura viene descritto come aumentare il valore di trace per il processo ctisvr.
In questa procedura viene descritto come abilitare i log del router:
Per la versione Optical 8.5, utilizzare il Portico Diagnostic Framework.
debug level 3 component "icm:Router A" subcomponent icm:rtr
Usare la utility dumplog per estrarre i log del router da entrambi i router per il periodo di tempo specificato per i test. Per ulteriori informazioni, consultare Uso della utility dumplog.
Questo è un esempio di una richiesta di log in data 21/10/2011 tra le 09:00:00 e le 09:30:00 (nel formato 24 ore). Questo output viene inserito nel file 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
Inviare il file di output (C:/router_output.txt) a Cisco per la risoluzione dei problemi, se necessario.
Questi comandi attivano la traccia sui server 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
Si tratta di una piattaforma molto solida in grado di gestire i debug consigliati sul volume di chiamata fornito senza problemi. Tuttavia, Cisco consiglia di:
logging <syslog server ip>
logging trap debugs
show proc cpu hist
Abilita questi debug:
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
Dopo aver effettuato la chiamata e aver simulato il problema, interrompere il debug:
#undebug all
Raccogli questo output:
term len 0
show ver
show run
show log
Questi comandi attivano la traccia SIP su Cisco Unified SIP Proxy (CUSP):
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
Ricordarsi di disattivare la registrazione al termine dell'operazione.
In questa procedura viene descritto come raccogliere i log:
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
In UCCE release 8 e successive, è possibile utilizzare l'interfaccia della riga di comando (CLI) del sistema unificato per raccogliere le tracce. Rispetto alle utility dumplog, la CLI è un metodo molto veloce ed efficiente per ottenere un intero set di log da un server come PG o Rogger.
In questa procedura viene descritto come avviare l'analisi dei problemi e come determinare quale analisi abilitare. Nell'esempio vengono raccolti i registri dai seguenti server:
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect
dir c:\temp
Sostituire la prima stringa mm-gg-aaaa:hh:mm con una data e un'ora che precedono di circa 15 minuti l'evento.
Sostituire la seconda stringa mm-gg-aaaa:hh:mm con una data e un'ora che corrispondono a circa 15 minuti dopo la risoluzione dell'evento. Se l'evento si verifica ancora, raccoglierne almeno 15 minuti.
Raccogliere queste informazioni aggiuntive, se possibile:
Sono disponibili due strumenti: uno strumento di Diagnostic Framework e uno strumento CLI di sistema. Entrambe sono icone sul desktop o nella directory Programmi di ciascun server.
In questa procedura viene descritto come utilizzare la CLI di Unified System per il trace.
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect dir c:\temp