本文檔介紹如何在Cisco Unified Contact Center Enterprise(UCCE)中為客戶端、外圍裝置網關(PG)服務、思科客戶語音門戶(CVP)、Cisco UCCE Outbound Dialer、思科統一通訊管理器(CallManager)(CUCM)和思科網關設定跟蹤。
思科建議您瞭解以下主題:
使用安全殼層(SSH)登入到Finesse伺服器,然後輸入這些命令以收集所需的日誌。系統會提示您識別將上傳日誌的SSH FTP(SFTP)伺服器。
記錄檔 | 指令 |
---|---|
安裝日誌 | 檔案get install desktop-install.log |
案頭日誌 | 檔案get activelog案頭重複壓縮 |
伺服器日誌 | 檔案get activelog platform/log/servm*.\* compress |
Platform Tomcat日誌 | 檔案get activelog tomcat/logs recurs compress |
語音作業系統(VOS)安裝日誌 | 檔案get install install.log |
以下過程介紹如何建立和收集調試檔案:
[Debug Log]
Path=..\log\agent.dbg
Size=3000000
Threshold=DEBUG
以下過程介紹如何建立和收集調試檔案:
[Debug Log]
Path=..\log\supervisor.dbg
Size=3000000
THRESHOLD=DEBUG
在安裝了CTIOS客戶端的客戶端PC上,使用Regedt32來啟動跟蹤。更改以下設定:
版本 | 登錄檔位置 | 預設值 | 變更 |
---|---|---|---|
低於7.x的版本 | HKEY_LOCAL_MACHINE\Software\Cisco Systems\Ctios\Logging\TraceMask | 0x07 | 將值增加到0xfff。 |
7.x及更新版本 | HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\CTIOS跟蹤 | 0x40000307 | 將值設定為0xfff進行故障排除。 |
預設輸出將建立並放置在c:\Program Files\Cisco Systems\CTIOS Client\CTIOS Desktop Phones\安裝目錄中名為CtiosClientLog的文本檔案中。
以下是調試CAD同步服務的設定:
設定 | 價值 |
---|---|
配置檔案 預設位置 |
DirAccessSynSvr.cfg C:\Program Files\Cisco\Desktop\config |
一般問題 | 閾值=調試 |
輸出檔案 | DirAccessSynSvr.log |
以下是調試CAD 6.0(X)RASCAL伺服器的設定:
設定 | 價值 |
---|---|
配置檔案 預設位置 |
FCRasSvr.cfg C:\Program Files\Cisco\Desktop\config |
一般問題 | 範圍= 1-4, 50, 3000-8000 |
LDAP相關問題: | 範圍= 4000-4999 |
與LRM相關的問題: | 範圍= 1999-2000 |
與資料庫相關的問題 | 範圍= 50-59 |
輸出檔案 預設位置 |
FCRasSvr.log、FCRasSvr.dbg C:\Program Files\Cisco\Desktop\log |
以下是調試聊天伺服器的設定:
設定 | 價值 |
---|---|
配置檔案 預設位置 |
FCCServer.cfg C:\Program Files\Cisco\Desktop\config |
一般問題 | 閾值=調試 |
輸出檔案 預設位置 |
FCCServer.log、FCCServer.dbg C:\Program Files\Cisco\Desktop\log |
使用進程監控(procmon)實用程式來開啟和關閉跟蹤級別。以下命令開啟CallManager外圍裝置介面管理器(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
此procmon命令關閉CallManager PIM跟蹤:
>>>trace * /off
以下過程介紹了如何開啟CUCM跟蹤:
以下procmon命令開啟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
例如,命令是procmon ipcc pg1a jgw1。
以下過程介紹了如何在活動端啟用CTISVR跟蹤:
以下procmon命令為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
此procmon命令關閉VRU PIM跟蹤:
>>>trace * /off
以下過程介紹了如何在兩個CTIOS伺服器上啟用跟蹤:
除7.0(0)版本外,所有版本的預設跟蹤掩碼都是0x3,其中0x20003。
如果跟蹤掩碼的值很高(0xf或更高),則會對CTIOS伺服器效能和呼叫完成率產生很大影響。只有在調試問題時,才將跟蹤掩碼設定為高值;收集所需的日誌後,必須將跟蹤掩碼重新設定為預設值。
出於故障排除目的,請將CTIOS伺服器跟蹤掩碼設定為:
以下opctest命令可開啟活動PG上的OPC跟蹤:
opctest /cust <cust_inst> /node <node>
opctest:debug /agent /routing /cstacer /tpmsg /closedcalls
以下是一個來自實驗室環境的示例:
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
其他示例包括:
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
以下procmon命令在活動PG上啟用eagtpim跟蹤:
C:\>procmon <cust_inst> <node> pim<pim instance
>>>>trace tp* /on
>>>trace precall /on
>>>trace *event /on
>>>trace csta* /on
以下是一個來自實驗室環境的示例:
C:\Documents and Settings\ICMAdministrator>procmon cc1 pg1a pim1
>>>>trace tp* /on
>>>>trace precall /on
>>>>trace *event /on
>>>>trace csta* /on
>>>>quit
請參閱如何使用轉儲實用程式以瞭解其他詳細資訊。使用cdlog命令可進入logfiles目錄,如以下示例所示:
c:\cdlog <customer_name> pg1a !-- Or, pgXa to depending on the PG number (X)
c:\icm\<customer_name>\<<PG#>>\logfiles\
以下範例顯示如何在預設檔案中放置輸出;在所有情況下,可以使用/為輸出檔案定義特定名稱:
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
以下過程介紹如何使用Cisco SIP IP Phone軟體在CVP伺服器上啟用跟蹤:
以下過程介紹了如何在H323網關的CVP伺服器上啟用跟蹤:
setcalltrace on
setinterfacetrace on
收集測試期間的CVP *.log檔案和Error.log檔案。這些檔案位於兩個CVP伺服器的C:\Cisco\CVP\logs目錄中。
這些是統一CVP日誌檔案的位置,其中CVP_HOME是安裝統一CVP軟體的目錄。
日誌型別 | 位置 |
---|---|
呼叫伺服器和/或報告伺服器日誌 |
CVP_HOME\logs\ |
操作控制檯日誌 | CVP_HOME\logs\OAMP\ |
語音XML(VXML)伺服器日誌 | CVP_HOME\logs\VXML\ |
簡單網路管理協定(SNMP)代理日誌 | CVP_HOME\logs\SNMP\ |
統一CVP資源管理器日誌 | CVP_HOME\logs\ORM\ |
示例位置為C:\Cisco\CVP。
對於自定義語音XML應用程式(例如已部署的Audium應用程式),您可以開啟調試記錄器。
將此行新增到C:\Cisco\CVP\VXMLServer\applications\APP_NAME\data\application\目錄下settings.xml配置檔案的<loggers>部分(最後一部分):
<logger_instance name="MyDebugLogger"
class="com.audium.logger.application.debug.ApplicationDebugLogger"/>
在運行時,此記錄器將詳細的VoiceXML日誌輸出到\Cisco\CVP\VXMLServer\applications\APP_NAME\MyDebuggerLogger目錄。
此過程描述如何增加出站撥號程式(通常在PG上找到)上的撥號程式進程日誌。
從/icm/<instance>/dialer/logfiles目錄運行dumplog實用程式:
dumplog badialer /bt hh:mm:ss /et hh:mm:ss /o
以下過程介紹了如何增加基本進程日誌。
dumplog baimport /bt hh:mm:ss /et hh:mm:ss /o
此過程描述如何增加Campaignmanager進程日誌。
dumplog campaignmanager /bt hh:mm:ss /et hh:mm:ss /o
在Avaya Communications Manager(ACD)PG上,使用opctest實用程式來增加CallManager和Avaya的以下內容。
C:\opctest /cust <instance> /node <pgname>
opctest: type debug /agent /closedcalls /cstacer /routing
opctest: q !-- Quits
此過程描述如何增加ctisvr進程的跟蹤。
以下過程介紹了如何啟用路由器日誌:
對於opctest版本8.5,請改用Diagnostic Framework Portico。
debug level 3 component "icm:Router A" subcomponent icm:rtr
使用dumplog實用程式可以從任一路由器提取測試時段的路由器日誌。有關其他詳細資訊,請參閱如何使用Dumplog實用程式。
以下是09:00:00和09:30:00(24小時時間格式)之間2011年10月21日日誌的日誌請求示例。 此輸出轉至檔案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
如果需要,將輸出檔案(C:/router_output.txt)提交給思科進行故障排除。
以下命令可開啟使用SIP的CVP伺服器的跟蹤:
#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
這是一個非常強大的平台,可以在所提供的呼叫量處理建議的調試,而不會出現問題。但是,思科建議您:
logging <syslog server ip>
logging trap debugs
show proc cpu hist
啟用以下調試:
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
進行呼叫並模擬問題後,停止調試:
#undebug all
收集以下輸出:
term len 0
show ver
show run
show log
以下命令可在Cisco Unified SIP Proxy(CUSP)上啟用SIP跟蹤:
(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire
請記得在完成後關閉登入。
以下過程介紹了如何收集日誌:
username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers
在UCCE版本8和更新版本中,您可以使用統一系統命令列介面(CLI)來收集跟蹤。與dumplog實用程式相比,CLI是一種從一台伺服器(如PG或Rogger)獲取整個日誌集非常快速有效的方法。
以下過程介紹了如何啟動問題分析以及如何確定要啟用哪些跟蹤。示例從以下伺服器收集日誌:
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect
dir c:\temp
將第一個mm-dd-yyyy:hh:mm字元串替換為事件前約15分鐘的日期和時間。
將第二個mm-dd-yyyy:hh:mm字串替換為在事件解決後約15分鐘的日期和時間。如果此事件仍在發生,請至少收集15分鐘。
如有可能,請收集以下附加資訊:
有兩種工具:診斷框架工具和系統CLI工具。兩者都是案頭上或每台伺服器上「程式」目錄下的圖示。
本過程介紹如何使用Unified System CLI進行跟蹤。
show tech-support absdatetime mm-dd-yyyy:hh:mm mm-dd-yyyy:hh:mm redirect dir c:\temp