从GUI和CLI排除Webex Connected UC遥测模块故障

简介

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

先决条件

要求

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

• 思科统一通信管理器(CUCM)的命令行界面(CLI)
• 完成下面概述的流程：为内部设备设置Webex云连接UC。

使用的组件

• Cisco Unified Communications Manager版本12.5.1.14900-63
• Webex Control Hub(https://admin.webex.com)

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

开始使用前 

内部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。

admin:utils ucmgmt agent restart

Stopping agent..


Agent is restarting. Check agent status with 'utils ucmgmt agent status'.
admin:

会触发代理重新启动。

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

等待至少10到15分钟。

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

admin:utils ucmgmt agent status
Agent Config Information:
   Verification Code: XXXXXXXX
   Installed UCMGMT Agent version: 20230323-619
   Agent's organization id: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Agent Runtime Information:
   Agent process is running.
   Agent process is enabled.
   Agent watchdog is enabled.
   Agent is verified in Webex Control Hub.

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

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

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

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

代理

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

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

admin:utils ucmgmt proxy list
    "http://10.0.0.1:9999"
admin:

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

注意是否配置了代理。

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

utils ucmgmt proxy add 
    
     
      
    

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

Proxy_URL对此命令是必需的。

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

遥测模块

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

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

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

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

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

admin:show version active
Active Master Version: 12.5.1.14900-63
Active Version Installed Software Options: 
...
ciscocm-ucmgmt-agent-upgrade.v20230329-620.k4.cop
ciscocm-ucmgmt-ucTelemetry.v1634.k4.cop

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

utils network connectivity gw.telemetry.ucmgmt.cisco.com 443
utils network connectivity telemetry-mgmt.na.ucmgmt.cisco.com 443
utils network connectivity gw.telemetry-eu.ucmgmt.cisco.com 443
utils network connectivity telemetry-mgmt.eu.ucmgmt.cisco.com 443

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

如果它们返回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中的以下任何区域仍然出现问题：

• “分析”>“互联UC”缺少数据，或者收集到的呼叫数据中出现错误
• 故障排除>已连接的UC缺少数据，或所收集呼叫数据中出现错误
• 在遥测模块资产节点中仍显示为脱机

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

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

按“n”直到文件结束。

admin:file view activelog telemetry/TelemetryReport.txt

================================================================================
Cisco Webex Cloud-Connected UC Telemetry Report
================================================================================

All information in this report is to be used for debugging purpose by Cisco.

Report Generated On(GMT)      2023-03-28 11:06:00
Status                        connected
Module Version                1634
Start Time(GMT)               2023-03-28 11:05:07
Org ID                        XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Time Zone                     CST
Cluster Name                  YourClusterName
Node Type                     ccm
Product Version               12.5.1.14900-63
Cluster Id                    XXXXXXXX—XXXX-XXXX-XXXX-XXXXXXXXXXXX
Agent Id                      XXXXXXXX—XXXX-XXXX-XXXX-XXXXXXXXXXXX
Host Name                     YourPublisher
Buffer Allocation             100 MB
Node Id                       AAAABBBBCCCC
Proxy                         

--------------------------------------------------------------------------------
Telemetry Checks (2023-03-27 23:54:48 GMT)
--------------------------------------------------------------------------------
Result                        Test
------                        ----
Pass                          JTelemetry module is running
Pass                          Cluster upgrade not in progess
Fail                          CMR is enabled
    - CMR collection is off
Pass                          CDR is enabled
Pass                          CDR file transfer
Fail                          Zero call duration enabled
    - Zero duration call is disabled
Pass                          Check high CDR duration
Pass                          Websocket-broker is running
--------------------------------------------------------------------------------
Websocket-broker Status (2023-03-28 19:56:49 GMT)
--------------------------------------------------------------------------------

Connection Status             connected
Start Time(GMT)               2023-03-28 11:02:43
Connected Time(GMT)           2023-03-28 11:04:48
Disconnected Time(GMT)        2023-03-28 11:02:43
Connected Duration(s)         31921
DisconnectedDuration(s)       125
ConnectedCount                1
DisconnectedCount             0

--------------------------------------------------------------------------------
CCUC Service Information (2023-03-28 19:57:00 GMT)
--------------------------------------------------------------------------------

Analytics                     Enabled
Deployment Insights           Enabled
Deployment Insights Limited   Disabled
Certificate Management        Enabled
Operation Metrics             Enabled
Borderless CTI                Disabled
Presence Status Sync          Disabled
Centralised Call History      Disabled
Collect Privacy Data          Enabled

--------------------------------------------------------------------------------

end of the file reached

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

在第一部分：

• 生成报告的日期和时间。如果日期为过去的天数，而不是过去的小时数，则表示遥测模块已停止运行。
• 状态需要“已连接”。否则，这表示存在连接问题。

在遥测检查部分：

• 任何失败的测试都可能表明您的节点配置不正确。

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

在WebSocket-broker Status部分中：

• Connection Status需要“connected”。 否则，这表示存在连接或代理问题。
• DisconnectedCount字段中的大数字也可能表示连接或代理问题。

在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