本文档介绍如何从Webex Control Hub和CUCM CLI对CCUC遥测模块进行故障排除。

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

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

内部CUCM包括预安装在12.5.1 SU4或更高版本中的云连接UC代理。

早期版本需要手动安装代理。在Webex Control Hub中浏览到代理安装文件页。

在左侧查找Services，然后单击Connected UC。

在UC Management窗格中单击Agent Install Files。

遥测模块是Connected UC UCMGMT Agent的一部分。

遥测模块将数据从本地CUCM、CER、CUPS或CUC节点上传到Webex Control Hub。

上传的数据包括CUCM节点的运行指标、用于分析的CDR和CMR记录等。

要在Control Hub中接收最大数量的数据，请确保在集群组的服务管理窗口中启用Analytics和Operational Metrics。

但是，在已连接的UC中验证UCMGMT代理之前，未在任何节点上安装遥测模块。

在Webex Control Hub中，在左侧找到Services，然后单击Connected UC。

在UC Management窗格中，单击Inventory。

此处定义了Cluster Groups并验证节点。

验证后，代理会收到来自Webex Control Hub的作业请求，以便在已验证的节点上安装遥测模块。

代理最多需要1.5小时才能完成安装。 

安装后，遥测模块成功安装到的每个节点上的Connected UC Inventory中会显示信息通知。

单击各个节点查看该节点的所有通知。

浏览到遥测模块清单。

在Webex Control Hub中，在左侧找到Services，然后单击Connected UC。

在UC Management窗格中，点击遥测模块资产。

如果没有连接问题，则节点状态为联机。

遥测模块可能出现问题，例如：

例如：在Webex Control Hub中，在左侧菜单中找到Monitoring。

如果选择Analytics或Troubleshooting，遥测模块会填充Connected UC的数据部分。

出现问题时，这些部分可能会有不完整的数据、无数据或错误消息出现在收集的数据中。

请注意，在 互联统一通信>遥测模块资产 即使UC管理资产中的节点报告为“联机”，节点也可以报告“脱机”。

这表示遥测模块存在问题。

要开始进行故障排除，请单击遥测模块资产中的节点，并注意右侧显示的面板上的信息。

Agent Status和Telemetry Module Status都必须报告为Online。

记录代理和遥测模块的上次连接时间。

如果这两个字段不在当前时间的几分钟内，这可能表示存在连接问题或已发生故障的服务。

在面板信息中检查代理版本。

前八位是此版本的发布日期。

日期是否超过4-6个月？如果是，则代理很可能没有按计划自动更新自身和遥测模块。 

要尝试更新代理版本，请尝试两种方法。

1.连接到节点的CLI并运行以下命令：utils ucmgmt agent restart。

会触发代理重新启动。

每当代理启动时，它始终会尝试更新自身和遥测模块。

等待至少10到15分钟。

然后，使用以下命令检查安装的版本：utils ucmgmt agent status。

注意该命令输出中的“Installed UCMGMT Agent version”。

检查版本号是否已更新到最近的日期。

2.从Connected UC中的Agent Install Files页面下载新的Agent Install COP文件。

在代理版本过期的所有节点上安装该COP文件。

您的环境中可能需要网络代理或Web代理才能连接到Web服务。

如果是，请确保为代理配置了代理。

在命令的输出中：utils ucmgmt proxy list

注意是否配置了代理。

如果未配置，请使用命令：

将替换为环境中代理的URL。

Proxy_URL对此命令是必需的。

如果您的代理需要身份验证，请输入用户名。系统提示您输入身份验证密码。否则，用户名是可选的。

注意：服务可以位于您的节点上(当您运行命令：utils service list时)，包括单词“Telemetry”。如果是，则不要操作此服务。该遥测服务与云互联UC遥测无关。CCUC遥测模块不可见于可维护性GUI或从CLI可见的服务列表中。

首先，从CLI检查遥测模块是否已安装以及版本号。

在节点的CLI中，输入以下命令：show version active

在命令输出中，如果显示带有ciscocm-ucmgmt-ucTelemetry的行，则安装遥测模块。

如果显示包含ciscocm-ucmgmt-agent的行，则会安装代理。

代理和遥测模块的版本号也在该命令的输出中可见。

接下来检查连通性。从节点的CLI运行以下命令：

其中每个命令的输出都需要以“服务可访问”结尾。 

如果它们返回Connection timed out或“Connection refused”，则存在必须内部网络或安全团队解决的连接问题。

WebSockets是正常的CCUC功能所必需的。

Web代理、URL过滤器和防火墙可以阻止WebSockets流量。

WebSockets通过TCP通过端口443进行通信，例如SSL/TLS、h但是，WebSockets的URL是以不同方式编写的。

TLS URL如下所示：https://domain.test 

WebSockets URL如下所示：wss://domain.test

确保WebSockets流量可以在节点和Webex云之间流动。

下一步是尝试暂停CCUC服务。

在遥测模块清单中单击您的节点，然后在右侧显示的面板中单击暂停CCUC服务按钮。 

等待至少2到3分钟，以完成“暂停”操作。节点状态从“Stopping”更改为“Stopped By User”。

现在单击您的节点，然后单击Resume CCUC Services按钮。节点状态从“Starting”（开始）更改为“Online”（联机）。

暂停和恢复过程可以修复一些遥测模块问题。

如果Control Hub中的以下任何区域仍然出现问题：

然后从CLI检查TelemetryReport.txt文件。

从节点的CLI运行此命令：file view activelog telemetry/TelemetryReport.txt

按“n”直到文件结束。

检查此文件的内容。验证此信息：

在第一部分：

在遥测检查部分：

请参阅本文的其他信息部分中链接的设置和故障排除文档，以更正节点配置。

在WebSocket-broker Status部分中：

在CCUC Service Information部分：

启用和禁用服务与您之前在集群组的Service Management窗口中看到的内容匹配。

如果不匹配，则存在连接问题或遥测模块出现故障。

您还可以检查jtelemetry_error.log以查看遥测模块是否记录了任何错误。

要查看此文件，请运行命令：file view activelog telemetry/jtelemetry_error.log

日志文件不容易阅读，但可以找到错误原因的指示。

当这些错误持续存在时，即使节点重启后也如此，请通过TAC创建支持案例。

https://help.webex.com/en-us/article/x8s8vs/Troubleshoot-Webex-Cloud-Connected-UC

https://help.webex.com/en-us/article/nzt6c0b/Set-Up-Webex-Cloud-Connected-UC-for-On-Premises-Devices

https://help.webex.com/en-us/article/fg3qim/Network-Requirements-for-Webex-Cloud-Connected-UC

https://help.webex.com/en-us/article/55mug2/System-Requirements-for-Webex-Cloud-Connected-UC