在CCE中设置跟踪和收集日志

下载选项

PDF (3.8 MB)
在各种设备上使用 Adobe Reader 查看
ePub (3.6 MB)
在 iPhone、iPad、Android、Sony Reader 或 Windows Phone 上使用各种应用查看
Mobi (Kindle) (2.5 MB)
在 Kindle 设备上查看或在多个设备上使用 Kindle 应用查看

已更新: 2025 年 5 月 28 日

文档 ID:218125

非歧视性语言

此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。深入了解思科如何使用包容性语言。

关于此翻译

思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言，希望全球的用户都能通过各自的语言得到支持性的内容。请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任，并建议您总是参考英文原始文档（已提供链接）。

简介

本文档介绍如何在Cisco Unified Contact Center Enterprise(CCE)中设置和收集跟踪。

先决条件

要求

Cisco 建议您了解以下主题：

思科统一联系中心企业版(UCCE)
套装联络中心企业版(PCCE)
思科Finesse
思科客户语音门户(CVP)
思科虚拟化语音浏览器(VVB)
思科统一边界元素(CUBE)
思科统一情报中心(CUIC)
思科统一会话初始协议(SIP)代理(CUSP)

使用的组件

本文档中的信息基于以下软件版本：

思科Finesse版本12.5
CVP服务器版本12.5
UCCE/PCCE版本12.5
思科VVB版本12.5
CUIC版本12.5

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

设置跟踪和收集Finesse日志

Finesse客户端

有几种选项可用于收集Finesse客户端日志。

选项 1：通过发送错误报告收集客户端日志

登录代理。
如果座席在呼叫或媒体事件期间遇到任何问题，指示座席单击finesse桌面右上角的发送错误报告链接。
代理看到Logs Successful Sent!邮件.
客户端日志将发送到Finesse服务器。导航到Finesse Logs并使用管理帐户登录。
收集clientlogs/目录下的日志。

选项 2：设置持久日志记录

导航到桌面本地日志。
单击Sign In With Persistent Logging 。
系统将打开Cisco Finesse座席桌面登录页面。登录座席。
所有Agent Desktop交互都会被注册并发送到本地存储日志。要收集日志，请导航到Desktop Local Log并将内容复制到文本文件中。保存文件以供进一步分析。

选项 3：Web浏览器控制台

代理登录后，按F12打开浏览器控制台。
选择Console选项卡。
检查浏览器控制台中的错误。将内容复制到文本文件中并保存。
选择Network选项卡，并选中Preserve日志选项。
右键单击任何网络名称事件，然后选择Save为HAR并包含内容。

Finesse服务器

选项 1：通过用户界面(UI)- Web服务（必需）和其他日志

导航到Finesse Logs并使用管理帐户登录。
展开目录webservices/。
收集上一个Web服务日志。选择最后一个解压缩文件。例如Desktop-Webservices.201X-..log.zip。单击文件链接，您会看到Save文件的选项。
收集其他所需的日志（具体取决于场景）。例如，用于通知服务问题的openfire、用于身份验证问题的领域日志以及用于API问题的tomcatlogs。

注意：建议通过安全外壳(SSH)和安全文件传输协议(SFTP)收集Cisco Finesse服务器日志。此方法不仅允许您收集Web服务日志，还允许您收集其他所有日志，如Fippa、openfire、领域和Clientlogs。

选项 2：通过SSH和安全文件传输协议(SFTP) — 推荐选项

使用SSH登录Finesse服务器。
输入此命令以收集所需的日志。命令将收集2小时的日志。系统将提示您标识日志上传到的SFTP服务器。
file get activelog desktop recurs compress reltime hours 2
这些日志存储在SFTP服务器路径上：<IP地址>\<日期时间戳>\active_nnn.tgz ，其中nnn是长格式的时间戳。
要收集其他日志（如tomcat、情景服务、服务和安装日志），请查看Cisco Finesse管理指南12.5(1)版的“日志收集”部分。

设置跟踪并收集CVP和CVVB日志

CVP呼叫服务器

CVP CallServer默认跟踪级别足以对大多数情况进行故障排除。但是，如果您需要获得有关会话发起协议(SIP)消息的更多详细信息，则需要将SIP字符串跟踪设置为DEBUG级别。
导航至CVP CallServer Diag网页URL Local Host 8000。

注意：此页提供有关CVP CallServer的良好信息，对特定场景进行故障排除非常有用。
从Serv中选择com.dynamicsoft.DsLibs.DsUALibs。Mgr位于左上角的下拉菜单。
单击Set按钮。
在跟踪窗口中向下滚动，以确保已正确设置跟踪级别。这些是您的调试设置。
重现问题时，请从C:\Cisco\CVP\logs收集日志，并根据问题发生的时间选择CVP日志文件。
$Collected CVP Log Files at Location C:\Cisco\CVP\logs$

7.重现问题后，请确保将跟踪恢复到默认级别。从Serv中选择com.dynamicsoft.DsLibs.DsUALibs。Mgr下拉菜单，并将其设置为错误。

Image of Files

CVP语音XML(VXML)应用

在极少数情况下，您需要增加VXML服务器应用程序的跟踪级别。另一方面，除非思科工程师提出请求，否则不建议增加此数量。

要收集VXML服务器应用日志，请导航到VXML服务器下的特定应用目录，例如：C:\Cisco\CVP\VXMLServer\applications\{应用程序名称}\logs\ActivityLog\并收集活动日志。

$Example Activity Logs at C:\Cisco\CVP\VXMLServer\Applications\{name of Application}\logs\ActivityLog\$

CVP运营和管理管理门户(OAMP)

在大多数情况下，OAMP和ORM的默认跟踪级别足以确定问题的根本原因。但是，如果需要增加跟踪级别，请按照以下步骤执行此操作：

备份%CVP_HOME%\conf\oamp.properties。

编辑%CVP_HOME%\conf\oamp.properties。

omgr.traceMask=-1
omgr.logLevel=DEBUG
org.hibernate.logLevel=DEBUG
org.apache.logLevel=ERROR
net.sf.ehcache.logLevel=ERROR

修改后，重新启动OPSConsoleServer，如下所示。

跟踪级别信息

跟踪级别	描述	日志级别	跟踪掩码
0	产品安装默认值。预期不会对性能造成影响或影响很小。	信息	无
1	更详细的跟踪消息，对性能的影响较小。	调试	DEVICE_CONFIGURATION + DATABASE_MODIFY + MANAGEMENT=0x01011000
2	详细的跟踪消息对性能的影响不大。	调试	DEVICE_CONFIGURATION + SYSLVL_CONFIGURATION + DATABASE_MODIFY + MANAGEMENT=0x05011000
3	对性能有影响的详细跟踪消息。	调试	DEVICE_CONFIGURATION + SYSLVL_CONFIGURATION + BULK_OPERATIONS + DATABASE_MODIFY + MANAGEMENT=0x05111000
4	详细的跟踪消息，对性能有非常大的影响。	调试	杂项+ DEVICE_CONFIGURATION + ST_CONFIGURATION + SYSLVL_CONFIGURATION + BULK_OPERATIONS + BULK_EXCEPTION_STACKTRACE + DATABASE_MODIFY + DATABASE_SELECT + DATABASE_PO_INFO + 管理+ 跟踪方法+ TRACE_PARAM=0x17371000
5	最高详细跟踪消息。	调试	杂项+ DEVICE_CONFIGURATION + ST_CONFIGURATION + SYSLVL_CONFIGURATION + BULK_OPERATIONS + BULK_EXCEPTION_STACKTRACE + DATABASE_MODIFY + DATABASE_SELECT + DATABASE_PO_INFO + 管理+ 跟踪方法+ TRACE_PARAM=0x17371006

思科虚拟化语音浏览器(CVVB)

在CVVB中，跟踪文件是记录来自Cisco VVB组件子系统和步骤的活动的日志文件。

Cisco VVB有两个主要组件：

称为MADM日志的Cisco VVB管理跟踪
称为MIVR日志的思科VVB引擎跟踪

您可以指定要为其收集信息的组件以及要收集的信息级别。

日志级别扩展自：

调试 — 基本流详细信息到
XDebugging 5 — 堆栈跟踪的详细级别

Cisco VVB Trace Configuration View

警告：不能在生产加载的系统上启用Xdebugging5。

您需要收集的最常见日志是引擎。CVVB引擎跟踪的默认跟踪级别足以解决大多数问题。但是，如果您需要更改特定方案的跟踪级别，Cisco建议您使用预定义系统日志配置文件。

系统日志配置文件

名称	必须激活此配置文件的方案
默认VVB	已启用通用日志。
AppAdminVVB	有关通过AppAdmin、Cisco VVB Serviceability和其他网页进行网络管理的问题。
MediaVVB	有关介质设置或介质传输的问题。
语音浏览器VVB	有关呼叫处理的问题。
MRCPVVB	有关ASR/TTS与Cisco VVB交互的问题。
CallControlVVB	有关SIP信号的问题，将在日志中发布。

选项 1：通过管理帐户

打开CVVB主页UCCX Service Main，然后导航到Cisco VVB Serviceability页。使用管理帐户登录。
选择跟踪>配置文件。
选中要为特定方案启用的配置文件，然后单击Enable按钮。例如，启用SIP相关问题的配置文件CallControlVVB，或启用MRCPVVB，以解决与自动语音识别和文本到语音转换(ASR/TTS)交互相关的问题。
单击enable按钮后，您会看到成功消息。
重现问题后，收集日志。使用CVVB附带的实时监控工具(RTMT)收集日志。
单击桌面上的Cisco Unified Real-Time Monitoring Tool图标（如果需要，请从CVVB下载此工具）。
提供VVB的IP地址，然后单击OK。
接受Certificate信息（如果显示）
提供凭证并单击OK。
如果收到TimeZone错误，单击Yes按钮后，RTMT可以关闭。重新启动RTMT工具。
保持选中Default配置，然后单击OK。

.
选择Trace & Log Central，然后双击Collect Files。
在新打开的窗口中，选择Engine，然后单击Next。
在下一个窗口中再次单击Next。
选择Relative Range并确保选择time以覆盖错误呼叫的时间。
在下载文件选项上，单击浏览并选择要保存文件的目录，然后单击打开。
选择所有选项后，单击Finish按钮。
这将收集日志文件。请等待，直到您在RTMT上看到确认消息。
导航到保存跟踪的文件夹。
引擎日志满足您的需求。要找到它们，请导航到\<时间戳>\uccx\log\MIVR文件夹。

选项 2：通过SSH和SFTP — 推荐选项

使用安全外壳(SSH)登录VVB服务器。
输入此命令以收集所需的日志。系统会压缩日志，并提示您确定日志上传到的SFTP服务器。 file get activelog /uccx/log/MIVR/*
这些日志存储在SFTP服务器路径上：<IP地址>\<日期时间戳>\active_nnn.tgz，其中nnn是长格式的时间戳。

为CUBE和CUSP设置跟踪和收集日志

CUBE(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

警告：生产Cisco IOS®软件GW的任何更改都可能导致中断。

这是一个非常强大的平台，可以在提供的呼叫量处理建议的调试，而不会出现问题。但是，思科建议您：
- 将所有日志发送到系统日志服务器而不是日志记录缓冲区。
```
logging <syslog server ip>
logging trap debugs
```
- 逐个应用debug命令，并在每条命令之后检查CPU利用率。
```
show proc cpu hist
```
警告： 如果CPU利用率达到70-80%，性能相关服务影响的风险将大大增加。因此，如果GW达到60%，请勿启用其他调试。

启用以下调试：

debug voip ccapi inout
debug ccsip mess
After you make the call and simulate the issue, stop the debugging:

重现问题。
禁用跟踪。
```
#undebug all
```
收集日志。

term len 0
show ver
show run
show log

CUSP

在CUSP上启用SIP跟踪。

(cusp)> config
(cusp-config)> sip logging
(cusp)> trace enable
(cusp)> trace level debug component sip-wire

重现问题。
完成后，请关闭日志记录。

收集日志

在CUSP上配置用户（例如，测试）。

在CUSP提示符处添加此配置。

username <userid> create
username <userid> password <password>
username <userid> group pfs-privusers

FTP到CUSP IP地址。使用上一步中定义的用户名（测试）和密码。
将目录更改为/cusp/log/trace。
获取log_<filename>。

设置跟踪和收集UCCE日志

思科建议通过Diagnostic Framework Portico或系统CLI工具设置跟踪级别并收集跟踪。

注意： 有关诊断框架门户和系统CLI的详细信息，请访问Cisco Unified ICM/Contact Center Enterprise版本12.5(1)的《适用性指南》中的诊断工具一章。

排除大多数UCCE场景故障时，如果跟踪的默认级别没有提供足够的信息，请在所需组件中将跟踪级别设置为3（某些例外情况除外）。

注意：有关详细信息，请访问Cisco Unified ICM/Contact Center Enterprise版本12.5(1)的适用性指南上的跟踪级别部分。

例如，如果您对出站拨号程序问题进行故障排除，如果拨号程序繁忙，则跟踪级别必须设置为级别2。

对于CTISVR(CTISVR),2级和3级未设置思科建议的确切注册表级别。CTISVR的推荐跟踪注册表为0XF8。

在UCCE代理PG上，打开注册表编辑器(Regedit)。
导航至HKLM\software\Cisco Systems， Inc\icm\<cust_inst>\CG1(a and b)\EMS\CurrentVersion\library\Processes\ctisvr。
双击EMSTraceMask并将值设置为f8。
单击Ok并关闭Registry Editor。以下是设置任何UCCE组件跟踪的步骤（以RTR过程为例）。

SetTrace级别

从设置跟踪所需的服务器打开Diagnostic Framework Portico，并以Administrator用户身份登录。
在Commands部分中，导航到Trace并选择SetTraceLevel。
在SetTraceLevel窗口中，选择组件和级别。
单击 submit。完成后，您将看到Ok消息。

Diagnostic Framework Portico – Set Trace Levels View Confirmation

警告：尝试重现问题时将跟踪级别设置为级别3。重现问题后，将跟踪级别设置为默认值。在设置JTAPIGW跟踪时应特别小心，因为级别2和级别3设置了低级别跟踪，这可能会影响性能。在JTAPIGW的非生产时间或实验室环境中设置2级或3级。

日志收集

从Diagnostic Framework Portico的Commands部分，导航到Trace，然后选择ListTraceFile。
在ListTraceFile窗口中，选择Component、FromDate和ToDate。选中Show URL框，然后单击Submit。
请求完成后，您会看到OK消息和ZIP日志文件的链接。
单击ZIP文件链接并保存位于您选择的位置中的文件。

设置跟踪和收集PCCE日志

PCCE拥有自己的工具来设置跟踪级别。它不适用于UCCE环境，其中诊断框架Portico或系统CLI是启用和收集日志的首选方法。

从PCCE AW服务器，打开Unified CCE Web Administration工具，并登录到Administrator帐户。
导航到概述>基础设施设置>日志收集，以打开“日志收集”页。
在“日志收集”(Log Collection)页面上，单击跟踪级别，打开“跟踪级别”(Trace Levels)对话框。
在CCE上将Trace Level设置为Detailed，并保留为No Change（对于CM和CVP），然后点击Update Trace Levels。
单击Yes确认警告。
重现问题后，打开Unified CCE Administration并导航回System > Log Collection。
在Components窗格中选择CCE和CVP。
选择适当的Log Collection Time（默认值为last 30 min）。
单击Collect Logs，然后单击Yes打开对话框警告。日志收集开始。等待几分钟，直到它完成。
完成后，单击Actions列中的Download按钮可下载包含所有日志的压缩文件。将zip文件保存到您认为适当的任意位置。

设置跟踪和收集CUIC/实时数据/IDS日志

使用SSH下载日志

登录CUIC、LD和IDS的SSH命令行(CLI)。
运行命令以收集CUIC相关日志。

file get activelog /cuic/logs/cuic/*.* recurs compress reltime hours 1
file get activelog /cuic/logs/cuicsrvr/*.* recurs compress reltime hours 1
file get activelog tomcat/logs/*.* recurs compress
运行命令以收集LD相关日志。

file get activelog livedata/logs/*.*
运行命令以收集Id相关日志。

file get activelog ids/log/*.* recurs compress reltime days 1
这些日志存储在SFTP服务器路径上：<IP地址>\<日期时间戳>\active_nnn.tgz ，其中nnn是长格式的时间戳。

使用RTMT下载日志

从OAMP页面下载RTMT。登录https://<HOST ADDRESS>/oamp，其中HOST ADDRESS是服务器的IP地址。
导航到工具> RTMT插件下载。下载并安装插件。
启动RTMT，然后使用管理员凭据登录服务器。
双击Trace and Log Central，然后双击Collect Files。
您可以看到特定服务的这些选项卡。您必须为CUIC、LD和IDS选择所有服务/服务器。

对于CUIC:

对于LD:

对于IDS:

对于Platform服务，选择Tomcat和Event viewer日志通常是一个好主意：
选择Date和Time以及destination文件夹以保存日志。

VoS上的数据包捕获(Finesse、CUIC、VVB)

开始捕获
要开始捕获，请建立到VOS服务器的SSH会话，并使用平台管理员帐户进行身份验证。

Start the Capture with SSH Session to the VOS Server

1a。命令语法

命令为utils network capture且语法如下：

Syntax:
utils network capture [options]
options  optional   
page,numeric,file fname,count num,size bytes,src addr,dest addr,port
num,host protocol addr
options are:
page                
- pause output
numeric               - show hosts as dotted IP
addresses
file fname            - output the information to a file
  
Note: The file is saved in platform/cli/fname.cap
         
fname should not contain the "." character
count num             - a
count of the number of packets to capture
    Note: The maximum count
for the screen is 1000, for a file is 100000
size bytes            -
the number of bytes of the packet to capture
    Note: The maximum
number of bytes for the screen is 128
          For a file it can be
any number or ALL
src addr              - the source address of the
packet as a host name or IPV4 address
dest addr             - the
destination address of the packet as a host name or IPV4 address
port
num              - the port number of the packet (either src or dest)
host
protocol addr    - the protocol should be one of the following:
ip/arp/rarp/all. The host address of the packet as a host name or IPV4
address. This option  will display all packets to and from that address.
  
Note: If "host" is provided, do not provide "src" or "dest"

1b。捕获所有流量

对于典型的捕获，可以将所有大小的ALL地址之间的所有数据包收集到一个名为packets.cap的捕获文件中。为此，只需在管理CLI上执行 utils network capture eth0 file packets count 100000 size all

1c。根据端口号捕获

为了排除与集群管理器的通信问题，需要使用端口选项根据特定端口(8500)进行捕获。

有关哪些服务需要在每个端口上进行通信的详细信息，请参阅TCP和UDP端口使用指南，了解相应组件的适用版本。

1d。根据主机捕获

要排除VOS和特定主机的故障，可能需要使用“host”选项过滤进出特定主机的流量。

可能还需要排除特定主机，在本例中应使用“！” 在IP地址前面。例如 utils network capture eth0 file packets count 100000 size all host ip !10.1.1.1

重现问题症状
捕获过程已开始重现问题症状或状况，以便将必要的数据包包含在捕获过程中。如果故障间歇性出现，则可能需要长时间运行捕获。如果捕获结束，这是因为缓冲区已满。重新启动捕获并自动重命名之前的捕获，这样之前的捕获不会丢失。如果长时间需要捕获，请使用交换机上的监控会话在网络级别捕获。
停止捕获
要停止捕获，请按住Control键并按键盘上的C。这会导致捕获进程结束，并且不会向捕获转储中添加任何新数据包。
完成后，捕获文件将存储在服务器上“activelog platform/cli/”位置
从服务器收集捕获
捕获文件存储在服务器上的activelog platform/cli/位置。您可以使用RTMT通过CLI将文件传输到SFTP服务器或本地PC。
4a。通过CLI将捕获文件传输到SFTP服务器
使用命file get activelog platform/cli/packets.cap令将packets.cap文件收集到SFTP服务器。
或者，收集服务器上存储的所有.cap文件，使用file get activelog platform/cli/*.cap。
最后，填写SFTP服务器IP/FQDN、端口、用户名、密码和目录信息：

CLI指示文件传输到SFTP服务器是成功还是失败。

4b。使用RTMT将捕获文件传输到本地PC。
启动 RTMT。如果未安装在本地PC上，请从VOS管理页面安装适当的版本，然后导航到应用>插件菜单。单击System，然后单击Trace & Log Central，然后双击Collect Files。单击第一个菜单中的Next。

Use RTMT to Transfer a Capture File to a Local PC