本文档介绍如何在思科统一联系中心企业版(UCCE)中为客户端、外围网关(PG)服务、思科客户语音门户(CVP)、思科UCCE呼出拨号器、思科统一通信管理器(CallManager)(CUCM)和思科网关设置跟踪。
Cisco 建议您了解以下主题:
使用安全外壳(SSH)登录Finesse服务器并输入这些命令以收集所需日志。系统将提示您标识要上传日志的SSH FTP(SFTP)服务器。
日志 | 命令 |
---|---|
安装日志 | file get install desktop-install.log |
桌面日志 | 文件获取activelog desktop recurs compress |
服务日志 | 文件get activelogplatform/log/servm*.\* compress |
平台Tomcat日志 | 文件获取activelog tomcat/logs recurs compress |
语音操作系统(VOS)安装日志 | file get install 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\ install directory目录中名为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 |
请参阅使用Dumplog实用程序提取日志以收集日志。
使用进程监控(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)(其中为0x20003)外的所有版本中,默认跟踪掩码为0x3。
如果跟踪掩码的值(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
有关其他详细信息,请参阅如何使用Dumplog实用程序。使用cdlog命令可到达日志文件目录,如下例所示:
c:\cdlog <customer_name> pg1a !-- Or, pgXa to depending on the PG number (X)
c:\icm\<customer_name>\<<PG#>>\logfiles\
以下示例展示如何将输出放在默认文件中;在所有情况下,都可以使用/of来定义输出文件的特定名称:
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电话软件在CVP服务器上启用跟踪:
此过程介绍如何在具有H323网关的CVP服务器上启用跟踪:
setcalltrace on
setinterfacetrace on
收集测试期间的CVP *.log文件和Error.log文件。这些文件位于C:\Cisco\CVP\logs directory on both CVP servers目录中。
这些是统一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。
对于已部署的Audium应用等自定义语音XML应用,可以打开调试记录器。
将此行添加到C:\Cisco\CVP\VXMLServer\applications\APP_NAME\data\application\ directory目录中settings.xml配置文件的<loggers>部分(最后一部分):
<logger_instance name="MyDebugLogger"
class="com.audium.logger.application.debug.ApplicationDebugLogger"/>
在运行时,此记录器将详细的VoiceXML日志输出到\Cisco\CVP\VXMLServer\applications\APP_NAME\MyDebuggerLogger directory。
此过程介绍如何增加出站拨号器(通常在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,请改用诊断框架门户。
debug level 3 component "icm:Router A" subcomponent icm:rtr
使用dumplog实用程序可从任一路由器获取测试时间段的路由器日志。有关其他详细信息,请参阅如何使用Dumplog实用程序。
这是10/21/2011 09:00:00到09:30:00之间(以24小时时间格式)的日志请求示例。 此输出将转到文件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
以下命令在思科统一SIP代理(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)来收集跟踪。与转储实用程序相比,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