In diesem Dokument wird beschrieben, wie die Ablaufverfolgung in Cisco Unified Contact Center Enterprise (UCCE) für Clients, Peripheriegerät-Services (PG), das Cisco Customer Voice Portal (CVP), der Cisco UCCE Outbound Dialer, Cisco Unified Communications Manager (CallManager) (CUCM) und Cisco Gateways eingerichtet werden.
Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:
Melden Sie sich mit der Secure Shell (SSH) beim Finesse-Server an, und geben Sie diese Befehle ein, um die erforderlichen Protokolle zu sammeln. Sie werden aufgefordert, einen SSH-FTP-Server (SFTP) zu identifizieren, auf den die Protokolle hochgeladen werden.
Protokolle | Command |
---|---|
Installationsprotokolle | Datei get install desktop-install.log |
Desktop-Protokolle | Datei erhalten activelog Desktop wird komprimiert |
Serverprotokolle | file get activelog platform/log/servm*.\* komprimieren |
Plattform-Tomcat-Protokolle | file get activelog tomcat/logs recurs komprimieren |
VOS-Installationsprotokolle (Voice Operating System) | file get install install install.log |
In dieser Prozedur wird beschrieben, wie Sie Debugdateien erstellen und sammeln:
[Debug Log]
Path=..\log\agent.dbg
Size=3000000
Threshold=DEBUG
In dieser Prozedur wird beschrieben, wie Sie Debugdateien erstellen und sammeln:
[Debug Log]
Path=..\log\supervisor.dbg
Size=3000000
THRESHOLD=DEBUG
Verwenden Sie auf dem Client-PC, auf dem der CTIOS-Client installiert ist, Regedt32, um die Ablaufverfolgung zu aktivieren. Ändern Sie diese Einstellungen:
Version | Registrierungsort | Standardwert | Ändern |
---|---|---|---|
Versionen vor 7.x | HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging\TraceMask | 0 x 07 | Erhöhen Sie den Wert auf 0xfff. |
Version 7.x und höher | HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\CTIOS Tracing | 0x40000307 | Legen Sie für die Fehlerbehebung den Wert 0xfff fest. |
Die Standardausgabe wird erstellt und in einer Textdatei mit dem Namen CtiosClientLog im Ordner c:\Program Files\Cisco Systems\CTIOS Client\CTIOS Desktop Phones\ install directory.
Dies sind die Einstellungen zum Debuggen des CAD Sync Service:
Einstellung | Wert |
---|---|
Konfigurationsdatei Standard-Speicherort |
DirAccessSynSvr.cfg C:\Program Files\Cisco\Desktop\config |
Allgemeine Fragen | Grenzwert=DEBUG |
Ausgabedateien | DirAccessSynSvr.log |
Dies sind die Einstellungen zum Debuggen des CAD 6.0(X) RASCAL-Servers:
Einstellung | Wert |
---|---|
Konfigurationsdatei Standard-Speicherort |
FCRasSvr.cfg C:\Program Files\Cisco\Desktop\config |
Allgemeine Fragen | Bereich = 1-4, 50, 3000-8000 |
LDAP-bezogene Probleme: | Bereich = 4000-4999 |
LRM-bezogene Probleme: | Bereich = 1999-2000 |
Datenbankbezogene Probleme | Bereich = 50-59 |
Ausgabedateien Standard-Speicherort |
FCRasSvr.log, FCRasSvr.dbg C:\Program Files\Cisco\Desktop\log |
Dies sind die Einstellungen zum Debuggen des Chat-Servers:
Einstellung | Wert |
---|---|
Konfigurationsdatei Standard-Speicherort |
FCCServer.cfg C:\Program Files\Cisco\Desktop\config |
Allgemeine Fragen | Grenzwert=DEBUG |
Ausgabedateien Standard-Speicherort |
FCCServer.log, FCCServer.dbg C:\Program Files\Cisco\Desktop\log |
Siehe Verwenden des Dumping-Dienstprogramms zum Abrufen von Protokollen für die Protokollsammlung.
Verwenden Sie das Dienstprogramm für die Prozessüberwachung (procmon), um die Ablaufverfolgungsebenen ein- und auszuschalten. Diese Befehle aktivieren die CallManager-PIM-Ablaufverfolgung:
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
Mit diesem Befehl von procmon wird die CallManager-PIM-Ablaufverfolgung deaktiviert:
>>>trace * /off
In diesem Verfahren wird beschrieben, wie die CUCM-Ablaufverfolgung aktiviert wird:
Diese Befehle aktivieren die JGW-Ablaufverfolgung:
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
Ein Beispielbefehl ist procmon ipcc pg1a jgw1.
In diesem Verfahren wird beschrieben, wie Sie die CTISVR-Ablaufverfolgung auf der aktiven Seite aktivieren:
Diese Befehle aktivieren die Ablaufverfolgung für 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
Mit diesem Promon-Befehl wird die VRU-PIM-Ablaufverfolgung deaktiviert:
>>>trace * /off
In diesem Verfahren wird beschrieben, wie die Ablaufverfolgung auf beiden CTIOS-Servern aktiviert wird:
Die Standard-Trace-Maske ist 0x3 in allen Versionen außer Release 7.0(0), wobei sie 0x2003 ist.
Wenn die Ablaufverfolgungsmaske einen hohen Wert (0xf oder höher) hat, wirkt sich dies erheblich auf die Leistung des CTIOS-Servers und die Anrufvervollständigungsrate aus. Legen Sie die Ablaufverfolgungsmaske nur dann auf einen hohen Wert fest, wenn Sie ein Problem debuggen. Nachdem Sie die erforderlichen Protokolle gesammelt haben, müssen Sie die Ablaufverfolgungsmaske auf den Standardwert zurücksetzen.
Legen Sie für die Fehlerbehebung für die CTIOS-Server-Ablaufverfolgungsmaske Folgendes fest:
Diese opctest-Befehle aktivieren die OPC-Ablaufverfolgung auf einem aktiven PG:
opctest /cust <cust_inst> /node <node>
opctest:debug /agent /routing /cstacer /tpmsg /closedcalls
Dies ist ein Beispiel aus einer Laborumgebung:
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
Weitere Beispiele:
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
Diese Prokmon-Befehle aktivieren die eagtpim-Ablaufverfolgung auf einem aktiven PG:
C:\>procmon <cust_inst> <node> pim<pim instance
>>>>trace tp* /on
>>>trace precall /on
>>>trace *event /on
>>>trace csta* /on
Dies ist ein Beispiel aus einer Laborumgebung:
C:\Documents and Settings\ICMAdministrator>procmon cc1 pg1a pim1
>>>>trace tp* /on
>>>>trace precall /on
>>>>trace *event /on
>>>>trace csta* /on
>>>>quit
Weitere Informationen finden Sie unter Verwendung des Dumping-Dienstprogramms. Verwenden Sie den Befehl cdlog, um zum Verzeichnis der Protokolldateien zu gelangen, wie in diesem Beispiel gezeigt:
c:\cdlog <customer_name> pg1a !-- Or, pgXa to depending on the PG number (X)
c:\icm\<customer_name>\<<PG#>>\logfiles\
In diesen Beispielen wird veranschaulicht, wie die Ausgabe in der Standarddatei gespeichert wird. In allen Fällen können Sie /von verwenden, um einen bestimmten Namen für die Ausgabedatei zu definieren:
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
Dieses Verfahren beschreibt, wie die Ablaufverfolgung auf CVP-Servern mit der Cisco SIP IP-Telefon-Software aktiviert wird:
Dieses Verfahren beschreibt, wie die Ablaufverfolgung auf CVP-Servern mit einem H323-Gateway aktiviert wird:
setcalltrace on
setinterfacetrace on
Erfassen Sie die CVP *.log-Datei und die Error.log-Dateien für die Zeit des Testzeitraums. Diese Dateien befinden sich im Ordner C:\Cisco\CVP\logs directory on both CVP servers.
Dies sind die Speicherorte der Protokolldateien für Unified CVP, wobei CVP_HOME das Verzeichnis ist, in dem die Unified CVP-Software installiert wird.
Protokolltyp | Standort |
---|---|
Anrufserver- und/oder Reporting-Serverprotokolle |
CVP_HOME\logs\ |
Operations Console-Protokolle | CVP_HOME\logs\OAMP\ |
Voice XML (VXML)-Serverprotokolle | CVP_HOME\logs\VXML\ |
SNMP-Agentenprotokolle (Simple Network Management Protocol) | CVP_HOME\logs\SNMP\ |
Unified CVP-Ressourcen-Manager-Protokolle | CVP_HOME\logs\ORM\ |
Ein Beispielspeicherort ist C:\Cisco\CVP.
Bei benutzerdefinierten Sprach-XML-Anwendungen, z. B. einer bereitgestellten Audium-Anwendung, können Sie einen Debugprotokollierer aktivieren.
Fügen Sie diese Zeile dem Abschnitt <Loggers> (dem letzten Abschnitt) der Konfigurationsdatei settings.xml im Ordner C:\Cisco\CVP\VXMLServer\applications\APP_NAME\data\application\ directory:
<logger_instance name="MyDebugLogger"
class="com.audium.logger.application.debug.ApplicationDebugLogger"/>
Zur Laufzeit gibt diese Protokollierung ein detailliertes VoiceXML-Protokoll an \Cisco\CVP\VXMLServer\applications\APP_NAME\MyDebuggerLogger directory aus.
Dieses Verfahren beschreibt, wie Sie die Badialprozess-Protokolle auf dem Outbound Dialer (der normalerweise auf einem PG zu finden ist) erhöhen.
Führen Sie das Dumlog-Dienstprogramm im Verzeichnis /icm/<instance>/dialer/logfiles aus:
dumplog badialer /bt hh:mm:ss /et hh:mm:ss /o
In dieser Prozedur wird beschrieben, wie das Protokoll des Importportprozesses erhöht wird.
dumplog baimport /bt hh:mm:ss /et hh:mm:ss /o
In diesem Verfahren wird beschrieben, wie das Ereignisprotokoll für den Aktivierungsmanager erweitert wird.
dumplog campaignmanager /bt hh:mm:ss /et hh:mm:ss /o
Verwenden Sie im Avaya Communications Manager (ACD) PG das opctest-Dienstprogramm, um die folgenden Werte für CallManager und Avaya zu erhöhen.
C:\opctest /cust <instance> /node <pgname>
opctest: type debug /agent /closedcalls /cstacer /routing
opctest: q !-- Quits
In diesem Verfahren wird beschrieben, wie die Ablaufverfolgung für den ctisvr-Prozess erhöht wird.
In diesem Verfahren wird beschrieben, wie Router-Protokolle aktiviert werden:
Verwenden Sie stattdessen das Diagnostic Framework-Portal für opctest Version 8.5.
debug level 3 component "icm:Router A" subcomponent icm:rtr
Verwenden Sie das Dumlog-Dienstprogramm, um Router-Protokolle für den Testzeitraum von einem der Router abzurufen. Weitere Informationen finden Sie unter Verwendung des Dumping-Dienstprogramms.
Dies ist ein Beispiel für eine Protokollanforderung für Protokolle am 21.10.2011 zwischen 09:00:00 und 09:30:00 Uhr (im 24-Stunden-Format). Diese Ausgabe geht an die Datei 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
Senden Sie die Ausgabedatei (C:/router_output.txt) zur Fehlerbehebung an Cisco (falls erforderlich).
Diese Befehle aktivieren die Ablaufverfolgung auf CVP-Servern mit 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
Dies ist eine sehr robuste Plattform, die die vorgeschlagenen DebuggingInnen beim bereitgestellten Anrufvolumen problemlos verarbeiten kann. Cisco empfiehlt jedoch Folgendes:
logging <syslog server ip>
logging trap debugs
show proc cpu hist
Aktivieren Sie diese Debugger:
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
Nachdem Sie den Anruf getätigt und das Problem simuliert haben, beenden Sie das Debuggen:
#undebug all
Erfassen Sie diese Ausgabe:
term len 0
show ver
show run
show log
Diese Befehle aktivieren die SIP-Ablaufverfolgung auf dem Cisco Unified SIP Proxy (CUSP):
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
Vergessen Sie nicht, sich abzumelden, sobald Sie fertig sind.
In diesem Verfahren wird beschrieben, wie die Protokolle erfasst werden:
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
In UCCE Release 8 und höher können Sie die Unified System Command-Line Interface (CLI) verwenden, um Ablaufverfolgungen zu erfassen. Im Vergleich zu Dumlog-Dienstprogrammen ist die CLI eine sehr schnelle und effiziente Methode, um einen ganzen Satz von Protokollen von einem Server wie einem PG oder Rogger zu erhalten.
In diesem Verfahren wird beschrieben, wie Sie die Problemanalyse starten und festlegen, welche Ablaufverfolgung aktiviert werden soll. Im Beispiel werden Protokolle von folgenden Servern gesammelt:
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect
dir c:\temp
Ersetzen Sie die erste mm-tt-jjjj:hh:mm-Zeichenfolge durch ein Datum und eine Uhrzeit, die etwa 15 Minuten vor der Veranstaltung liegt.
Ersetzen Sie die zweite mm-tt-jjjj:hh:mm-Zeichenfolge durch ein Datum und eine Uhrzeit, die ungefähr 15 Minuten nach dem Auflösen des Ereignisses beträgt. Wenn das Ereignis noch eintritt, sammeln Sie mindestens 15 Minuten.
Sammeln Sie diese zusätzlichen Informationen, wenn möglich:
Es gibt zwei Tools: ein Diagnose-Framework-Tool und das System-CLI-Tool. Beide Symbole befinden sich entweder auf dem Desktop oder unter dem Verzeichnis Programme auf jedem Server.
In diesem Verfahren wird beschrieben, wie die Unified System-CLI für die Ablaufverfolgung verwendet wird.
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect dir c:\temp