配置跟踪和收集UCCE日志

简介

本文档介绍如何在Cisco UCCE、Finesse、客户语音门户(CVP)、UCCE Outbound Dialer和Cisco网关中设置跟踪。

先决条件

要求

建议掌握下列主题的相关知识：

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

使用的组件

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

• 思科Finesse 11.5
• CVP服务器11.5
• 统一联络中心企业版(UCCE)11.5
• 思科虚拟化语音浏览器11.5

本文档介绍如何在Cisco Unified Contact Center Enterprise(UCCE)、Cisco Finesse、Cisco Customer Voice Portal(CVP)、Cisco UCCE Outbound Dialer和Cisco网关中设置跟踪。

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

跟踪设置和日志收集Finesse

Finesse客户端

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

选项1：使用发送错误报告收集客户端日志。

步骤1:登录代理。

第二步：如果座席在呼叫或媒体事件中遇到任何问题，请指示座席单击finesse桌面右下角的“发送错误报告”链接。

第三步：代理看到“Logs Successfully Sent！（已成功发送日志！）”消息。

第四步：客户端日志将发送到Finesse服务器。导航到https://x.x.x.x/finesse/logs并使用管理帐户登录。

第五步：  收集clientlogs/目录下的日志。

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

步骤1:导航至 https://x.x.x.x:8445/desktop/locallog。

第二步：点击Sign In With Persistent Logging。

     

         

 第三步：系统将打开Cisco Finesse座席桌面登录页面。登录座席。

      

第四步：所有Agent Desktop交互都会被注册并发送到本地存储日志。要收集日志，请导航至https://x.x.x.x:8445/desktop/locallog，并将内容复制到文本文件中。保存文件以供进一步分析。

.     

 注意：存在与持续日志记录相关的警告。启用永久日志记录后，信息不会发送到本地存储日志。Cisco Bug ID CSCvf93030 — 永久日志记录无法捕获日志。Finesse 11.5(1)ES-2向前发展。  有关此注意事项和解决步骤的详细信息，请访问

选项3:Web浏览器控制台

步骤1:代理登录后，按F12打开浏览器控制台。

第二步：选择Console选项卡。

步骤3.检查浏览器控制台中的错误。将内容复制到文本文件中并保存。

第四步：选择Network选项卡，然后选中Preserve log选项。

第五步：右键单击任何网络名称事件，然后选择Save as HAR with content。

 

Finesse服务器

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

步骤1:导航到https://x.x.x.x/finesse/logs并使用管理帐户登录。

第二步：展开目录Web服务/

第三步：收集上一个Web服务日志。选择最后一个解压缩文件。例如，Desktop-Webservices.201X-..log.zip。点击文件链接，您会看到用于保存文件的选项。

第四步：收集其他所需的日志（取决于场景）。例如，用于通知服务问题的openfire、用于身份验证问题的领域日志以及用于API问题的tomcatlogs。

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

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

步骤1:  使用安全外壳(SSH)登录到Finesse服务器。

第二步：输入此命令以收集所需的日志。日志经过压缩，相对时间为2小时。系统将提示您标识日志上传到的SFTP服务器。

file get activelog desktop recurs compress reltime hours 2.

第三步：这些日志存储在SFTP服务器路径上：<IP地址>\<日期时间戳>\active_nnn.tgz ，其中nnn是长格式的时间戳。 

第四步：要收集其他日志（如tomcat、情景服务、服务和安装日志），请查看《Cisco Finesse管理指南》的“日志收集”部分

思科Finesse管理指南版本11.5(1)

注意：有关用于Finesse传输文件的SFTP的详细信息，请访问本文档使用SFTP的Finesse备份和升级配置

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

 

CVP呼叫服务器

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

步骤1:导航至CVP CallServer Diag网页URL http://cvp.cc.lab:8000/cvp/diag。

 注意：此页面提供有关CVP CallServer的良好信息，对特定场景进行故障排除非常有用。

  

第二步：从服务器中选择com.dynamicsoft.DsLibs.DsUALibs。位于左上角的Mgr下拉菜单

第三步：点击Set按钮。

第四步：  在跟踪窗口中向下滚动，以确保已正确设置跟踪级别。这些是您的调试设置。

第五步：重现问题时，请从C:\Cisco\CVP\logs收集日志，并根据问题出现的时间选择CVP日志文件。

CVP语音XML(VXML)应用

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

要收集VXML服务器应用程序日志，请导航到VXML服务器下方的具体应用程序目录，例如：C:\Cisco\CVP\VXMLServer\applications\{name of application}\logs\ActivityLog\，并收集活动日志

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

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

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

Cisco VVB有两个主要组件：

•   称为MADM日志的Cisco VVB“管理”跟踪
•   称为MIVR日志的Cisco VVB“引擎”跟踪

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

日志级别扩展自：

  调试 — 基本流详细信息到

  XDebugging 5 — 堆栈跟踪的详细级别

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

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

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

步骤1:打开CVVB主页(https://X.X.X.X/uccxservice/main.htm)，导航到Cisco VVB Serviceability页面并使用管理帐户登录

第二步：  选择Trace -> Profile

第三步：选中要为特定方案启用的配置文件，然后点击Enable按钮。例如，启用SIP相关问题的配置文件CallControlVVB，或启用MRCPVVB，以解决与自动语音识别和文本到语音转换(ASR/TTS)交互相关的问题。

点击enable按钮后，您会看到成功消息。

第四步：  报告问题后，收集日志。使用CVVB附带的实时Monotor工具(RTMT)收集日志。

第五步：点击桌面上的Cisco Unified Real-Time Monitoring Tool图标（如果已从CVVB下载此工具）

第六步：提供VVB的IP地址，然后点击OK。

步骤 7.接受证书信息（如果显示）。

步骤 8提供凭证，然后点击OK。

步骤 9如果收到TimeZone mismatch Warning（时区不匹配警告），请单击YES（是）并继续。

步骤 10如果收到TimeZone错误，单击Yes（是）按钮后RTMT可能会关闭。请重新启动RTMT工具。

步骤 11保持选中“Default configuration（默认配置）” ，然后单击“OK（确定）”

步骤 12选择Trace & Log Central，然后双击Collect Files

步骤 13在新打开的窗口中，选择引擎，然后单击“下一步”

步骤 14在下一个窗口中再次单击“下一步”

步骤 15选择“相对范围”，确保您选择时间以覆盖错误呼叫的时间

步骤 16在“下载文件选项”上，单击“浏览”，然后选择要保存文件的目录，然后单击“打开”

步骤 14选择所有选项后，点击“完成”按钮

步骤 15这将收集日志文件。等待，直到您看到RTMT上的确认消息

步骤 16导航到保存跟踪的文件夹。

步骤 17引擎日志是所需的全部日志。要找到它们，请导航到\<time stamp>\uccx\log\MIVR文件夹。

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

CUBE(SIP)

步骤1:设置日志时间戳并启用日志记录缓冲区

#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)> 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组件跟踪（RTR过程示例）的步骤。

步骤1:从需要设置跟踪的服务器上打开诊断框架门户。与管理员用户登录。

第二步：在Commands部分中，导航到Trace并选择SetTraceLevel。

 

跟踪设置和日志收集PCCE

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

步骤1:从PCCE AW服务器，打开Unified CCE Web Administration（Unified CCE Web管理）工具，并使用管理员帐户登录。

第二步：导航到System -> Log Collection。

第三步：系统将打开“日志收集”(Log Collection)页面。

第四步：点击，Trace Levels，将加载弹出对话框

第五步：在CCE上将Trace Level设置为Detailed，将其保留为No Change for CM， CVP。并点击Update Trace Levels

第六步：点击Yes确认警告。

 

步骤 7.重现问题后，打开Unified CCE Administration（Unified CCE管理），然后导航回System（系统） — > Log Collection（日志收集）。

步骤 8在Components（组件）窗格中选择CCE和CVP。

步骤 9选择适当的日志收集时间（默认值为30分钟）。

---

 注意：刷新结束时间的页面以使用当前时间进行更新

步骤 10点击Collect Logs（收集日志），然后点击对话框警告的Yes（是）。日志收集开始。等待几分钟，直到它完成。

步骤 11完成后，点击Actions列中的Download按钮，下载包含所有日志的压缩文件。  将zip文件保存在您认为合适的任何位置。